home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 5 Edit
/
05-Edit.zip
/
sedit281.zip
/
sedit.hlp
< prev
next >
Wrap
Text File
|
1997-03-09
|
43KB
|
1,298 lines
<Product Info>
This is sedit, a professional programers
editor that is easy to use, completely
customizable and has just about everything
a programmer needs. Enjoy.
THIS PROGRAM WAS WRITTEN BY THOMAS W. STEINER
COPYRIGHT 1992 - 1997, ALL RIGHTS RESERVED
THERE IS NO WARRANTY OF ANY KIND. USE AT YOUR
OWN RISK. THIS IS NOT FREEWARE.
TO REGISTER YOUR COPY SEND \$25 TO
T.W. Steiner
2246 E. 6th Ave.
Vancouver, BC, V5N - 1R1
Canada
e-mail steiner@sfu.ca or
tsteiner@creo.bc.ca
<Help>
Select each menu item in the help menu to get an
overview of the program capabilities. Some important
user interface details that go beyond the standard
are discussed in the menu help item.
<Cursor Motion>
The cursor may be moved around with the following keys:
#4 -- left one space
#6 -- right one space
#8 -- up one line
#2 -- down one line
#1 -- end of line
#7 -- beginning of line
#3 -- scroll down one screen
#9 -- scroll up one screen
#T -- left one word
#V -- right one word
#X -- up five lines
#R -- down five lines
#Q -- end of file
#W -- beginning of file
#S -- end of file
#Y -- beginning of file
#q -- end of page
#w -- top of page
#s -- down half a page
#y -- up half a page
<Mouse>
The mouse may be used to position the cursor as an
alternative to using the keyboard. Click on the
desired text location. The text may be scrolled using
the scroll bars at the sides.
All three mouse buttons are used to mark regions of
text by dragging. The marking mode button assignments
are made in the editor configuration menu. If the edge
of the window is reached while dragging the display is
scrolled. The scroll speed is controlled by the
distance of the mouse pointer from the edge of the
window.
Double clicking on a word in a regular file causes
the editor to search for this word in an *.ndx file
and if found there starts up the info viewer. This is
useful in conjunction with function reference material
from compiler vendors. The path to *.ndx files is
specified in the editor configuration menu. Once set
up this enables context sensitive help on any
recognized word in the text.
Double clicking on a word in an "editsys.tmp" file causes
the editor to interpret that word as a file name and
loads that file. Integer numbers after the name if any
are interpreted as the line and column numbers
respectively. This is very convenient with the output
from a compiler invoked from the command line since the
output is added to the editor ring as a read only file.
<Menus>
The menus function in a somewhat non-standard way.
The standard ALT f file menu access has not been
implemented since these keys are used for direct
accelerators. However key board menu access is still
possible by using the ALT key by itself if this is
enabled in the editor configuration.
To get help on any menu item click on it using the
right rather than the left mouse button. This does
not work under versions of WNT previous to 4.0.
Almost every menu item has an associated accelerator
which may be mapped to any other key or keys. Note
that if the keys are re-mapped this mapping will
appear in the menus.
Since there are so many accelerator key definitions
the accelerators are case sensitive so look
carefully.
<Quit>
Exits from the currently displayed file. The next
file in the ring is displayed provided one exits. If
no other files are loaded the editor itself quits.
The number of loaded files is reported in the title
bar along with the current file name. If the file has
been modified a confirm dialog will be shown. To exit
from all the files and terminate the editor use the
"close" (or Alt F4) from the system menu.
The default accelerator is Ctrl q mapped to ^Q
<Save>
The editor writes the currently displayed file to
disk using the current name and path. If a newer file
of the same name exist then a confirm dialog will be
displayed. Before over writing a file with the same name
the editor will rename the previous file to
'editfile.bak'. Thus one previous version will always be
on the disk in case a file was accidentally written. The
next write of any file however will create a new
'editfile.bak'
The default accelerator is Ctrl w mapped to ^W
<Save As...>
The editor saves the currently displayed file to disk
using the specified name and path. A standard file
dialog is opened so that a filename can be typed or
chosen.
The default accelerator is Ctrl W mapped to ^w
<Save All Changed>
All files loaded that have had changes made to them
are saved to disk.
The default accelerator is Ctrl A mapped to ^a
<Open...>
A standard file dialog is displayed which allows
selection of a file to be edited. A wild card '*' in
the name will load all matching files. Files may also
be loaded from the command line by typing
'^[ e yourfile.name ^M'.
The default accelerator is Ctrl O mapped to ^o
<Next>
The next file in the ring of loaded files is displayed.
The default accelerator is Ctrl n mapped to ^N
<Prev>
The previous file in the ring of loaded files is
displayed.
The default accelerator is Ctrl p mapped to ^P
<Other...>
Opens a list box dialog which displays a list of all
the files currently loaded. A file to be displayed
may be selected by double clicking on the chosen
filename. Changed files have the word changed
appended to the file name.
The default accelerator is Ctrl H mapped to ^h
<Config...>
Opens the editor configuration notebook. Many editor
preferences such as the colours may be set. The
results are saved in the ASCII file editor.cfg so
that the next time the editor starts it will use the
selected configuration. If multiple editor instances
are started only the first one will write the
editor.cfg file.
The default accelerator is Ctrl C mapped to ^c
<Cmd...>
Opens a command line dialog. Commands to the
operating system as well as editor command line
commands may be entered. The list box displays a
history of the recently used command line commands
for reuse by double clicking on them. Command line
commands may also be entered without opening this
dialog by hitting the ^[ key. The editor command line
commands are as follows:
The default accelerator is Ctrl M mapped to ^m
Command Line Operations
^[ goto or leave command line
Change current line.
number goto line number n
+number down n lines
-number up n lines
Change current column offset.
@number start at column n
@+number scroll left n columns
@-number scroll right n columns
Search and Replace.
/str1[/-bclrw]
find string str (/ may instead be other punct)
c/str1/str2[/-bclrw] replace str1 with str2
The optional search suffixes are
/- search up (down is the default)
/b search marked block only
/c ignore case
/l loop through all loaded files
/r interpret as regular expression
/w match whole words only
For regular expressions the following symbols have
special meaning:
^ start of line
\$ end of line
. any character
\\ literal next character
+ match one or more times
* match zero or more times
[aei0-9] match a,e,i and 0 through 9
[\^aei0-9] match anything but a,e,i and 0 through 9
( ) sub expression
a(ab)*b matches ab aabb aababb aabababb etc.
loading additional files to edit
e name1,name2,...[-brfl]
edit name1,name2,...[-brfl]
The optional edit suffixes are
-b binary mode
-r read only
-f num first line is line number num (-r implied)
-l num last line is line number num (-r implied)
cfg or configure show and modify editor config
quit exit without saving changes
m [name] or insert named file at cur location
merge [name]
r [name] or rename current file to name
rename [name]
d [name] or diff between current and named file
diff [name] diff between current and named file
up arrow previous command line entered
down arrow next command line entered
fill [string] fill B marked block with string
sort [col] sort lines using field col as key
hex [num] or hex 'c' convert decimal num or char to hex
dec [num] or dec 'c' convert hex num or char to decimal
asc [num] convert hex or dec number to char
g [regexp] or passed to OS but regexp becomes
grep [regexp] new search string
cd [y:\path] set default drive and path
os [command] send command to operating system
[command] sent to operating system
The results of the above operating system calls will
end up in a temp file in the ring of files. There is
a difference between the above two methods. When a
command is prefixed by "os" the command runs
synchronously i.e. the editor is blocked until the os
command completes. If the "os" prefix is absent the
system call runs in back ground. This is useful for
compiling code or doing long searches in background
for example.
Lastly, any string that is sent to the operating system
will first have any occurrence of \$EDNAME translated to
the current filename. In this way a generic macro that
does an os call may be built.
<Delete Character>
Deletes the character under the cursor.
The default accelerator is Ctrl d mapped to ^D
<Delete Prev Char>
Deletes the character to the left of the cursor. If
the cursor is at the start of a line it will join the
current line to the previous line.
The default accelerator is Backspace mapped to ^H
<Delete Word>
Deletes all characters under and to the right of the
cursor up to the next space or punctuation.
The default accelerator is Ctrl z mapped to ^Z
<Delete to Line end>
Deletes all characters under and to the right of the
cursor up to the end of the line.
The default accelerator is Ctrl e mapped to ^E
<Delete Line>
Deletes the entire current line.
The default accelerator is Ctrl Back mapped to ^?
<Insert New Line>
The behaviour of this command is dependent on the
'conventional return' configuration setting. If
conventional return is on then the current line is
split at the cursor and the remainder is put on the
next line. If however, conventional return is not
enabled then this command inserts a blank line below
the current line leaving the current line intact.
This behaviour is compatible with the 'e' series of
editors.
The default accelerator is Enter mapped to ^M
<Change Char Case>
Changes the case of the character under the cursor.
The default accelerator is Ctrl c mapped to ^C
<Swap two Chars>
Swaps the character under the cursor with the one
to the right of the cursor.
The default accelerator is Ctrl s mapped to ^S
<Insert Ctrl Char>
This command starts a dialog for entering the 3 digit
ASCII code of a character to be inserted in the text.
This is useful for inputing characters without a key
board key.
The default accelerator is Alt x mapped to %X
<Insert Literal Char>
This is only active if key mapping is turned on in
the editor configuration menu. If it is turned on
then this command will for the next key stroke
disable the translation so that the original
functionality may be accessed.
The default accelerator is Alt k mapped to %K
<Cut Line at Cursor>
This command splits the current line at the cursor
putting the remainder of current line on the next
line. Similar to Insert New Line if conventional
return is enabled. Used to split lines if
conventional return is not enabled.
The default accelerator is Ctrl k mapped to ^K
<Join two Lines>
This command joins the next line to the end of the
current line.
The default accelerator is Ctrl j mapped to ^J
<Toggle Ins/Del>
This command toggles the character insertion mode
between insertion and replacement. The current status
is reported on the right end of the status line.
The default accelerator is Ctrl t mapped to ^T
<Undo>
The last changes to a line or block of lines are
restored. The number of undo levels are essentially
unlimited but can be optionally disabled in the editor
configuration menu.
The default accelerator is Ctrl u mapped to ^U
<Redo>
Steps undone with the undo command can be redone with
this command.
The default accelerator is Ctrl r mapped to ^R
<Restore Current Line>
If the undo record for the current line is of the
line change type then the line can be restored to its
previous state using this command. The difference
between this command and undo is that this command
can restore a line in some cases without having to
undo changes made after the current line was
modified.
The default accelerator is Alt q mapped to %Q
<Reflow Paragraph>
This command has two different modes of operation. If
syntax colouring is not on then this command
reformats a paragraph of text using the margins and
indentation specified in the editor configuration
notebook. The reformatting starts at the current line
and ends at the first blank line. Alternatively a
block mark may be set to specify the margins and text
to reflow.
If syntax colouring is on then it is assumed that the
text is C code and it is reformatted with smart
indentation At this point the rules are not
configurable and may not suit everyone's taste. This
feature is also not yet complete.
The default accelerator is Alt r mapped to %R
<Reflow Code>
This command has two different modes of operation. If
syntax colouring is not on then this command
reformats a paragraph of text using the margins and
indentation specified in the editor configuration
notebook. The reformatting starts at the current line
and ends at the first blank line. Alternatively a
block mark may be set to specify the margins and text
to reflow.
If syntax colouring is on then it is assumed that the
text is C code and it is reformatted with smart
indentation At this point the rules are not
configurable and may not suit everyone's taste. This
feature is also not yet complete.
The default accelerator is Alt r mapped to %R
<Reflow Block>
This command has two different modes of operation. If
syntax colouring is not on then this command
reformats a paragraph of text using the margins and
indentation specified in the editor configuration
notebook. The reformatting starts at the current line
and ends at the first blank line. Alternatively a
block mark may be set to specify the margins and text
to reflow.
If syntax colouring is on then it is assumed that the
text is C code and it is reformatted with smart
indentation At this point the rules are not
configurable and may not suit everyone's taste. This
feature is also not yet complete.
The default accelerator is Alt r mapped to %R
<First Column Lines>
This command folds up the current file so that only
those lines starting in the first column are visible.
This is useful for rapidly locating functions in a
file. If the file is already folded then this command
unfolds the file around the line current line.
The default accelerator is Ctrl v mapped to ^V
<Lines with Search String>
This command folds up the current file so that only
those lines containing the last used search string
are visible. If the file is already folded then this
command unfolds the file around the line current
line.
The default accelerator is Alt s mapped to %S
<Changed Lines>
This command folds up the current file so that only
those lines which have been modified since the last
save are visible. If the file is already folded then
this command unfolds the file around the line current
line.
The default accelerator is Alt v mapped to %V
<Lines with Placemark>
This command folds up the current file so that only
those lines which contain a placemark are visible. If
the file is already folded then this command unfolds
the file around the line current line.
The default accelerator is Alt h mapped to %H
<Tagged Foldup>
This command folds up the current file so that the
lines between the numerically greatest remaining fold
tag and the next fold tag are hidden. The fold tag is
a regular expression set in the editor configuration
dialog and should be picked to be a comment in the
language in use. For example the default regular
fold tag expression is //[ ]*L[0-9]+ which is a comment
in C++. This will match // L1 and // L21 for example.
The number represents the fold level.
Tagged foldup is the only folding mode that requires
special entries in the file. However, a file written
with folding in mind can make use of these tags to
selectively hide details to present an overview.
The default accelerator is Alt - mapped to %-
<Tagged Unfold>
Unfolds previously folded text by one level if folded
by tagged foldup. If folded in another mode the file
is completely unfolded. The file is unfolded around the
current line.
The default accelerator is Alt + mapped to %+
<Tabbed Foldup>
This command folds up the current file so that the
most indented text which remains visible is hidden.
This provides a means of hiding the details of a
large switch() for example to get an overview.
The default accelerator is Ctrl - mapped to ^-
<Tabbed Unfold>
Unfolds previously folded text by one level if folded
by tabbed foldup. If folded in another mode the file
is completely unfolded. The file is unfolded around the
current line.
The default accelerator is Ctrl + mapped to ^+
<Split Screen>
The screen is split into an upper and lower half each
of which can show the same or a different file. If the
screen is already split then it is un split.
The default accelerator is Ctrl y mapped to ^Y
<Unsplit Screen>
The screen is split into an upper and lower half each
of which can show the same or a different file. If the
screen is already split then it is un split.
The default accelerator is Ctrl y mapped to ^Y
<Other Split Half>
This command is only active if the screen is split in
which case it moves the cursor to the other split half.
It is also possible to click with the mouse to select
the other half.
The default accelerator is Ctrl o mapped to ^O.
<Alternate Binary Rep>
If the file being edited is a binary file then this
command switches from the hex representation to a text
and control key representation.
The default accelerator is Alt a mapped to %A.
<Hex Binary Rep>
If the file being edited is a binary file then this
command switches from the hex representation to a text
and control key representation.
The default accelerator is Alt a mapped to %A.
<Normal Mark>
This is the industry standard mode of text marking which
is of more use with standard text than with program code.
Use this command to mark the start and end of a region. A
region may start in the middle of a line extend over
several lines and end in the middle of a line.
The default accelerator is Alt n mapped to %N.
<Unmark>
Unmark any text marked in any one of the three marking
modes.
The default accelerator is Alt u mapped to %U.
<Delete Region>
This deletes a region marked in any one of the three
marking modes.
The default accelerator is Alt d mapped to %D.
<Move Region>
This moves a region marked in any one of the three
marking modes to the location in the same or different
file specified by the current cursor location.
The default accelerator is Alt m mapped to %M.
<Copy Region>
This copies a region marked in any one of the three
marking modes to the location in the same or different
file specified by the current cursor location.
The default accelerator is Alt c mapped to %C.
<Yank Back Last Del>
The last region deleted can be restored once or many
times using this command. The last deleted text is
inserted at the current cursor location in the same
or different file. Note that the text may be brought
back in any location so that this provides a means
of moving text in a method conceptually similar to
using a clip board.
The default accelerator is Alt y mapped to %Y.
<Write Region>
The currently marked region is written to a temp
disk file with name 'editblck.tmp' in the current
directory.
The default accelerator is Alt w mapped to %W.
<Mark Lines>
This is the preferred marking mode for program
text. Only whole lines are marked and line marked
text when inserted on a copy does not split the
current line as in normal marked case but inserts
the marked lines below the current line.
The default accelerator is Alt l mapped to %L.
<Justify>
This command left adjusts the current line with the
first non-blank line above and then moves the cursor
down to the next line. As a special case if the last
operation was a marked region move or copy then the
whole block is shifted left or right as necessary
to left adjust the first line.
The default accelerator is Alt j mapped to %J.
<Mark Rect Block>
This command is used to mark a rectangular block
for column manipulations.
The default accelerator is Alt b mapped to %B.
<Fill Rect>
A previously marked rectangle may be filled with
a single character. To fill with a word use the
command line command 'fill xyz'. Alternatively,
this command may be used to change the case of
all the characters in the marked block. Lastly,
this command may be used to fill with a sequence
of incrementing or decrementing numbers starting
with the number found at the top of the block
marked region region.
The default accelerator is Alt f mapped to %F.
<Overlay Rect>
The block marked region is used to overwrite a
same sized region the top left corner of which
is specified by the current cursor location.
The default accelerator is Alt o mapped to %O.
<Move Rect Left>
A block marked region may be moved to the left
by one space with this command. The contents of
the column to the left of the block is deleted.
The text to the right of the marked block moves
with the text. This command is useful for adjusting
the indentation of a section.
The default accelerator is Alt Left mapped to #t.
<Move Rect Right>
A block marked region may be moved to the right
by one space with this command. The text to the
right of the marked block moves with the text.
This command is useful for adjusting the indentation
of a section.
The default accelerator is Alt Right mapped to #v.
A block marked region may be shifted to the left
by one space with this command. The contents of
the left most column of the block is deleted and
the width of the block shrunk by one
The text to the right of the marked block moves
with the text. This command is useful for adjusting
the indentation of a section.
The default accelerator is Alt Left mapped to #t.
<Move Rect Up>
A block marked region may be moved up by one line
with this command. The contents of the line above
the block is split to accommodate the block.
The default accelerator is Alt Up mapped to #x.
<Move Rect Down>
A block marked region may be moved down by one line
with this command. The contents of the line below
the block is split to accommodate the block.
The default accelerator is Alt Down mapped to #x.
<Shift Rect Left>
A block marked region may be shifted to the left
by one space with this command. The left most column
of the block is deleted and the marked region's width
is reduced by one provided the width of the column is
wider than one. If not the block width stays at one and
a new column is shifted in from the right. Text to the
right of the marked block shift with the text in the
block. This command is useful for adjusting
the indentation of a section.
The default accelerator is Ctrl ^ mapped to ^^.
<Shift Rect Right>
The text in block marked region may be shifted to the
right by one space with this command. The right most
column of the block is filled with spaces Text to the
right of the marked block shift with the text in the
block. This command is useful for adjusting
the indentation of a section.
The default accelerator is Ctrl _ mapped to ^_.
<Copy to Clipboard>
This command copies a region marked in any one of the
three marking modes to the system clip board.
The default accelerator is Ctrl ins mapped to #P.
<Paste from Clipbrd>
This inserts lines of text from the system clipboard
below the current line.
The default accelerator is Shift Ins mapped to #a.
<Copy to Clip and Del>
This command copies and deleted a region marked in any
one of the three marking modes to the system clip board.
The default accelerator is Shift Del mapped to #d.
<Set Placemark>
This command sets a placemark on the current line if
there is not already a placemark otherwise it removes
the place mark.
The default accelerator is Ctrl a mapped to ^A.
<Clear Placemark>
This command sets a placemark on the current line if
there is not already a placemark otherwise it removes
the place mark.
The default accelerator is Ctrl a mapped to ^A.
<Goto Last Place>
This command moves the cursor to the next location
marked by a previously set placemark.
The default accelerator is Ctrl l mapped to ^L.
<Clear Placemarks>
This command clears all previously set placemarks.
The default accelerator is Alt i mapped to %I.
<Goto Last Pos>
This command returns the cursor to the line it was on
previously. This command is useful in case the cursor
was accidentally removed from the region of interest
with an unintended search for example.
The default accelerator is Alt p mapped to %P.
<Match Bracket>
This command moves the cursor to the location matching
the bracket or comment start underneath the cursor.
Note that the cursor must currently be positioned on a
bracket or comment delimiter.
The default accelerator is Ctrl b mapped to ^B.
<Goto Line Num>
This command opens a dialog for entering the line number
of the desired current line. There is also a command
line equivalent which is:
^[ nnn Enter
<Start Macro Learn>
This command starts or ends the recording of keystrokes
for a macro. At the end of macro recording it may be
optionally bound to a function key for preservation
between editing sessions. Otherwise it will be stored
for re-execution with the Exec Last Macro command until
the end of the current editing session unless over
written by another recorded macro.
Macros can be used together with command multiplication
to carry out repetitive complex editing tasks.
The default accelerator is Alt t mapped to %T.
<Stop Macro Learn>
This command starts or ends the recording of keystrokes
for a macro. At the end of macro recording it may be
optionally bound to a function key for preservation
between editing sessions. Otherwise it will be stored
for re-execution with the Exec Last Macro command until
the end of the current editing session unless over
written by another recorded macro.
Macros can be used together with command multiplication
to carry out repetitive complex editing tasks.
The default accelerator is Alt t mapped to %T.
<Exec Last Macro>
This command executes the last recorded macro. Bound
macros are executed by hitting the corresponding
function key.
The default accelerator is Alt e mapped to %E.
<Zero Cmnd Mult>
This command is used re set a previously entered
command multiplier to zero,
The default accelerator is Alt z mapped to %Z.
<Cmnd Multiplier>
This command opens a dialog to enter a command
multiplier. Command multiplication is very useful in
conjunction with recorded macros for executing complex
repetitive editing tasks. The default accelerators are:
Alt 0 to Alt 9 mapped to %0 to %9.
<Find...>
This command opens the search dialog used to enter the
search string and search options. Search options are:
search up (down is the default)
search marked block only
ignore case
loop through all loaded files
interpret as regular expression
match whole words only
For regular expressions the following symbols have
special meaning:
^ start of line
\$ end of line
. any character
\\ literal next character
+ match one or more times
* match zero or more times
[aei0-9] match a,e,i and 0 through 9
[\^aei0-9] match anything but a,e,i and 0 through 9
( ) sub expression
a(ab)*b matches ab aabb aababb aabababb etc.
The default accelerator is CTRL S mapped to ^s.
<Replace...>
This command opens the search and replace dialog used to
enter the search and replace strings as well as the
search options. Search options are:
search up (down is the default)
search marked block only
ignore case
loop through all loaded files
interpret as regular expression
match whole words only
For regular expressions the following symbols have
special meaning:
^ start of line
\$ end of line
. any character
\\ literal next character
+ match one or more times
* match zero or more times
[aei0-9] match a,e,i and 0 through 9
[\^aei0-9] match anything but a,e,i and 0 through 9
( ) sub expression
a(ab)*b matches ab aabb aababb aabababb etc.
The default accelerator is CTRL R mapped to ^r.
<Find Next>
This command uses the last set search string and option
to find the next match.
The default accelerator is CTRL f mapped to ^F.
<Reverse and Find>
This command uses the last set search string and option
to find the next match after toggling the current
search direction
The default accelerator is CTRL F mapped to ^f.
<Find Next Cur Word>
This command uses the word under the cursor as the
temporary search string and finds the next such match.
The default accelerator is Alt * mapped to %*.
<Find Prev Cur Word>
This command uses the word under the cursor as the
temporary search string and finds the previous such
match.
The default accelerator is Alt / mapped to %/.
<Margins>
The entry fields in this dialog are used to set the text
margins. The left, right and indent values are used by
the reflow (edit menu) command to reformat a paragraph if
the editor is in text mode (syntax colouring not on). If
right justify is on then the reflow command will also
introduce spaces in the line so that the right margin
lines up as well.
If auto wrap is on then once the cursor goes past the
right margin setting then a new line is started. If auto
indent is on then the cursor is positioned so that the
left edge of the new line lines up with the previous
line. For programming it is best to have auto warp off
and auto indent on while for plain text auto wrap should
be on and auto indent off.
The tab size entry field determines the number of spaces
per tab setting. If tab compression is turned on then
this value is used as the number of spaces corresponding
to one tab when reading or writing a file unless the
default I/O tab size is also on in which case this value
is 8.
<Miscellaneous>
The undo entry field allows setting the maximum number of
undo records saved in memory. The default setting is
30000 which is essentially unlimited for normal editing
tasks. The editor relies on the undo records for some
internal operations so do not change this except in the
following circumstance. If the editor is being used to do
column manipulation of very long columns then the memory
usage by the undo mechanism gets very high and much
better performance is attained by turning undo off by
entering a zero value.
Conventional return. If this is on then hitting the Enter
or Return key splits the current line at the cursor as is
the case for most editors. If, however, conventional return
is not on then hitting Enter will insert a new line below
the current line while leaving the current line unchanged.
This is the standard mode of operation for many of IBM's
editors. This mode may take some getting used to but is
really very nice for programming since a new line can be
started without always having to go to the end of the
current line.
Overwrite Warning. If this is on then you will be warned
before a file of the same name is over written.
Error Beep. If this is on then the editor will beep when
an error occurs as well as pop up the error dialog.
Tab Compress. If this is on then when the editor writes
a file to disk a sequence of n spaces is replaced instead
with a tab character. This reduces the size of a saved
file a bit but is not recommended since the formatting
of a file can be corrupted if multiple people are working
on a file and using different values of n. It is however
the only way to get an explicit tab character in a saved
file in text mode. This is necessary for example with
UNIX make files. The value of n is determined by the
tab size entry field in the margins dialog except if the
default I/O tab size check box is also checked in which
case n is 8. When reading a file tabs are always replaced
with n spaces regardless of the setting of the tab
compress check box.
Key Map. If this is on then the associated editkey.map
file is read to redefine the actions of the specified
keys. If exclusive map is also on then only mapped keys
are active so this is only useful if a complete set of
keys necessary for editor operation are mapped.
Alt menu bar access. If this is on the menu bar may be
accessed from the key board by hitting the ALT key by
itself. The only reason for turning it off is that
sometimes this happens accidentally and it is not always
immediately obvious why the editor is not responding as
expected. Thus if you only access the menus with the
mouse turn it off.
<Colours>
The entry fields in this dialog are used to select the
text colours for both the main window and the command
line. The colours for syntax colouring are selected in
the syntax colouring dialog.
<Font>
This dialog is used to select a font for the editor. Only
mono spaced, image fonts are available.
<Mouse Buttons>
These entry fields are used to assign one of the three
marking modes to a mouse button so that a region may be
marked by dragging with the mouse. An existing region is
expanded by holding the Control key down while dragging.
If the edge of the window is reached while dragging to
mark a region the display is scrolled if possible. The
scroll speed is controlled by the distance of the mouse
pointer from the edge of the window.
Regions may also be marked from the key board by
positioning the cursor at the start, hitting the
appropriate marking key, moving to the end and hitting the
key again (See mark menu).
A region may also be marked in the normal mode by holding
the shift key down and moving the cursor.
<Syntax Colour>
Syntax colouring is enabled by clicking on the check box.
The bracket matching component may be separately enabled
with the other check box. The colours for the identified
elements is set with the colour entry fields. The
delimiters for line comments and/or comment start, end
are set with the entry fields at the bottom. There are
also entry fields for setting the escape or next
character literal delimiter and one for preprocessor
directives. The default values are for C/C++ but by
editing these syntax colouring may be used with other
languages.
With syntax colouring on the reflow command in the editor
menu reflow using fixed formatting rules for C code
rather than re flowing in text mode. These rules are not
yet configurable.
Syntax colouring requires significantly more from the processor
and hence may cause the editor to be unacceptably slow on
some systems. In this case turn syntax colouring off.
<Strings>
In this dialog the path to be used to find *.ndx files
may be specified. Ndx files contain information that
allows a key word to be used to start the info viewer on
that topic. These index files and corresponding *.inf
files are often supplied by compiler vendors. Once set up
this allows double clicking on a word in a file and
having help on this item pop up. Note that double
clicking in this fashion only works on files that are not
read only otherwise the word under the cursor is
interpreted as a file name to be loaded.
The second string is the fold tag used by the tagged
folding mechanism. See help for tagged folding.
<Macro List>
This command causes all the currently defined macros to
be listed. They may then also be edited using plain
english although the easiest method of creating a macro
is to use the key stroke recording menu item. In order to
activate any changes to this list use the macro read
command. Note that not all the function keys are actually
available depending on the implementation. For example
under OS/2 the Alt F4 key is the quit application system
key and is trapped before ever reaching the editor's
message queue. Hence these keys are unavailable despite
appearing in the list.
Note also that the macro keys must be specified in terms
of the un-mapped key strokes even if key mapping is on.
The default accelerator is Ctrl L mapped to ^l
The format of macro definitions is as follows: A function
key name such as Shift F3 is followed by an arrow (->)
and then a list of up to 128 key names each separated by
a space. Key names may have a modifier in front of it
again separated from the key name by a space. The
available modifiers are Ctrl, Alt and Shift. Key names
are any letter, punctuation or number or function key
name as in F3. Additionally, the following special key
names and combinations are also recognized.
Ctrl Back
Enter
Backspace
Tab
Esc
Shift Tab
Home
Up
PgUp
left
KeyCenter
Right
End
Down
PgDn
Ins
Del
Ctrl Ins
Ctrl Del
Ctrl Left
Ctrl Right
Ctrl Home
Ctrl Pgdn
Ctrl End
Ctrl Pgup
Ctrl Up
Ctrl Down
Alt Up
Alt Left
Alt Right
Alt Down
Alt Home
Alt End
Alt PgUp
Alt PgDn
Alt Del
Alt Ins
Shift Ins
Shift Del
Shift Home
Shift Pgdn
Shift End
Shift Pgup
Shift Left
Shift Right
Shift Up
Shift Down
Alt Back
Alt Enter
Shift Enter
Ctrl Enter
Alt Tab
Ctrl Tab
Ctrl Break
Space
<Macro Read>
This command causes all the currently listed macros to be
read so that they become active. To list the current
macro definitions use the macro list command. The macro
definitions in the list may be edited using plain english
although the easiest method of creating a macro is to use
the key stroke recording menu item. Note that not all the
function keys are actually available depending on the
implementation. For example under OS/2 the Alt F4 key is
the quit application system key and is trapped before
ever reaching the editor's message queue. Hence these
keys are unavailable despite appearing in the list.
Note also that the macro keys must be specified in terms
of the un-mapped key strokes even if key mapping is on.
For a description of the macro definition format consult
the help for the macro list command.
The default accelerator is Ctrl D mapped to ^d
<Keymap List>
This command causes all the currently defined key
mappings to be listed. They may then also be edited using
plain english. In order to interpret any changes to the
list use the Keymap Read command after editing the list.
In order for this command to be active key mapping must
be enabled in the editor configuration notebook.
The default accelerator is Ctrl K mapped to ^k
The format of key map definitions is as follows: A list
of key names (eg. Ctrl K Ctrl D) each separated by a
space followed by an arrow (->) and then the name of the
default key equivalent which is in all cases a single,
possibly modified, key. As a special case the key map on
key ^\, if mapped, must be last in the list and is
never un mapped provided mapping itself is enabled in
the configuration notebook. These keys are required
for emulating a modal editor such as vi.
Key names may have a modifier in front of it again
separated from the key name by a space. The available
modifiers are Ctrl, Alt and Shift. Key names are any
letter, punctuation or number or function key name as
in F3. Additionally, the following special key names
and combinations are also recognized.
Ctrl Back
Enter
Backspace
Tab
Esc
Shift Tab
Home
Up
PgUp
left
KeyCenter
Right
End
Down
PgDn
Ins
Del
Ctrl Ins
Ctrl Del
Ctrl Left
Ctrl Right
Ctrl Home
Ctrl Pgdn
Ctrl End
Ctrl Pgup
Ctrl Up
Ctrl Down
Alt Up
Alt Left
Alt Right
Alt Down
Alt Home
Alt End
Alt PgUp
Alt PgDn
Alt Del
Alt Ins
Shift Ins
Shift Del
Shift Home
Shift Pgdn
Shift End
Shift Pgup
Shift Left
Shift Right
Shift Up
Shift Down
Alt Back
Alt Enter
Shift Enter
Ctrl Enter
Alt Tab
Ctrl Tab
Ctrl Break
Space
<Keymap Read>
This command reads the currently displayed key mappings.
To list the current key mappings use the Keymap list
command. The mappings may be edited before reading.
In order for this command to be active key mapping
must be enabled in the editor configuration notebook.
For details on the key definition format consult the
help for Keymap List
The default accelerator is Ctrl Y mapped to ^y
<Keymap On>
Turns key mapping on if currently off. This command is
only available if key mapping is enabled in the editor
configuration dialog. Note that if this key is mapped
to another key it must be the last key in the mapping
list and then this key is always mapped so that
key mapping can be turned on again.
<Keymap Off>
Turn key mapping off if currently on. This command is
only available if key mapping is enabled in the editor
configuration dialog.