Home iWeb Logon Internet Meetings Contact Us Site Map

Z Programs

Z.text.ed.shell

 

This procedure is used to set up a text file for editing by the text editor
kernal (Z.text.ed.kern).

A text box of any size can be defined as long as it is no more than 79 characters wide, and it's bottom margin is less than 24.  Although the kernal will accept a larger edit area (92 by 28), this particular shell has been set up with these maximums. This procedure establishes the temporary RAF which is used by the kernal.  It also defines a special function program and data for this program in special nodes in the RAF.

Arguments:       A - Nameof (^) textfile
B - Top margin.  Defaults to 3.  (A screen-editor message displays)
C - Bottom margin.  Defaults to 23.
D - Line length.  Defaults to 79.  Text lines that exceed this
length are reformatted by; 1st - stripping trailing spaces,
2nd - stripping leading spaces, 3rd - breaking line into
two or more lines.
E - Left margin.  Defaults to 0.  When added to line length
cannnot exceed 79.
F - Has value "D" if display only, otherwise display and edit
is assumed.  If F="Q", then copy queue will be preserved from
last use of editor.
G,H - Name of DPM and element where additional on-line help
documentation is defined.
I - (optional) COLOR only; override special editor functions:
Q(special.func.pgm,D(key.ascii,key.ascii,...),argument)
I|2 is saved in !Z.ARG for use by program in I|0.
Defaults to Q(Z.text.ed.spec.fn.keys,D(148,149,164),"")
J - (optional). Indicates the maximum number of lines for that file

Returns:            1 if text has been edited, otherwise nil.

Posted: August 03, 2001

Return to list of Z Programs