Lists all the valid names and shift- combinations for the user-definable
keys.
:eul.
.***
:h1 id=userg.Using The Editor
:p.
.***
:h1 id=intro.Introduction
:p.:HP2.T:EHP2. is a full screen text editor for the IBM PC, PS/2 and
compatible family of machines.
Two versions of the editor are supplied, one to run under DOS and the
other to run under OS/2.
It is designed to be quick and easy to learn and simple to use, while
remaining both extremely powerful and very small - the DOS version being
under 10,000 bytes in size.
:p.A very small editor has a number of advantages&colon.
:ul.
:li.It may be used on machines with a limited amount of memory. Even a
PC with a full 640K of base memory can have a large amount of this used
up when a number of terminate-and-stay-resident type programs are
installed - local area network drivers and terminal emulators are prime
examples.
:li.It may be used for editing large files that would be too large to
load into memory with a bigger editor.
:li.It may be invoked from inside other programs yet still have enough
free memory to edit a good sized file.
:li.It loads and starts very quickly indeed.
If you just wish to make a small change to your CONFIG.SYS file it can
be very frustrating to spend time waiting for a large word processor to
start up.
:li.It can be placed on a diskette without consuming much space.
This can be useful for those "emergency" diskettes used to boot up
and fix a system when all else fails.
:li.It can be placed on a RAM disk without consuming much space.
This can be useful for palmtop type machines which often have no disk
drives at all.
:eul.
.***
:h2 id=BM3.Features and Omissions
:p.:HP2.T:EHP2. has the following main features&colon.
:ul.
:li.Very small size, under 10,000 bytes.
:li.Fast, easy to use, full screen interface that adapts automatically
to use the full size of the display.
:li.Edits very large files, subject to available memory.
:li.Edits very long lines, up to 65,528 characters.
:li.Edits any number of files at once, subject to available memory.
:li.On screen help
:li.Very fast search and replace functions.
:li.Customisable keyboard mapping and screen colours.
:li.Any DOS or OS/2 command may be run without leaving the editor.
:li.A "right hand margin" and "word-spill" to allow some
simple word processing to be performed.
:li.Native DOS and OS/2 versions, which also run under Windows and
Windows/NT.
:li.OS/2 version has full support for the HPFS.
:eul.
:p.To keep :HP2.T:EHP2. small it necessarily lacks some of the more
advanced features of larger editors and word processors.
In particular&colon.
:ul.
:li.Copying and moving data can only be performed on blocks of one or
more whole lines.
:li.Word processing capabilities are very limited.
:li.No programmability, although the appearance and function may be
customised.
:li.No direct support for the mouse or a menu system.
:eul.
.***
:h2 id=BM4.What You Need
:p.:HP2.T:EHP2. should run on any IBM PC, PS/2 or compatible machine.
It needs PC-DOS or MS-DOS version 2.00 or later, or any version of OS/2.
The DOS version may also be run as a DOS application under Microsoft
Windows and both the DOS and OS/2 versions may be run under Windows/NT.
:p.When used with OS/2 or with appropriate versions of Windows it may be
run from both full screen and windowed command prompts, or may be
started by placing an object in one of the OS/2 folders or Windows
Program Manager groups.
:p.:HP2.T:EHP2. is available inside IBM by requesting the T PACKAGE from
PCTOOLS.
:p.:HP2.T:EHP2. is also made freely available outside IBM through the
Employee Written Software programme.
The file :font facename=Courier size=0x0.TINYED.ZIP:font facename=default. can be obtained through CompuServe, from
many BBS systems and via anonymous FTP from a number of sites (e.g.
software.watson.ibm.com).
The ZIP file should be unpacked with PKUNZIP to create the full package.
:p.The :HP2.T:EHP2. package contains&colon.
:dl compact tsize=18.
:dt.T.EXE
:dd.This is the DOS version of the editor program.
:dt.T2.EXE
:dd.This is the OS/2 version of the editor program.
:dt.TKEY.EXE
:dd.This is the customiser program.
It will run under both DOS and OS/2 and will customise either version of
the editor.
:dt.THELP.HLP
:dd.This is a simple help file for the standard editor configuration.
:dt.TKEYS.DEF
:dd.This is a sample custom definition file that describes the standard
editor configuration.
:dt.T.DOC
:dd.This is the full documentation in a plain ASCII printable format.
:edl.
:p.In addition the publicly available :font facename=Courier size=0x0.TINYED.ZIP:font facename=default. package
contains the following important file&colon.
:dl compact tsize=18..
:dt.LICENSE.TXT
:dd.This contains the terms and conditions under which IBM makes the
package available.
:edl.
.***
:h1 id=start.Getting Started
:p.This section describes how to get :HP2.T:EHP2. up and running, what
the screen looks like and how to ask for help.
.***
:h2 id=BM6.Starting T
:p.Only the program file (:font facename=Courier size=0x0.T.EXE:font facename=default. for DOS or
:font facename=Courier size=0x0.T2.EXE:font facename=default. for OS/2) is required to be able to use the editor;
this should be located in the current directory of the current drive, or
in a subdirectory listed in your PATH.
The other files are only required if you want to customise the editor or
if you want to use the supplied help file.
These other files would normally be kept on a separate diskette or in
their own subdirectory (which need not be in the PATH).
:p.If you use OS/2 exclusively or use both DOS and OS/2 but keep your
DOS and OS/2 programs in separate subdirectories you might want to
rename the OS/2 executable to :font facename=Courier size=0x0.T.EXE:font facename=default. also.
This avoids having to remember whether to type T or T2 depending on the
environment you are using.
:p.Since :HP2.T:EHP2. is so small it makes sense to put it on a RAMDRIVE
if you have one installed, this means that it will load almost
instantly.
:p.To start :HP2.T:EHP2. simply enter the following command at the DOS
or OS/2 prompt&colon.
:xmp.
T <filename> <filename> ...
or T2 <filename> <filename> ...
:exmp.
:p.
You can put any number, including zero, of file names after the
:font facename=Courier size=0x0.T:font facename=default. command and :HP2.T:EHP2. will load each file you list into
its memory.
If you are using the OS/2 HPFS and your file names include spaces you
must specify the name inside double quotes, so :HP2.T:EHP2. does not
think it is two separate file names.
.***
:h2 id=BM7.Screen Layout
:p.The :HP2.T:EHP2. screen is divided into four areas&colon.
:ol.
:li.The :HP1.Message Line:EHP1. and the :HP1.Help Line:EHP1..
:p.The bottom line of the screen is used to display error and
informational messages.
When no messages are displayed this line shows instead a single line of
"help".
Typically the functions assigned to the F-keys are displayed, but this
can be customised to whatever you find useful.
:li.The :HP1.Status Line:EHP1..
:p.Above the message line is the status line.
This shows the name of the current document and the line and column
number of the position of the cursor within the document.
If a right-hand margin has been set this will also be displayed
following an "M" margin indicator.
The current typing mode (either "replace" or "insert") is also
indicated.
:li.The :HP1.Command Line:EHP1..
:p.Above the status line is the command line.
Any any valid :HP2.T:EHP2. command may be entered here.
:li.The :HP1.Data Area:EHP1..
:p.The rest of the screen is used to display the document being edited.
:eol.
:p.The size of the data area is automatically adjusted to fill the whole
of the screen.
Most modern displays can show more than 25 lines and many can show more
than 80 columns.
:HP2.T:EHP2. itself cannot change the size of the display but it will
use the full size of the screen that is available when it is started.
So to see rather more data on the screen first switch to a mode that
shows more than 25 lines then invoke :HP2.T:EHP2..
For example, the following command will switch to a 43 line 80 column
mode under OS/2 or DOS (this needs DOS 4.00 or later)&colon.
:xmp.
MODE CO80,43
:exmp.
.***
:h2 id=BM8.The Help File
:p.:HP2.T:EHP2. is supplied with a simple help file which describes the
default key settings and the commands available.
When using :HP2.T:EHP2. for the first time ensure that the help file
:font facename=Courier size=0x0.THELP.HLP:font facename=default. is available in the current directory of the
current drive.
Later you can customise the editor to allow the help file to be kept
somewhere else.
:p.Press the F1 key to load and display the help file.
Then use the PgUp and PgDn keys to view the various help panels it
contains.
If you have a 40-column display use the Home and End keys to view the
left and right hand panels.
.***
:h1 id=tedit.Editing
:p.This section gives a brief introduction to editing with :HP2.T:EHP2..
It assumes the editor is used in its default configuration, as supplied.
Later sections describe how to customise the editor.
Anyone who is familiar with the IBM Personal Editor will recognise the
way :HP2.T:EHP2. works immediately and should be able to skip most of
this section - although a glance at :link refid=wordp reftype=hd.Word Processing:elink. and
:link refid=boxes reftype=hd.Drawing Boxes:elink. might be worthwhile.
.***
:h2 id=BM10.Keyboard Functions
:p.Most of the services that :HP2.T:EHP2. can perform are accessed
through :HP1.keyboard functions:EHP1..
These functions are invoked by pressing the key or key combination to
which the function is assigned.
Many functions are assigned to obvious keys, for example the
:HP4.LEFT:EHP4. function (which moves the cursor one character to the
left) is assigned to the cursor Left key, the :HP4.RIGHT:EHP4. function
(to move the cursor right) to the cursor Right key and so on.
Other functions are assigned to key combinations that it is hoped
provide some sort of mnemonic for the function concerned, so for example
the :HP4.REPEAT LINE:EHP4. function (to duplicate the current line) is
assigned to Alt-R, the :HP4.SPLIT LINE:EHP4. function (to split the
current line) to Alt-S and so on.
Full details of these keyboard functions and the keys to which they are
assigned can be found in :link refid=kfunc reftype=hd.Keyboard Functions:elink..
.***
:h2 id=BM11.Simple Editing
:p.If :HP2.T:EHP2. is started without any filename (by just entering
:font facename=Courier size=0x0.T:font facename=default. on the command line) it displays and edits a new, empty,
unnamed document.
A "Top of File" marker line indicates the top of the document
and an "End of File" marker indicates the end.
These marker lines are not part of the document and may not be edited,
although the cursor may be moved onto them.
.***
:h3 id=BM12.The Command Line
:p.The cursor is initially placed on the command line, which is the
third line up from the bottom of the screen.
Any :HP2.T:EHP2. command can be entered on the command line and it is
executed when the Enter key is pressed.
As a command is typed mistakes can be corrected using the functions
:HP4.LEFT:EHP4., :HP4.RIGHT:EHP4. and :HP4.BACKSPACE:EHP4. (assigned to
the cursor Left, cursor Right and the Backspace keys, respectively).
When the editor is in "replace" mode any characters typed overwrite
those already on the screen; when in "insert" mode any characters
to the right of the cursor are shifted right to make room for the new
text.
Switch between "insert" and "replace" mode by using the
function :HP4.INSERT TOGGLE:EHP4. (assigned to the Ins key).
:p.When on the command line the cursor Up and cursor Down keys recall
any previous commands entered.
These can then either be entered again directly by pressing Enter or can
be altered before being reused.
.***
:h3 id=BM13.The Data Area
:p.The cursor may be switched between the data area and the command line
by using the function :HP4.COMMAND TOGGLE:EHP4. (Esc key).
When the cursor is on the command line a :HP1.shadow cursor:EHP1. marks
the position in the data where the real cursor will appear when the
function :HP4.COMMAND TOGGLE:EHP4. is used.
:p.When the cursor is in the data area it may be moved anywhere between
the "Top of File" and "End of File" marker lines.
At any place text may be typed from the keyboard.
If the editor is in "replace" mode any text typed will overwrite
whatever was there before, if it is in "insert" mode anything to
the right of the cursor will be shifted to the right to make room for
the new text.
:p.To add a new line use the function :HP4.INSERT LINE:EHP4.
(Ctrl-Enter) and to delete a line use the function :HP4.DELETE
LINE:EHP4. (Ctrl-Backspace).
Alternatively if the editor is in "insert" mode just pressing Enter
will insert a new blank line (using the function :HP4.NEW LINE:EHP4.).
.***
:h3 id=BM14.Marking and Copying Lines
:p.A block of one or more lines may be marked by pressing the function
:HP4.SET MARK:EHP4. (Alt-L) on the first and last lines of the required
block.
:p.Marked blocks may be deleted using the function :HP4.DELETE
MARK:EHP4. (Alt-D) or they be moved or copied somewhere else.
To move or copy a mark first position the cursor at the line above the
desired new position, then use either the function
:HP4.MOVE MARK:EHP4. (Alt-M) or :HP4.COPY MARK:EHP4. (Alt-C).
:p.Marked blocks are also useful for limiting the scope of a CHANGE or
LOCATE command (described later).
:p.It is also possible to shift all marked lines one character to the
left or right by using the functions :HP4.MARK LEFT:EHP4. (Shift-F7) or
:HP4.MARK RIGHT:EHP4. (Shift-F8) respectively.
This can be used to indent blocks of code when writing programs, for
example.
:p.To duplicate a copy of the current line just use the function
:HP4.REPEAT LINE:EHP4. (Alt-R).
.***
:h3 id=BM15.Saving Documents
:p.If a document has a name (displayed on the status line) it can be
saved to disk simply by using the function :HP4.SAVE:EHP4. (F2); once
saved you may quit the document with the function :HP4.QUIT:EHP4. (F3).
Alternately you can perform a save and quit in one operation by using
the function :HP4.SAFE FILE:EHP4. (F4).
If a document doesn't have a name you must give it one&colon. either use the
NAME command to name the document or use the SAVE or FILE commands along
with a filename parameter.
:note.Using the function :HP4.SAFE FILE:EHP4. (F4) will not cause the
document to be written to disk if it has not been changed.
If you want to force an unchanged document to be re-written to disk
simply use the FILE command from the command line.
.***
:h3 id=BM16.Working On Several Documents
:p.:HP2.T:EHP2. can edit any number of documents at once.
The documents are held in an :HP1.edit ring:EHP1., and although only one
can be displayed on the screen at one time, you can cycle through the
ring by using the functions :HP4.NEXT FILE:EHP4. (F10) or :HP4.PREVIOUS
FILE:EHP4. (F11).
The actual number of documents you can hold in the ring depends on the
size of each document and how much memory your machine has; each
document has to be completely loaded in memory.
:p.To load multiple documents you can either enter several filenames
when :HP2.T:EHP2. is started from the command line, or you can issue
EDIT commands to load more files once :HP2.T:EHP2. is running.
:p.The marked line functions :HP4.MOVE MARK:EHP4. (Alt-M) and :HP4.COPY
MARK:EHP4. (Alt-C) are particularly useful when editing several
documents as lines can be moved and copied to and from different
documents.
.***
:h2 id=BM17.Search and Replace
:p.
.***
:h3 id=BM18.Searching
:p.To search for a particular word or phrase in a document switch onto
the command line and use the LOCATE command.
In its simplest form you just enter a command rather like this&colon.
:xmp.
/word
:exmp.
:p.
This will search the document for the next occurrence of "word".
:HP2.T:EHP2. will only search from the current position forwards, so to
search from the top you first need to move to the top by using the
function :HP4.TOP OF FILE:EHP4. (Ctrl-Home).
:p.Having found a match you can repeat the search to find the next match
simply by using the function :HP4.REPEAT FIND:EHP4. (Alt-F).
If no further matches can be found before the end of the document the
message "No match found" will be displayed.
:p.Normally LOCATE commands are case-sensitive i.e. a search for
"word" would not find "WORD" or even "Word".
To do a case-insensitive search add the "c" option to the command,
like this&colon.
:xmp.
/word/c
:exmp.
.***
:h3 id=BM19.Replacing
:p.To change one word or phrase into something else switch onto the
command line and use the CHANGE command, for example&colon.
:xmp.
C/this/that
:exmp.
:p.
This will search for the next occurrence of the word "this" and
then prompt for an action with the message "Yes/No/Go/Last/Quit?".
Hit either Y, N, G, L or Q as appropriate&colon.
:dl compact tsize=8..
:dt.Yes
:dd.To change this occurrence of "this" into "that" and to
search for the next occurrence of "this".
:dt.No
:dd.To skip this change, but to continue searching.
:dt.Go
:dd.To make this change and all further changes to the end of the
document without any further prompting.
:dt.Last
:dd.To make this change and to stop searching, so this becomes the last
change.
:dt.Quit
:dd.To skip this change and stop searching.
:edl.
:p.To avoid the prompt message and to make all changes straightaway add
the "*" option to the command&colon.
:xmp.
C/this/that/*
:exmp.
.***
:h2 id=wordp.Word Processing
:p.:HP2.T:EHP2. is not designed to be a word processor, but it does
provide some very simple word processing functions that are useful for
creating quick notes or for entering marked-up documents that will later
be formatted with a batch formatter.
.***
:h3 id=BM21.The Right Margin and Word Spill
:p.The command MARGIN allows a right hand margin column to be set.
When a margin is set the status line indicates its column number with
"M nnn".
To set the right hand margin to column 72 you would enter the command&colon.
:xmp.
MARGIN 72
:exmp.
:p.
As text is entered into the document any words that are typed across
the right hand margin are automatically word-spilled onto a new inserted
line.
This means it is possible to type whole paragraphs without having to
worry about hitting Enter at the end of each line.
As words spill onto a new line they are automatically indented from the
left hand side so as they align under the first non-blank character of
the line above.
This makes it very simple to leave a left margin or to enter whole
sections indented.
.***
:h3 id=BM22.The ADJUST LINE Function
:p.If corrections need to be made to text entered with a right margin
the text will not be reflowed automatically to keep the margins correct;
in fact after making a number of corrections it will tend to end up in
rather a mess.
The function :HP4.ADJUST LINE:EHP4. (Alt-A) is provided to tidy up this
mess and re-align everything correctly.
:HP4.ADJUST LINE:EHP4. is performed by pressing Alt-A and will adjust
the current line to the current right margin setting.
If the line is too short it will be filled out with words from the next
line down and if it is too long it will be split in two.
As with the word-spill, when :HP4.ADJUST LINE:EHP4. spills words onto
the next line they are aligned under the first non-blank character of
the preceding line.
:p.:HP4.ADJUST LINE:EHP4. will ignore blank lines, skipping over them
and moving the cursor to the next line down, and if a line needs to be
split in two the cursor will move down to the split-off portion.
This makes re-adjusting whole paragraphs very simple, just place the
cursor on the first line of the paragraph and keep pressing Alt-A until
it is re-flowed correctly.
:note.When a line is too short and :HP4.ADJUST LINE:EHP4. fills with
words from the next line, these words are joined to the line with just
one intervening blank.
If before the :HP4.ADJUST LINE:EHP4. the last character happened to be a
full stop at the end of a sentence you may need to go back and insert an
extra space to maintain the convention of two blanks following a
sentence end.
.***
:h2 id=boxes.Drawing Boxes
:p.The PC character set contains a group of special symbols that can be
used to draw boxes.
:HP2.T:EHP2. assigns the box corner and intersection characters to the
keys Alt-1 to Alt-9.
As a reminder of which box corner is assigned to which key, just look at
the numeric keypad which is arranged like this&colon.
:xmp.
7 8 9
4 5 6
1 2 3
:exmp.
:p.
So the Alt-7 key produces a top left box corner, the Alt-3 a bottom
right and so on.
Remember that the keypad just provides a mnemonic - you must actually
enter characters using the Alt-key and the numerals along the top of the
main keyboard area.
:p.The horizontal line is assigned to Alt-- (Alt-minus) and the
vertical line to Alt-= (Alt-equals).
These two may need reassigning to use other keys on non-English language
keyboards, where the "-" and "=" keys don't appear on the top
row just after the numerals.
This can be done by customising the editor (see :link refid=custm reftype=hd.Customising:elink.).
.***
:h2 id=BM24.Printing
:p.To print the current document switch onto the command line and enter
the PRINT command.
No special facilities are provided for formatted printing, the PRINT
command will simply write a copy of the current document to the printer.
If used with no parameters PRINT will write to the device
:font facename=Courier size=0x0.PRN:font facename=default., which for most people will be the printer attached to
their machine.
If you have a serially attached printer or use a LAN printer you may
need to specify the printer device, for example&colon.
:xmp.
PRINT COM1
or PRINT LPT2
:exmp.
:p.
To print a piece of a document first mark the block of lines to be
printed, then use the PUT command to write them to a device.
A device must be specified with the PUT command, so normally you would
use&colon.
:xmp.
PUT PRN
:exmp.
.***
:h3 id=BM25.Printer Control Codes
:p.You may embed printer control codes directly in your documents if you
want to produce special effects such as bold or emphasised.
You will need to refer to your printer's documentation to determine
exactly which control codes are available and what they do.
:p.Control codes can normally be entered directly using the keypad on
the right of the keyboard&colon. hold down the Alt key and type the decimal
value of the required control code on the keypad then release the Alt
key.
The control code should appear at the cursor position, most control
codes show up on the screen as odd little symbols.
:p.Some codes can also be entered using other keys, but these will
require the use of the function :HP4.ESCAPE:EHP4. (Alt-X).
For example to enter a form feed (ASCII value 12) you can either use the
keypad method described above (hold down Alt, key 1 2 on the keypad and
release Alt), or press :HP4.ESCAPE:EHP4. (Alt-X) followed by Ctrl-L
("L" being the 12th letter of the alphabet).
.***
:h3 id=BM26.Printer Set Up
:p.You may prefer not to place the printer control codes directly in
the document, but to keep the document as plain, readable text.
But you may want to send a few special characters to the printer before
printing a document, perhaps to switch the printer to NLQ mode.
:p.These printer set up sequences can be issued with a :font facename=Courier size=0x0.DOS
ECHO:font facename=default. command, for example to put a Proprinter into NLQ mode issue
the following command&colon.
:xmp.
DOS ECHO xG >PRN
:exmp.
:p.
where the "x" should be an ASCII "Esc" control code entered
by hitting Alt-X followed by the Esc key.
.***
:h1 id=custm.Customising
:p.This section describes how you can customise :HP2.T:EHP2. to match
your own preferences for screen colours, keyboard layouts and special
settings.
Even if you like :HP2.T:EHP2. exactly the way it is supplied and don't
want to change any of the colours or keys, you will probably still need
to customise some of the special settings, at least to tell the editor
where you keep its help file.
:p.To customise :HP2.T:EHP2. you must first construct a :HP1.custom
definition file:EHP1., which is described in detail in the next section.
Then use the :font facename=Courier size=0x0.TKEY.EXE:font facename=default. customiser program to customise your
copy of the editor, by entering this command on the DOS or OS/2 command
line&colon.
:xmp.
TKEY custom.DEF editor.EXE
:exmp.
:p.
Replace ":font facename=Courier size=0x0.custom.DEF:font facename=default." with the name of your custom
definition file and replace ":font facename=Courier size=0x0.editor.EXE:font facename=default." with the name
the editor you want to customise.
Unless you tell it otherwise TKEY will assume the custom definition file
has an extension of :font facename=Courier size=0x0..DEF:font facename=default. and the editor of :font facename=Courier size=0x0..EXE:font facename=default..
So to customise both the DOS and the OS/2 versions with a custom
definition file called :font facename=Courier size=0x0.TCUST.DEF:font facename=default. you would use the two
commands&colon.
:xmp.
TKEY TCUST T
and TKEY TCUST T2
:exmp.
:p.
Once the customising is complete the changes are recorded permanently
inside the editor's .EXE file.
You no longer need either the TKEY program or your custom definition
file, unless you decide to make further changes.
.***
:h2 id=BM28.The Custom Definition File
:p.The custom definition file contains a description of the way you want
:HP2.T:EHP2. to be configured.
An example of a custom definition file is supplied with :HP2.T:EHP2.,
this is called :font facename=Courier size=0x0.TKEYS.DEF:font facename=default. and contains the description of the
default configuration.
This file serves as a good example of how to write a custom definition,
but should be used for reference only.
You should create your own custom definition file and call it something
other than :font facename=Courier size=0x0.TKEYS.DEF:font facename=default..
This will ensure that if you ever obtain a new copy the
:HP2.T:EHP2. package you do not lose any changes you made.
Of course a good way to start your own definition file would be to copy
:font facename=Courier size=0x0.TKEYS.DEF:font facename=default. under another name.
:p.The custom definition file contains four sorts of item.
Normally each item is placed on a new line, although one item can be
split over several lines or several items can be placed on one line if
desired.
:ol.
:li.Comments.
:p.Comments are ignored by the customiser program and serve to make the
definition file more readable.
Comments come in three flavours&colon.
:ol.
:li.Anything between the comment markers :font facename=Courier size=0x0./*:font facename=default. and
A full stop may be used as a quick abbreviation for the word DOS.
:p.If no ":font facename=Courier size=0x0.command:font facename=default." is given the DOS or OS/2 command line
prompt will appear.
You can return to :HP2.T:EHP2. by entering the command :font facename=Courier size=0x0.EXIT:font facename=default..
.***
:h2 id=BM39.EDIT
:xmp.
EDIT <filename>
or E <filename>
or T <filename>
:exmp.
:p.If a ":font facename=Courier size=0x0.filename:font facename=default." is given :HP2.T:EHP2. will switch
directly to display that document.
The file will be loaded from disk, if it is not already in the edit
ring.
:p.If no ":font facename=Courier size=0x0.filename:font facename=default." is given the next document in the
edit ring will be selected.
.***
:h2 id=BM40.FILE
:xmp.
FILE <filename>
or F <filename>
:exmp.
:p.The current document will be saved to disk and then removed from the
edit ring.
If a ":font facename=Courier size=0x0.filename:font facename=default." is given the document will be saved
under this name, otherwise the name shown on the status line will be
used.
.***
:h2 id=BM41.GET
:xmp.
GET filename
:exmp.
:p.The contents of ":font facename=Courier size=0x0.filename:font facename=default." will be inserted into the
current document following the current line.
.***
:h2 id=BM42.GOTO
:xmp.
GOTO linenum
or linenum
:exmp.
:p.Line number ":font facename=Courier size=0x0.linenum:font facename=default." will become the current line
and will be displayed on the focus line.
If ":font facename=Courier size=0x0.linenum:font facename=default." is bigger than the number of lines in the
document the last line will become the current line.
The word GOTO is optional, just entering the required
":font facename=Courier size=0x0.linenum:font facename=default." on the command line is sufficient.
.***
:h2 id=BM43.LOCATE
:xmp.
L /target</options>
or /target</options>
:exmp.
:p.The next occurrence of the text ":font facename=Courier size=0x0.target:font facename=default.", starting
from the current cursor position, will be located and displayed on the
focus line.
If the ":font facename=Courier size=0x0.L /target:font facename=default." form of the command is used the
delimiter, &odq.:font facename=Courier size=0x0./:font facename=default.&cdq., may be replaced by any character that
does not occur in ":font facename=Courier size=0x0.target:font facename=default.".
:p.Following a final delimiter any of these options may be used&colon.
:dl compact tsize=4..
:dt.m
:dd.to restrict the search to the marked lines only.
:dt.e
:dd.to force an exact-case match.
:dt.c
:dd.to force an any-case match.
(Apologies to non-English speakers&colon. only the 26 letters "a" to
"z" are correctly handled.)
:edl.
:Note.if neither :font facename=Courier size=0x0.e:font facename=default. nor :font facename=Courier size=0x0.c:font facename=default. is given the editor's
EXACT MATCH setting is used.
This may be customised - refer to :link refid=custm reftype=hd.Customising:elink. for more details.
.***
:h2 id=BM44.MARGIN
:xmp.
MARGIN column
or M column
:exmp.
:p.The right hand margin will be set to ":font facename=Courier size=0x0.column:font facename=default.".
To remove the right hand margin enter a column value of zero.
The margin column is displayed on the status line in the form "M
nnn".
:p.The margin is used by the word-spill features&colon. as words are typed
across the margin column they are automatically spilled onto the next
line.
It is also used by the :HP4.ADJUST LINE:EHP4. keyboard function (see
