home *** CD-ROM | disk | FTP | other *** search
Text File | 1989-02-13 | 32.8 KB | 1,005 lines |
- .a js=y nm=1 pn=1 hy=n lp=12 bo=51 te=12 to=90
- .st3,14,1
- &dAppendix%E:%%Function%Reference%Guide .jc
- &d[%Appendix%E%] .hc
- .t36 E - .zl
-
-
-
-
- &dINTRODUCTION .jr
- .st3,11,1 .x-5
-
- This Appendix is the complete reference for &iall of the Galahad editing
- and and text formatting functions. Each is described in detail. As discussed
- in Chapters One through Eight, many of these function are not assigned to keys.
- Galahad itself is actually two seperate programs integrated together to form a
- word processor. One program is an editor. The other is a text formatter. The
- editor is available to be used independently, and is called Percival (PER.COM).
- In the description below the first set of function described are the known to
- Percival; the secons set to Galahad.
-
-
-
-
- .st3,14,1 &dDEFINITIONS .jr
- .st3,11,1 .x-5
-
- A few terms need to be discussed before the functions are defined. The
- &itext%buffer holds a copy of the file being edited. The &ipoint is the place
- at which everything happens in the text buffer. The &iscreen contains one or
- two &iwindows into one or two text buffers. The &icursor shows on the screen
- where the point is in the text buffer. Some more terms are discussed in the
- following paragraphs: &iConfirming&s, &iLine%Input&s, &iPrompting&s,
- &iPosition&s, and &iSearch%Strings&s.
-
-
-
- .n &oConfirming
-
- A confirmation is a special prompt that ends in a question mark. A single
- character response is needed.
-
- A confirmation expects one of a small set of characters. You may respond
- by typing the first letter of one of the choices (case is insignificant), you
- may type Control-C (^C), or you may type Return (^M). In all cases, Control-C
- cancels the confirmation, and Return picks the most usual response. If you do
- not type one of the above characters, the bell is rung and you must wait one
- second while the typeahead buffer is cleared. This protects you when you don't
- realize that the question will be asked, and you have started to type the next
- command.
-
-
- .n &oPrompting
-
- The last line on the screen is used for several purposes: to ask you for a
- line of text, to ask you for confirmation of some action, to warn you of some
- error that has occurred, and to give advisory messages. You can very easily
- determine which is occurring by looking at the last character of the message.
- A line input prompt ends in a colon (:), a confirmation or any other message
- that expects a single key response ends in a question (?), an error ends in an
- exclaim (!), and advice ends in a dot (.). (Never give advice; wise men won't
- need it, fools won't heed it, and everyone else will tell you what's wrong with
- it.)
-
- An error message is different from an advisory message in that it results
- from an undesired effect of some action that you have taken. To ensure that
- you pay attention to the message, if you have typed ahead, then the typeahead
- buffer is cleared. In any case the bell is rung.
-
-
- .n &oLine%Input
-
- A line input message is prompting you to input a line of text, which will
- then be interpreted appropriately. You are placed into a special mode, in
- which some of the keys are interpreted differently. The prompt may contain a
- proposed response enclosed in square brackets. Typing just a return will
- accept the proposed response.
-
- In the general case, you will type several printable characters, followed
- by the Return key to cause your input to be accepted. You may wish to cancel
- the action that would ordinarily take place by pressing the Control-C key. A
- mistakenly input character may be removed using the Delete, Back Space or
- Control-H keys.
-
- Some other keys are recognized, but will be used less often. The shift
- Break key causes the proposed response to be brought in for editing. The
- Control-O (^O) key causes the next word in the text to be brought in for
- editing. The Enter key is synonymous with Return. Pressing any key that is
- assigned to a string only will cause that string to be brought in for editing.
- Pressing any key that is assigned to a function will cancel the input line
- operation and execute the function. The InsertControl function allows you to
- input a control character. Pressing the Control-Return key (producting the
- Line Feed character) in command mode causes the function(s) assigned to the
- CmdLF. key to be executed.
-
- The various searching commands assign special meaning to some characters,
- namely *[]<>$~ and ?. These characters, as well as control characters, are
- included in the search string using InsertControl, which accepts those
- characters and shows them on the screen in inverse video.
-
- The bindings given above may be changed. When Galahad is &ireading%a%line
- (&ireading%a &iline means when Galahad is asking for input on the command
- line), it looks first for meta keys prefixed with '?'. By changing the
- assignments in the INI file for the meta '?' keys, you can change the meanings
- of keys. All of the functions that deal with reading a line start with
- 'Read...'.
-
-
- .n &oPosition
-
- There are several functions that deal with the position of the point in
- the text. All of these functions manipulate a stack of positions. The
- examples following each function show a stack that is four positions long,
- while the real stack is sixteen positions long.
- .g
-
- .n &oSearch%Strings
-
- Search strings may contain special characters. These special characters
- do not literally match themselves but instead match other zero or more normal
- characters. Special characters must be included in the search string by
- prefixing them with &dInsertControl command (cF10). The special characters
- are:
- .i16
- .u8 < .t16 Matches the left hand edge of a line. .b
- .u8 > .t16 Matches the right hand edge of a line. .b
- .u8 ? .t16 Matches any single character except newline. .b
- .u8 ~" .t16 Matches, for example, any single character but double
- quote. .b
- .u8 [.;!] .t16 Matches, for example, any one of dot, semi, or exclaim. .b
- .u8 [a-z] .t16 Matches, for example, any lowercase letter. .b
- .u8 [a-] .t16 Matches, for example, lowercase a and dash. .b
- .u8 [-z] .t16 Matches, for example, dash and lowercase z. .b
- .u8 [~xyz] .t16 Matches, for example, any single character execpt
- lowercase x, lowercase y, or lowercase z. .b
- .u8 a* .t16 Matches, for example, zero or more occurrences of
- lowercase a. .b
- .u8 ?* .t16 Matches, for example, zero or more occurrences of
- anything. This has the effect of matching an entire line.
- .i0
- .n4
-
-
-
- .st3,14,1
- &dTHE%PERCIVAL%FUNCTIONS .jr
- .st3,11,1 (Text Editing) .jr
- .x-5
-
-
- .n &dAppendFile
-
- Prompts for a filename, whose contents are appended to the &icurrent
- buffer (i.e., the buffer being displayed).
-
-
- .n &dAsciiFile
-
- Causes &iLoadFile to stop loading the file when the terminating Control-Z
- character is found, and removes the Control-Z from the end of file. Causes
- &iSaveFile to put the Control-Z back, if there was one. This action is
- required by Standard ASCII files. It is the normal way to handle text files.
-
- When Percival is running under Galahad, a few control characters are
- translated to provide special marks for editing functions. When Percival is
- running stand alone &ino charcater translation is done.
-
-
- .n &dBinaryFile
-
- Files are loaded and saved as is.
-
-
- .n &dBlockCursor
-
- The cursor is set to a square block. &iUnderscoreCursor will set the
- cursor to an underscore.
-
-
- .n &dBufferList
-
- The list of buffers, and the files contained in the buffers, is shown on
- the screen (along with some technical data about the buffer contents).
-
-
- .n &dBye
-
- If no text buffers have been modified, and you are in command mode, then
- you are returned to MS-DOS. If you are not in command mode, you are asked if
- you really want to quit. Otherwise, you are asked what to do with each
- modified text buffer: save, scratch, or cancel the entire operation and start
- editing again.
-
-
- .n &dCDirectory
- .n &dChDirectory
-
- You are prompted for a new directory string. This function is exactly
- identical to the MS-DOS command chdir.
-
-
- .n &dCenter
-
- The cursor is centered in the window.
-
-
- .n &dChangeCase
-
- The character to the right of the cursor is changed from uppercase to
- lowercase or vice versa. Non-letters are not changed. The cursor position is
- moved one character to the right.
-
-
- .n &dChangeHighBit
-
- The character to the right of the cursor has its high bit changed. The
- cursor position is moved one character to the right.
-
-
- .n &dCommand
-
- Prompts for a function name, and executes the first matching function.
- Gives an error if no function name is matched.
-
-
- .n &dCommandMode
-
- Causes the Command function to be repeatedly executed until the &iEditMode
- function is executed. Has no effect if in command mode.
-
-
- .n &dCompareWindow
-
- The buffers being shown in both windows are compared character by
- character, starting at the cursor position in each buffer. The comparison
- stops at the first mismatch or end of file. No effect if in OneWindow mode.
-
-
- .n &dCutText
-
- The text showing in inverse video (see &iShowSelect) is removed and placed
- in the insert buffer.
-
-
- .n &dDefaultExtension
-
- If you do not supply an extension when giving a filename, the default
- extension will be used. This function sets the default extension. 'GAL' is
- the initial default extension.
-
-
- .n &dDeleteFile
-
- Prompts for the name of a file to delete.
-
-
- .n &dDeleteLeft
-
- The character to the left of the cursor position is deleted.
-
-
- .n &dDeleteUnder
-
- The character under the cursor (to the right of the point) is deleted.
-
-
- .n &dDelToEnd
-
- All the characters between the cursor and the end of the current line are
- deleted.
-
-
- .n &dDelWordLeft
-
- The word to the left of the cursor is deleted. A word boundary appears
- wherever a boundary is formed between the set of characters: 0-9, A-Z, a-z, and
- the set of characters consisting of everything else.
-
-
- .n &dDelWordRight
-
- The word to the right of the cursor position is deleted.
-
-
- .n &dDirectory
-
- Prompts for a file specifier and lists all the files matching it. If no
- disk drive is given, the default disk is used. If no extension is given, the
- default extension is used.
-
-
- .n &dDisplayString
-
- The following string is displayed on the screen. This is most useful in
- the definition of the "Init." key to show the use of different INI files.
-
-
- .n &dEditFile
- .n &dEditMode
-
- Exits command mode and prompts you for a filename to edit. If no filename
- is entered, then the current file is edited.
-
-
- .n &dExecuteCommand
-
- ExecuteCommand clears the screen and then runs ExecuteProgram.
-
-
- .n &dExecuteFilter
-
- MS-DOS comes with several programs that read their input, modify it, and
- write it. These programs are called filters. Galahad has the ability to send
- part of your text file through one of these filters. You can select the part
- to be filtered by executing &iStorePosition at the top of the text, and
- positioning the cursor at the bottom of the text to be "filtered", and
- executing &iExecuteFilter followed by the name of the filter and any required
- parameters.
-
-
- .n &dExecuteKey
-
- ExecuteKey takes the string supplied as an argument, determines a key name
- from it, and executes the functions assigned to the key as if the key had been
- pressed.
-
-
- .n &dExecuteProgram
-
- The editor sends the remainder of the line (after ExecuteProgram -- the
- argument) to MS-DOS for execution. Any command recognized by COMMAND.COM may
- be given.
-
-
- .n &dExternalCommand
-
- ExecuteCommand takes the string supplied as an argument and interprets it
- as a command to be passed to an external program (such as Galahad) so that the
- external program can execute them. If the external program does not execute
- the command (or if there is no external program), then the command is
- interpreted as a Percival command. If the command is not a valid Percival
- command, Percival will report "Unknown Command.".
-
-
- .n &dFileInfo
-
- Various information about the current buffer is displayed.
-
-
- .n &dFormatIndented
-
- The current paragraph is filled so that each line is no longer than the
- line length specified by the options function. Unlike FormatPara, you must
- position the cursor at the first line of the paragraph, and the column that the
- paragraph is to be indented to. The end is either an empty line or a line
- beginning with whitespace or a period. The ending line is considered to be
- part of the next paragraph.
-
-
- .n &dFormatPara
-
- The current paragraph is filled so that each line is no longer than the
- line length specified by the options function. A paragraph is bounded at
- beginning and end by an empty line or a line beginning with whitespace or a
- period. The ending line is considered to be part of the next paragraph.
-
-
- .n &dGiveHelp
-
- Prompts you for a key, and gives you as much help as it can when that key
- is pressed. Help is provided for only the function and keypad keys.
-
-
- .n &dGotoLine
-
- Prompts you for a line number where the cursor is to be placed in the
- text.
-
-
- .n &dGrowWindow
-
- The current window (in the two window mode) is expanded by one line. No
- action occurs if there is only one window. If the other window is reduced to
- zero lines, then it becomes invisible and only one window is used.
-
-
- .n &dHelpMode
-
- A synonym for &iGiveHelp, which prompts you for a key, and gives you as
- much help as it can when the key is pressed.
-
-
- .n &dHideSelect
-
- All text between the cursor position and the most recently saved position
- is no longer shown in inverse video. No action occurs if &iShowSelect has not
- been executed first.
-
-
- .n &dHistoryEnable
-
- If you have a string of the form 'History:' in the first three lines of
- your file, presumably on a line with =.CL or inside a programming language
- comment, AND you have executed HistoryEnable, Galahad will store the current
- line after the colon. When a file containing 'History:' is loaded by
- &dLoadFile, the cursor is positioned in the file on the line where it was when
- the file was saved.
-
-
- .n &dInsertControl
-
- Prompts for a control character to insert into the text, or to insert into
- the command string of a function (e.g. SearchForNext). Press the desired
- control key. Some other non-control keys are recognized by &dInsertControl.
- The 0 key (not keypad) inserts the "start eighth bit" special character, the 1
- key inserts the "stop eighth bit" special character, the 2 key inserts the
- "alternate character" special character, and the 3 key inserts the "spelling
- check" special character which is placed in the text by Guenevere. The
- following characters cause the equivalent character with the high bit set to be
- inserted: <>[]*~$? (used in search strings -- discussed above). Any other key
- rings the bell.
-
- Note that most control characters are represented on the screen by special
- characters. These representations are shown in most IBM compatible printer
- manuals.
-
-
- .n &dInsertFile
-
- Prompts for a filename, whose contents are inserted into the buffer at the
- cursor position.
-
-
- .n &dInsertNewline
-
- Inserts a new line at the cursor position.
-
-
- .n &dInsertText
-
- The insert buffer is inserted after the cursor position. The insert
- buffer if filled by the SelectText and CutText commands.
-
-
- .n &dInsertTextLeft
-
- The insert buffer is inserted before the cursor position. The insert
- buffer if filled by the SelectText and CutText commands.
-
-
- .n &dListText
-
- The current buffer is listed to a given device or file, for which you are
- prompted. The device defaults to the screen. Legal devices are: PRN:, LST:,
- COM1, COM2, or any file name.
-
-
- .n &dLoadBuffer
-
- Searches for an empty buffer to load a file into. If there is none, a new
- buffer is created. Prompts you for a file to load. If you cancel without
- giving a filename, you will be in an empty buffer with a filename of NONAME and
- the default extension (either GAL or as set by DefaultExtension).
-
-
- .n &dLoadCommand
-
- The file(s) mentioned in the MS-DOS command line when you executed either
- GAL2 or PER is loaded. If you are in Command Mode and a file is loaded then
- you are placed in Edit Mode, otherwise you are left in Command Mode. If you
- are in EditMode, then you are always left in &iEditMode. If you mention more
- than one file, the first file mentioned is left in the top window, and the last
- file mentioned is left in the bottom window.
-
-
- .n &dLoadFile
-
- Prompts you for a file name to load into the current text buffer. If the
- current text has been modified, you are given a chance to &iSave it, &iDiscard
- it (i.e. not save it), or &iCancel the LoadFile command.
-
-
- .n &dLowerCase
-
- The character to the right of the cursor position is changed from
- uppercase to lowercase. Non-uppercase letters are not changed. The cursor is
- moved one character to the right.
-
-
- .n &dMakeBufferUnmodified
-
- Galahad remembers whether or not you have modified a buffer. Executing
- &iMakeBufferUnmodified causes Galahad to forget that the buffer has been
- modified.
-
-
- .n &dMetaKey
-
- When &iMetaKey is assigned to a key, that key when pressed causes the next
- key pressed to take on special meaning. This is similar to the pressing Control
- and another key at the same time, except this is a two key sequence: the meta
- key and the next key. Call this second key a "metaized" key. When the key to
- be a meta key is defined using the &iMetaKey function, a string is specified.
- The first character specifies the meta code character and the remainder of the
- string is printed on the command line when the meta key is pressed. The
- following example should help to see how the metaized key takes on special
- meaning. Assume the following definitions:
-
- Escape==MetaKey "1Meta Active - Press Companion Key";
- ^R==SearchForPrev;
- M1^R==ReplaceQuery;
-
- The Esc key is the meta key, its code is 1. When Control-R is pressed it
- executes SearchForPrev, but when Esc then Control-R are pressed the ReplaceQuery
- function is executed. The lead in M1 to ^R defines its action in the metaized
- state. There can be more than one meta key defined. See GAL101.INI, Esc and
- ^X are both meta keys.
-
- Help for metaized keys is available by pressing a metaized key that
- executes &iGiveHelp or by pressing the key that is mapped to the desired
- &iMetaKey prior to pressing your key.
-
-
- .n &dMoveDown
-
- The cursor is moved down by one line, keeping the cursor as near to the
- same column as possible.
-
-
- .n &dMoveLeft
-
- The cursor is moved one character to the left. Nothing happens if you try
- to move past the beginning of the file.
-
-
- .n &dMoveRight
-
- The cursor is moved one character to the right. Nothing happens if you
- try to move past the end of the file.
-
-
- .n &dMoveToBottom
-
- Moves the cursor to the bottom of the file.
-
-
- .n &dMoveToLeft
-
- Moves the cursor to the left margin.
-
-
- .n &dMoveToMouse
-
- This command is normally executed by pressing a mouse key. In that event
- the cursor is moved to the character that the mouse cursor is pointing to.
- This action is repeated until any key is pressed. (This causes the text cursor
- to follow the mouse cursor.) Typically that key is either LeftUp or RightUp,
- the mouse button release codes.
-
-
- .n &dMoveToRight
-
- Moves the cursor to the right end of the line.
-
-
- .n &dMoveToTop
-
- Moves the cursor to the top of the file.
-
-
- .n &dMoveUp
-
- The cursor is moved up by one line, keeping the cursor as near to the same
- column as possible.
-
-
- .n &dMoveWordLeft
-
- The cursor is moved to the end of the word to the left, or if on a white
- space character (Space of Tab) the cursor is moved to the beginning of the next
- word.
-
-
- .n &dMoveWordRight
-
- The cursor is moved to the beginning of the word to the right, or if on a
- white space character (Space of Tab) the cursor is moved to the end of
- the previous word.
-
-
- .n &dNameText
-
- Prompts you for a new name for the current text. Caution must be observed
- when using this function in an Init. definition because both the filename and
- extension default to the current filename and extension. When Init. executes,
- there is no current filename and extension, so be sure to mention both filename
- and extension. A good choice for the filename is "NONAME"
-
-
- .n &dNewBuffer
-
- Creates an empty buffer and puts the cursor at the beginning of the new
- buffer.
-
-
- .n &dNextBuffer
-
- The buffers are arranged as a ring of buffers. &iNextBuffer takes you to
- the next one. Empty buffers are skipped.
-
-
- .n &dOneWindow
-
- The current window is expanded to fill the entire screen. No action
- occurs if there is only one window.
-
-
- .n &dOptions
-
- Prompts you for some options whose prompts are self-explanatory, and refer
- to the printer actions when the ListText command is used, and the length of the
- text line in the Edit mode.
-
-
- .n &dOtherWindow
-
- The buffer shown in the other window is selected as the current buffer,
- and the cursor is move to its position in that buffer. No action occurs if
- there is only one window.
-
-
- .n &dPageDown
-
- Prompts you for a percentage of the screen to move down. The default is
- the same as the previous value. This parameter will most often be supplied in
- the key definition.
-
-
- .n &dPageUp
-
- Similar to PageDown, but the cursor is moved up, not down.
-
-
- .n &dQuit
-
- If no text buffers have been modified, then you are returned to MS-DOS.
- Otherwise, you are asked what to do with each modified text buffer: Save (save
- the file), Discard (do not save the file), or Cancel the entire operation and
- start editing again. Pressing either S, D or C causes the action.
-
-
- .n &dReadAccept
-
- Used only while reading a line on the Command Line. The line as shown
- will be accepted.
-
-
- .n &dReadCancel
-
- Used only while reading a line on the Command Line. The current line will
- be discarded, and the prompt will go away.
-
-
- .n &dReadChar
-
- Used only while reading a line on the Command Line. The next character in
- the text buffer gets placed at the end of the input line.
-
-
- .n &dReadDelete
-
- Used only while reading a line on the Command Line. The last character is
- removed from the input line.
-
-
- .n &dReadHelp
-
- Used only while reading a line on the Command Line. The help string
- assigned to the current key being executed will get printed on the screen.
-
-
- .n &dReadInitBuffer
-
- The current buffer is treated as an INI file. Very useful for creating
- temporary key definitions to do some complicated sequence of functions.
-
-
- .n &dReadOld
-
- Used only while reading a line on the Command Line. The "old" string,
- given inside square brackets, is appended to the end of the input line.
-
-
- .n &dReadWord
-
- Used only while reading a line on the Command Line. The next word in the
- text buffer is appended to the end of the input line.
-
-
- .n &dRecordKey
-
- You are prompted for a key name. All functions executed until the next
- time you execute &iRecordKey with the same name are assigned to that key.
-
-
- .n &dReferWindow
-
- The current line is examined for an occurrence of the string "Refer:". If
- such a string is found, decimal digits immediately following the colon are
- converted into a line number, and the &iother window is positioned to that line
- number. Using this function you can a simplistic form of hypertext.
-
-
- .n &dRenameFile
-
- Prompts for two filenames. The first file is renamed to the second.
-
-
- .n &dReplaceInAllBufs
-
- Exactly like &iReplaceQuery, but the replacement operation is performed
- for every text buffer in memory. Very handy for changing multiple chapters, or
- multiple source files.
-
-
- .n &dReplaceQuery
-
- Prompts you for a string to search for, and a replace string. The buffer
- is searched from the top to the bottom for the string. When a match is found,
- you are given several choices. You can confirm this replacement with &dY&tes;
- deny this replacement with &dN&to or Return; confirm all the remaining
- replacements with &dC&thange every match; or deny this and all remaining
- replacements with &dQ&tuit replace or Control-C. The replace string may
- contain a special character represented by a special dollar sign ($). When a
- replacement occurs, the entire matched string (i.e., the search string) is
- substituted for the $. The $ is included in the replace string using
- Control-F10 (NOT the normal $ character).
-
-
- .n &dReplaceToBottom
-
- Identical to &iReplaceQuery but the search starts at the character
- following the cursor position.
-
-
- .n &dRestorePosition
-
- The point (i.e., cursor position) and top of "point" stack are swapped,
- and the point stack is rolled.
- .i16 Point
- .t40 becomes Top of stack Top of stack
- .t40 becomes 2nd on stack 2nd on stack
- .t40 becomes 3rd on stack
- .t40 last on stack becomes Point
- .i0
-
-
- .n &dSavePosition
-
- The point (i.e., cursor position) is pushed onto the top of the "point"
- stack.
- .n5 .i16 Point
- .t40 stays the same Top of stack
- .t40 becomes Point 2nd on stack
- .t40 becomes Top of stack 3rd on stack
- .t40 becomes 2nd on stack etc.
- .i0
-
- .n &dSaveText
-
- Prompts you for a name to save the current buffer into. Defaults to the
- name that you loaded the file with. If the file already exists then you are
- given a choice of &dR&teplacing the old file or making it into a &dB&tackup, or
- &dC&tancelling the operation (do nothing and return to Edit or Command mode).
- Pressing Return will also &ireplace the old file.
-
-
- .n &dScratchText
-
- If the current text has been modified, you are given a chance to &dS&tave
- it, &dS&tcratch it (empty the buffer, i.e., discard the text), or &dC&tancel
- the scratch command (do nothing). Sets the filename to NONAME, and the
- extension is set to the default.
-
-
- .n &dScreenColor
-
- You will be prompted for a foreground and background color. You may
- choose from: white, yellow, magenta, red, cyan, green, blue, black.
-
-
- .n &dSearchForNext
-
- Prompts you for a string for which to search. The buffer is searched
- for the string from the first character following the cursor to end of the
- text. If the string is not found, then a message to that effect is printed out.
-
-
- .n &dSearchForPrev
-
- Prompts you for a string for which to search. The buffer is searched for
- the string from the character preceding the cursor position to the beginning of
- the text. If the string is not found, then a message to that effect is printed
- out.
-
-
- .n &dSearchFromTop
-
- Prompts you for a string for which to search. The buffer is searched for
- the string from beginning to end of the text. If the string is not found, then
- a message to that effect is printed out.
-
-
- .n &dSelectText
-
- The first time that you execute this function, a special mark character is
- inserted into the buffer. The mark character appears as a "squiggle"
- similar to that used to mark footnotes in printed texts; call it the mark
- character. The second time that you execute this function, all text between
- the cursor position and the mark character is removed (cut) from the buffer and
- placed into the special insert buffer. (See InsertText.) If you wish to
- change your mind and move the mark after you have placed it (but before you
- have cut the text), you may do so by deleting the mark character, as any
- other character, and continuing as though you hadn't executed this function.
-
- Strings longer than an arbitrary size are treated specially, and take
- longer to cut. Be patient.
-
-
- .n &dShowSelect
-
- All text between the cursor position and the most recently saved position
- (see SavePosition) is shown in inverse video. This continues until the
- &iHideSelect function is executed.
-
-
- .n &dSpellCheck
-
- The word &ipreceding the cursor position will be spell checked (if the
- command SpellerOn has been executed). If the word is misspelled the bell will
- ring. The function is dependent upon the Clarkson Speller being installed
- before running Galahad (See Appendix H).
-
-
- .n &dSpellerOff
-
- Causes &iSpellCheck to have no effect.
-
-
- .n &dSpellerOn
-
- Causes &iSpellCheck to spell check words.
-
-
- .n8 &dSwapPosition
-
- The point (cursor position) and the most recently saved position are
- swapped.
- .n5 .i16 Point
- .t40 becomes Top of stack Top of stack
- .t40 becomes Point 2nd on stack
- .t40 stays the same 3rd on stack
- .t40 stays the same etc.
- .i0
-
-
- .n &dTabToPrev
-
- If the current line is empty then it is tabbed out to the same column as
- the previous line.
-
-
- .n &dTieWindows
-
- The two windows are tied together so that they scroll in unison.
-
-
- .n &dToggleReplace
-
- The insert/replace flag is toggled (changed from on to off, or vise
- versa). The flag is initially off, which means that all characters entered
- from the keyboard are inserted into the text at the cursor position. When the
- flag is on, all characters entered from the keyboard replace the characters
- under the cursor, if there are any.
-
-
- .n &dToggleShowBlanks
-
- The show blanks flag is toggled (changed from on to off, or vise versa).
- The flag is intially off, which means that trailing blanks and tabs are not
- visible. When the flag is on, trailing blanks and tabs are displayed visibly
- on the screen using special characters.
-
-
- .n &dToggleSplit
-
- The split/nosplit flag is toggled (changed from on to off, or vise versa).
- The flag is initially off, which means that inserting a character into a line
- which exceeds a given line length causes the paragraph containing the line to
- be re-formatted starting at the cursor position. When the flag is on, lines
- may be any length and will never be split.
-
-
- .n5 &dTransposeChars
-
- The two characters to the right of the cursor position are transposed. If
- either of the characters is the end of line, no action occurs.
-
-
- .n &dTwoWindow
-
- The screen is split horizontally into two screens, equal in size. The
- current buffer is shown in the both windows.
-
-
- .n &dUnderscoreCursor
-
- The cursor is set to an underscore. &iBlockCursor will set the cursor to
- a block.
-
-
- .n &dUndoChange
-
- Any changes made to the current line, including deleting it, may be undone
- as long as the cursor remains on the line.
-
-
- .n &dUntieWindows
-
- The action of &iTieWindows is undone.
-
-
- .n &dUpperCase
-
- The character to the right of the cursor position is changed from
- lowercase to uppercase. Non-letters and uppercase letters are not changed.
- The cursor is moved one character to the right.
-
-
- .n &dUserPhrase
-
- You are prompted for a key name, and then a phrase to be assigned to that
- key.
-
-
- .n &dWindowMargin
-
- Prompts you for the top and bottom margins of the screen. The cursor will
- not enter the margin but instead the screen will scroll. The margin numbers
- are expressed as a percentage of the size of the screen.
-
-
- .n &dWriteInitBuffer
-
- The INI file that was used to configure your Galahad is reconstructed and
- inserted into the current buffer.
-
-
- .st3,14,1 &dTHE%GALAHAD%FUNCTIONS .jr
- .st3,11,1 (Text Printing) .jr
- .x-5
-
-
- .n &dImmediate
-
- The &iImmediate command allow the user to supply a set of Dot-A command
- which will override the value of Dot-A commands in the text, or supply new
- values for those not in the text. This command is normally entered on the
- command line before printing. For example: imm al==y lp==10
-
-
- .n &dConfigurePrinter
-
- This command causes the Printer Configuration Menu to pop up. This is
- the command which is bound key Esc P in the supplied default GAL101.INI or
- GAL83.INI files. Once Galahad is configured for a printer, it remains
- configured for that printer until change by this command.
-
-
- .n &dGalahadHelp
-
- This command causes the Galahad Help Menu to pop up. The same as
- executing the keys Shift Return H G.
-
-
- .n &dPrintText
-
- The command to cause Galahad to format the current buffer and send it to a
- device or file. The default device is the screen. Legal devices are the
- MS-DOS devices LPT, PRN, COM1, etc. A file may be any legal file name. In
- addition to a device of file name the command takes three optional numbers: 1)
- the page to start printing, 2) the page to end printing, and 3) the number of
- files to process if the Galahad Dot-F (.F) command is used.
- .i34
- Examples:
- .u26 print prn .t30 - Print to the prn device (the printer).
- .u26 print prn 1,2 .t30 - Print to the printer pages 1 and 2.
- .u26 print myfile.txt .t30 - Print all pages to the file myfile.txt.
- .u26 print myfile 4,10,2 .t30 - Print only pages 4 thorugh 10, which will be in
- two file for Galahad to process.
- .u26 print com1 ,4 .t30 - Print to the COM1 device pages 1 through 4.
-
- NOTE: Be sure that Galahad must first be configured, using
- &iConfigurePrinter, for your printer.