Simtel MSDOS 1992 September/Simtel20_Sept92.cdr/msdos/editor/gal210a4.arc/APPE.GAL

Text File | 1989-02-13 | 34KB | 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.