Category : Word Processors
Archive   : CSMP.ZIP
Filename : SEE.DOC

SEE Users Manual

TABLE OF CONTENTS

SEE Installation . . . . . . . . . . . . . . . . . . . . . . . . . . 1

SEE's Computer Aided Instruction Course. . . . . . . . . . . . . . . 2

Exit, Help, and Print commands . . . . . . . . . . . . . . . . . . . 2

Moving the cursor. . . . . . . . . . . . . . . . . . . . . . . . . . 3

Moving the window. . . . . . . . . . . . . . . . . . . . . . . . . . 4

Control codes and graphics . . . . . . . . . . . . . . . . . . . . . 4

Adding or removing space . . . . . . . . . . . . . . . . . . . . . . 5

Moving or copying text . . . . . . . . . . . . . . . . . . . . . . . 6

Other SEE commands . . . . . . . . . . . . . . . . . . . . . . . . . 7

Search, Replace, and Global Replace. . . . . . . . . . . . . . . . . 8

SEE distribution file list . . . . . . . . . . . . . . . . . . . . . 8

The fully featured version of SEE. . . . . . . . . . . . . . . . . . 9


Program Overview

SEE is a simple text oriented word processor, designed to be easy to
learn and use and compatible with any other program. Basically, SEE
makes your computer work just like a smart typewriter. You don't need
to worry about returns, line feeds, or end-of-files: SEE takes care of
all that for you. When you hit a key on a typewriter, it types. SEE
works exactly like that.

SEE is a modeless editor. This means SEE always behaves the same way.
There are not modes like "command mode", "insert mode", etc. SEE is a
white space editor. This means the TAB and RETURN keys work exactly
like they do on a typewriter: they move the "print head" and the
"paper", but they don't change your document.

To edit a file with SEE, type "SEE filename". SEE will create your
file if it doesn't already exist. To edit with SEE, move the cursor
with the arrow keys or mouse and type. To save your file and exit,
hold down the CTRL key and hit Z (or select menu choice
System-Save,Exit).

Copyright notice and distribution policy

The program SEE and this manual are copyrighted (C) 1986 by Mark
Lawrence, all rights reserved. This version of SEE and this manual may
be freely copied and distributed providing that the copies are exact
duplicates with no modifications, the program and this manual are
always distributed together, no charge is made for the duplication or
distribution, and all copyright notices are included in all copies.

California Scientific Software
160 East Montecito #E, Sierra Madre, CA 91024 818/355-1094
SEE Installation Page 1

First, print yourself a copy of the SEE manual:

arcx see
print see.doc

Want to run SEE on a hard disk or RAM disk?
a: Create a directory for SEE to live in (we recommend C:\DOS).
b: Copy SEE.* into the chosen directory.
c: Place these lines in your Autoexec.Bat and boot:

path C:\DOS;C:\
set cssdir=C:\DOS

replace C:\DOS with the pathspec of whatever directory you chose. The
pathspec must be 18 characters or less, total. Autoexec.bat is
described fully in your DOS manual. Be sure to follow all of the
installation instructions that came with your mouse.

SEE's limits

SEE effectively edits very large pieces of paper which have your files
typed onto the upper left corners. Each piece of paper is 32,000
characters wide and 32,000 lines long; that is, lines in SEE may
contain up to 32,000 characters, and documents may contain up to 32,000
lines. The entire document must fit into memory. The operating system
typically takes about 50K bytes, and SEE takes about 30K bytes. In
addition to this, SEE files consume about 25% more memory than disk
space; thus, if you have a 256K machine, the largest file you can edit
is about (256K - 80K) x .75 bytes, which is about 130K bytes. If you
have 640K of memory, your maximum file size will be about 380K bytes.

SEE has limits. These are:
Maximum number of lines in a document:. . . . . . . . . . . . . 32,767
Maximum number of characters in a line: . . . . . . . . . . . . 32,767
Maximum search string:. . . . . . . . . . . . . . . . . . 40 characters
Maximum replace string: . . . . . . . . . . . . . . . . . 40 characters
Maximum filename + pathspec length: . . . . . . . . . . . 40 characters

Menus

Throughout this manual the commands are accessed through the function
keys. You can also access the commands by poping up the menu (hit "*"
on your numeric keypad) and selecting the command you want. You can
move around the menus using your mouse or arrow keys. To select a menu
item, hit ENTER, or keypad "*", or the left mouse button. To get out
of the menus without selecting, hit Escape.

Some menu items cannot be selected in this version of SEE. These menu
items are part of the fully featured version of SEE, which is described
on page 9 of this document.

When the functions are described, the menu choices will be listed
afterword in parentheses, with the menu header listed first, followed
by a "-", followed by the menu item. For example: F1 (menu choice
File/Open). For block commands, first mark the file, then hit the
keypad * key to pop up the menus and select the function you desire.

California Scientific Software
160 East Montecito #E, Sierra Madre, CA 91024 818/355-1094
SEE's Computer Aided Instruction Course Page 2

SEE comes supplied with a Computer Aided Instruction (CAI) kit. This
kit consists of 4 lessons; each lesson is about two printed pages long,
and takes about 5 minutes to complete. The recommended way to take the
CAI course is to take the lessons in order, one every few days. You
should use the material from each lesson for a day or two, or until you
are comfortable with it, before proceeding to the next lesson. Many
users find that the first two lessons cover all they need to know for
quite a while.

There is a tendency for new users to rush ahead into the course too
quickly. Having just finished a 5 minute course, it is better to
practice the newly learned material for a while than to immediately
dilute it with new information.

To start the course, boot your machine, follow the installation
instructions above (if you haven't already), and type:

see Lesson1


Exit, Help and Print commands
EXIT (CTRL Z): System/Save,Exit
Exit causes SEE to exit. If you have modified your file, it will be
saved to disk. Exit takes two optional arguments: ESC a Exit (menu
choice System-Quit), will cause SEE to exit without saving the file;
ESC b Exit will save the file, keeping the original disk copy as a
backup. It is possible that there is not enough room on your disk to
save your file. In this case, SEE gives you one of its two error
messages: "Disk is full - unable to save". You should place another
formatted floppy in your disk drive and try again.

SAVE FILE (ALT F9): File/Save
Save File saves your file to disk and continues editing.

HELP (CTRL F6): System-Help
Help displays the file SEE.HLP on the screen, pauses for one user
interaction, and then returns to normal editing. The user interaction
is ignored. You may edit and change the file SEE.HLP to suit yourself,
but this is not recommended. This command displays a picture of the
keypad with a few words describing each function key. Most function
keys have two functions attached. Hitting the function key alone calls
the first function listed, and CTRL-key calls the second function.

PRINT (CTRL F9): File-Print
Print prints files. When you hit Print, all the lines from the current
line to the end of the file get printed.

Print accepts cursor arguments. The width of rectangles is ignored;
the top and bottom line of the rectangle specify the lines to print.
If you give Print a text argument (e.g. ESC foo Print), Print will
print to that file instead of the printer. To use the menu Print,
first select text or type ECS foo, then pop up the menu and pick Print.

California Scientific Software
160 East Montecito #E, Sierra Madre, CA 91024 818/355-1094
Moving the cursor Page 3

SEE moves the window as necessary to make the active text visible. If
in the course of editing you attempt to move off the screen, for
example, by typing a long line or by moving the cursor to the far
right, SEE will move the window to the right in order to make what you
are doing visible. Hitting Enter (or typing a space when AutoReturn is
enabled) will restore the screen to the normal position.

Arrow Keys or Mouse:
These keys move the cursor in the direction they point. When you get
to the top or left edge of the file, they stick. Holding CTRL down
while using the left or right arrow keys moves the cursor 8 spaces
instead of one. SEE supports the MicroSoft Mouse and compatibles.

ENTER or RETURN or CTRL M:
This key moves the cursor to the beginning of the next line, exactly as
a typewriter would. It does not insert a carriage return into your
file. The window will unshift if it was shifted.

TAB or CTRL I:
This key moves the cursor right to the next tab stop; initially, tab
stops are every four columns. If Auto-Return is ON, SEE moves the left
margin to the cursor position.

SHIFT-TAB or CTRL U:
This key moves the cursor left to the previous tab stop; initially, tab
stops are every four columns. If Auto-Return is ON, SEE moves the left
margin to the cursor position.

CTRL TAB or ALT T: Options-Tab Stops
These keys set and reset tab stops. Tab stops may be set out to column
128; after that, the default of every four spaces takes over.

HOME: Display-Start of Line
This key moves the cursor to the beginning of the current line. If you
are already at the start of the line, it moves you to the upper left
corner of the window. CTRL HOME (menu choice Display-Start of File)
moves you to the start of the first line in the file.

END: Display-End of Line
This key moves the cursor to the end of the current line. If the
cursor is already on the end of the line, END moves you to the end of
the last line on the screen. CTRL END (menu choice Display-End of
File) moves you to the last line in the file.

BACKSPACE:
This key moves the cursor 1 place to the left. When in insert mode, it
also deletes whatever character is there.

CTRL Q or Mouse Left Button: File-Mark File
This command causes SEE to remember where you are for later use. The
place where you are when you hit this command is the active selection.
If you select a place and later change your mind about where the
selection should be, just move there and hit this again.

California Scientific Software
160 East Montecito #E, Sierra Madre, CA 91024 818/355-1094
Moving the window Page 4

CTRL HOME: Display-Start of File
This key moves to the start of the first line in the file.

CTRL END: Display-End of File
This key moves to the last line of the file.

MOVE (F9 or Mouse Right Button): Display-Scroll Anywhere
Move moves the display around. Move does not affect the contents of
your file; it only changes which portion of the file gets displayed.
If you hit Move with no active selection, the line you are currently on
will move to the top of the window. If there is an active selection,
Move will move the window so that the character you selected will be
placed where the cursor is now. You can give Move an integer argument:
Move will make that line number visible. For example, if you enter:

132

Move will attempt to make line number 132 visible.

PG UP or CTRL B: Display-Back 1 Page
This key moves the window up so that the line which was at the top of
the screen is now at the bottom of the screen. This key used with CTRL
pressed has the same result as hitting the key four times: CTRL PG UP
(menu choice Display-Back 4 Pages) moves four pages up.

PG DN or CTRL F: Display-Forward 1 Page
This key moves the window down so that the line which was at the bottom
of the screen is now at the top of the screen. This key used with CTRL
pressed has the same result as hitting the key four times: CTRL PG DN
(menu choice Display-Forward 4 Pages) moves four pages down.

Control codes and graphics

CONTROL (CTRL X):
You can enter any control character into a SEE file by using a control
prefix. Hitting CTRL X places a control prefix into your file. Place
any letter after the control prefix, and SEE will convert the
combination to that control character when you save the file. For
example, to place a formfeed (^L) into your file, you hit CTRL X, then
type L.

Graphics with SEE
You can place characters from the extended ASCII character set into
your file. SEE regards these characters as normal characters. For
example, to place a Greek letter alpha into your file, (extended ASCII
224), you hold down the ALT key, type 224 on your keypad, and let the
ALT key up. This character set can be used to produce mathematical
symbols, boxes, and foreign letters. The character set is documented
in the IBM Technical Reference for your computer type. You can produce
a sample of each character by entering SEE and using the ALT key along
with the numbers from 128 to 255 inclusive. SEE.HLP was produced using
this technique. WARNING: many printers do not support the IBM extended
character set. If you try to print documents which contain extended
characters, you may have trouble. To test your printer, try printing
SEE.HLP. The printed version should look just like SEE's help screen.

California Scientific Software
160 East Montecito #E, Sierra Madre, CA 91024 818/355-1094
Adding or removing space Page 5

If you wish to use the menu to do block arguments with any of these
functions, first select your text, then hit the keypad * key to pop up
the menu and select the function you desire.

OPEN (F1): Add&Delete-Open Space
Open opens up blank space on the page. If you hit Open without
selecting text, Open moves the current line down one, and creates a new
blank line where it was. If you select a position in the file and move
the cursor over to the left or right, Open will open up space in this
line as wide as your selection. If you move the cursor over and down
from the selection point, Open opens up space for the indicated
rectangle. If you move the cursor straight down from the selection,
Open opens up new lines where you indicated, pushing the rest of your
file down to make room.

CLOSE (CTRL F1 or CTRL C): Add&Delete-Delete
Close works exactly like Open does, except that it makes the indicated
area disappear. If you hit Close with no text selected, Close will
remove the entire line you are on. If you select a rectangle, Close
will remove all the text within the rectangle. If you select a series
of lines by moving the cursor directly below the selection point with
no sideways motion, Close will remove all the indicated lines.

RESTORE (ALT F1 or CTRL R): Add&Delete-Undelete
Restore brings back text that was deleted using Close. Restore is an
"undelete". Restore takes rectangular arguments and uses them as a two
- dimensional repetition count, exactly as Put and Paste do.
Close-Restore uses a buffer which is independent from Cut-Put. Thus
you can use these four functions to swap text.

DELETE (DEL Key or CTRL D):
Delete removes text from the file. Text which is removed with Delete
is gone forever. Delete deletes the character shown by the cursor.
Delete also takes rectangular arguments.

END LINE (ALT F7 or CTRL E): Add&Delete-Delete to EOL
End Line deletes all the characters from the cursor to the end of the
line. Text removed with End Line is gone forever.

BREAK (F7): Add&Delete-Insert Return
Break breaks the current line in two, leaving the text before the
cursor as is, and placing the text under and after the cursor on the
next line. A new line is created to hold this text; no existing text
is removed. Break ignores any selection you may have made.

JOIN (CTRL F7): Add&Delete-Join Lines
Join removes all the text between two original characters. Characters
are deleted from the top left of your selection to one character before
the bottom right. There is no way to restore the characters after Join
has deleted them. If there is no active selection, Join deletes the
rest of the line, and attaches the next line to this one.

California Scientific Software
160 East Montecito #E, Sierra Madre, CA 91024 818/355-1094
Moving or copying text Page 6

GET (F3 or CTRL G): Move&Copy-Copy to Buffer
Get moves a copy of the indicated text into SEE's internal buffer. Get
has no effect on the file itself. The buffer is shared by Get and Cut;
using one of these commands clears out whatever is in the buffer and
then copies the indicated text into the buffer. Get is the inverse of
Paste: Get followed immediately by Paste will have no net effect on the
file, no matter what kind of selection you use. Restoring the text
from the buffer does not effect the buffer. Thus you may place several
copies of the buffer into the file.

CUT (CTRL F3): Move&Copy-Move to Buffer
Cut works exactly like Close does, except that the removed text is
saved in SEE's internal buffer and may be restored later by using Put
or Paste. The buffer is shared by Cut and Get; using one of these
commands clears out whatever is in the buffer and saves the indicated
text into the buffer. Because restoring the text from the buffer does
not affect the buffer, you may place several copies of the buffer into
the file. Put is the inverse of Cut. Cut followed immediately by Put
will have no net effect on the file, no matter what kind of selection
you use.

PUT (F4 or CTRL P): Move&Copy-Copy Buffer to
Put copies SEE's internal buffer into the file. No existing text is
removed or lost from the file. Put is the inverse of Cut; Cut followed
immediately by Put will have no net effect on the file, no matter what
kind of selection you use.

PASTE (CTRL F4): Move&Copy-Copy Buffer on
Paste copies SEE's internal buffer onto the file. Whatever is in the
file will be overwritten. That is, everything under the Pasted text
will disappear, never to return. If the buffer contains lines of text,
Paste will remove the entire line and substitute the line from the
buffer. If the buffer contains a rectangle of text, Paste will only
remove the text in a similar rectangle.


Other SEE commands Page 7

RENAME FILE (CTRL Y): File-Save As
Rename File changes the name of the file your edits will be saved into.
Thus, is you are editing "foo" and want to save your changes as "bas"
without affecting "foo", you would type ESC bas CTRL Y. You may do
this at any time, as often as you like; nothing takes effect until you
save the file. To use the menu, first hit escape, type "bas" at the
"Enter:" prompt, then hit keypad "*" to pop up the menu and select.

INSERT (INSERT key): Options-Insert Mode
The INSERT key changes SEE from insert to overwrite mode and back
again. When you are inserting, the cursor will be a flashing box.
When you are overwriting, the cursor will be a flashing underscore.

AUTO-RETURN (CTRL A): Options-Auto Justify
When auto-return is enabled, SEE hits the return key for you when you're
near the right margin of the document. When SEE hits return for you, it
also tabs over to the left margin of the document. You may toggle this
feature off and on by hitting CTRL A. Initially, margins are set as
column 4 and column 76.

AUTO-INDENT (CTRL V): Options-Auto-Indent
When auto-indent is on, SEE moves the cursor over to the left margin
whenever you hit RETURN. When auto-indent is on, SEE moves the left
margin whenever you hit TAB or BACKTAB. Also, if auto-insert is on and
auto-return is off, SEE increments the indent level each time you type
"{", and decrements the indent level each time you type "}". This is
for C programmers.

DRAW BOX (ALT-B): Add&Delete/Draw Box
SEE has a command for drawing boxes. To use this command, select a
rectangle and hit ALT-B. SEE will draw a box the same size as the
rectangle. Any text which is on the edge of the selected region will be
drawn over. The text in the interior of the selected region will remain
untouched. If the selected region has no height or if it has no width,
SEE draws a line.

The default box type is single lines. You can get different box types
by using Options / Set Box Type, which gives you a menu of 5 box types
to choose from.

SEE only knows how to draw simple boxes. To draw complicated boxes like
the one below, you follow this proceedure: draw the outer box using the
Draw Box command. Then draw the lines that cut across the inside of the
box using Draw Box with rectangles that are either 1 row high or 1
column wide. Finally, use the numeric keypad to fix up the
intersections. To see how this works, hold down the ALT key, hit 5 on
the numeric keypad, and let up the ALT key. This places a "Å" in your
file. The ALT numeric keypad produces these characters:

ÉÍÍÍÍÍÍÍÍÑÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ»
º Numeric³ current box type: º
º Keypad ³ ÚÄÂÄ¿ ³ ÉÍËÍ» ³ ÛßÛßÛ ³ ÖÄÒÄ· ³ ÕÍÑ͸ º
ÇÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄĶ
º 7 8 9 ³ Ú Â ¿ ³ É Ë » ³ Û Û Û ³ Ö Ò · ³ Õ Ñ ¸ º
º ³ ³ ³ ³ ³ º
º 4 5 6 ³ Ã Å ´ ³ Ì Î ¹ ³ Û Û Û ³ Ç × ¶ ³ Æ Ø µ º
º ³ ³ ³ ³ ³ º
º 1 2 3 ³ À Á Ù ³ È Ê ¼ ³ Û Û Û ³ Ó Ð ½ ³ Ô Ï ¾ º
ÈÍÍÍÍÍÍÍÍÏÍÍÍÍÍÍÍÏÍÍÍÍÍÍÍÏÍÍÍÍÍÍÍÏÍÍÍÍÍÍÍÏÍÍÍÍÍÍͼ
Search, Replace, and Global Replace Page 8

SEARCH/REPLACE (F10 or CTRL S or Keypad + or Keypad -):
In SEE, the Search command handles all search and replace functions.
To search for something, you hit the key ESC, type the thing you want
to search for, and then hit Search (Search Forward). For example,

monday

will search for the word "monday". Searches are not case significant:
in the above example Search will find "monday", "Monday", and "MONDAY".
If you hit Search without first entering text to search for Search will
look again for the last thing it searched for. In the above example,
if you immediately hit Search again, it will look for the next "monday"
in the file. If Search cannot find the word, it does nothing.

Search starts its search from your current cursor position, and
searches from there to the end of the file until it finds a match.
Keypad - (Search Backward) does a reverse search. If you use Keypad -
to start Search, Search starts from the current cursor position and
searches from there to the beginning of the file until it finds a
match.

To find something and replace it with something else, you again use the
Search function. For example, to find "monday" and replace it with
"wednesday", you would hit:

mondaywednesday

That is, you hit ESCape to signal that you want to enter text, type the
word you want to search for, hit Enter, type the word you want to
replace it with, and then hit Search. ENTER will display on the status
line as a diamond. If Search cannot find the first word, it does
nothing. If you hit Search again at this point, it will search for the
same word again, and replace it with the same replacement word.

While you are entering text to search for, you may use the BACK SPACE
key to delete the previous character. If you accidentally hit ENTER
when you didn't mean to, BACK SPACE will remove it.

If you hold the CTRL key down while you hit F10, Search will perform
its function repeatedly until it fails (Global Search). Thus, if you
enter both a search and a replace string, Search will replace the first
one it finds, and CTRL Search will replace all of them. Similarly, if
you only entered a search string, Search will find the first one in the
file, and CTRL Search will find the last one in the file.

SEE distribution file list
SEE.DOC - this file
SEE.EXE - the program
SEE.HLP - SEE's help screen
SEE.MNU - SEE's key binding information
Lesson1 - Part 1 of SEE's on line instruction course
Lesson2 - Part 2 of SEE's on line instruction course
Lesson3 - Part 3 of SEE's on line instruction course
Lesson4 - Part 4 of SEE's on line instruction course

California Scientific Software
160 East Montecito #E, Sierra Madre, CA 91024 818/355-1094
The fully featured version of SEE Page 9

California Scientific Software sells a fully featured version of SEE.
The fully featured version has all the speed and features of this
version, and also adds the following features:

o Windows and multiple files let you move paragraphs or tables from one
file to another. No limit on the number of windows or files!

o Spell checking and correcting at 33O words per second on a PC, and up
to 3,OOO words per second on an AT. The dictionary supplied with SEE
covers 97% of written English, with room for 5,OOO user added words.
You can check an entire 2O,OOO word document in one minute!

o Centering and Justification on screen to margins you specify.
The fully featured SEE has auto-justify instead of auto-return.

o Enhanced printing supports bold, extra-bold, superscripts, subscripts,
and underlining on most printers.

o Replace/Confirm stops at each replace position in the file and asks
for a yes/no confirmation. Record and Playback let you create macros.

o Format files let you specify headers, footers, page numbering, tab
stops, and margins for a file, a set of files, a directory, or your
whole system. Chapter headings and page numbering are supported.

Fully featured SEE comes with utilities to help organize your files:

Find your files: Search for your files by file name or file content.
You can search a few files, a directory, or an entire disk with one
command.

Protect your files: Mark files as read-only so that they can't be
changed. Check your disks for bad blocks. Create hidden files. Flag
files that need back up. Encrypt files with your own password.
Permanently erase sensitive data from your disks.

Organize your directories: Rename or Move files from one directory to
another. Put your files in alphabetical order. List your directories
with disk usage statistics.

The CSS Utilities are:

Attrib* - Marks files as read-only, system or hidden
Crypt - Encrypts and decrypts files
DiskScan - Scans your disk for bad blocks
DSort - Sorts your directory files into alphabetical order
Find* - Search directories or disks for files by name or by content
Label - Labels your floppies or hard disk
Log - Maintains a log of your activities
Move* - Renames files into other directories
See* - Word processing with spell checking
Tree - A picture of your disk structure with statistics on files,
directories, bytes used and allocated, percent free space
Wipedisk - Irrevocably erases all data from a disk
*Supports DOS wildcards and pathspecs.

Fully featured SEE and the CSS Utilities are $15O not copy protected
for MS/DOS or PC/DOS 2.O or higher, 256K memory, floppy or hard disk,
including a printed manual. Visa, Mastercard and checks accepted.

California Scientific Software
160 East Montecito #E, Sierra Madre, CA 91024 818/355-1094