═══ 1. EPM Product Help ═══
EPM is a text editor you can use to create and edit your text files. It enables
you to work on multiple files at the same time.
EPM begins with an empty edit window that you can enter text into beginning at
the cursor location. After you have completed typing in your text:
1. Select File.
2. Select Save as.
3. Type a filename.
EPM has a number of features. For details, select from the list below:
o Starting EPM from an OS/2 command prompt
o EPM Features
o Marking/Selecting text
o Issuing editor commands
o Recording keystrokes
o Configuring the mouse
o Direct file manipulation
o Stream versus line mode editing
o Rexx macros
o Edit ring
o Toolbar
═══ 2. EPM Features ═══
This section lists a number of EPM features which have been included in EPM for
a while, but which might not be known to some users.
1. Ring support - any number of files can be loaded into an edit window.
2. Host file editing - enter the command:
e ha:profile exec a
to edit your PROFILE EXEC on your VM host. The EDIT, NAME, SAVE, FILE and
GET commands all handle host filenames (both VM and MVS).
3. Passing commands - EPM commands can be passed to the editor from the
command line, intermixed with filenames.
4. Edit shell - EPM can create a shell window in which you can enter OS/2
commands and have the output entered in the window - even while you edit a
different file in the ring.
5. Sort - EPM can sort text.
6. Math functions - EPM can function as a calculator. You can enter an
expression on the EPM command line and have EPM evaluate it for you (e.g.,
math 5 * (213 + 961) ), or mark a column of numbers and have EPM add or
multiply them.
7. GREP - this is a Search option that lets you perform searches using regular
expressions, a powerful feature that lets you search for patterns in
addition to specific strings.
8. Keyboard macros - you can record a sequence of keystrokes using Ctrl+R at
the start and end, then play them back using Ctrl+T to easily perform
repetitive operations.
9. Keyword help - if you have the OS/2 2.x toolkit and/or the IBM C compiler,
and have your system set up properly, by placing the cursor on a C keyword,
C function, or OS/2 function call and pressing Ctrl+H, you will be
presented with help for the becursored word. This capability is driven by
an index file (by default, EPMKWHLP.NDX). You can easily create an index
file that performs other actions for your own purposes.
10. DIR support - if you enter a DIR command on an EPM command line, the output
will go into a separate file. If you then place the cursor on a file in
the directory listing and press Alt+1, the file will be loaded. (If you
press the cursor on a directory, a DIR will be issued for that directory.)
11. Workframe integration - EPM supports drag&drop of files and error messages
from the IBM Workframe/2.
12. Rexx profile - EPM has the ability to execute a Rexx profile every time an
edit window is opened, allowing you to configure the window to your liking.
13. Bracket matching - place the cursor on a bracket, brace, parenthesis or
angle bracket and press Ctrl+bracket, and the cursor will be moved to the
matching open or close bracket (taking nesting into account).
Next, a (partial) list of new features that EPM 6.0x has:
1. long lines - 5.51 supports up to 255 characters per line. EPM 6.0x
supports lines up to 1600 bytes, but in effect supports unlimited length
lines because longer lines will be broken into 1600-byte pieces, which will
be glued back together when the file is saved.
2. drag&drop - of files and marked text between edit windows, or edit window
and desktop. Also supports drop of fonts, colors, and bitmaps.
3. fast sort - much faster than 5.51, with no limit on amount that can be
sorted.
4. proof - much faster performance than 5.51, with a new, custom dialog.
5. extended GREP (including subexpression replacement for Change command) -
adds alternation, grouping, and macros (e.g., :o = optional whitespace; :q
= quoted string) to the standard GREP search.
6. TAGS support - Can build a tags file listing all functions defined in your
program, then place the cursor on a function and automatically jump to the
file and position where that function is defined.
7. user-configurable toolbar - a button-bar that users can easily configure to
add new functions to the editor. A very simple toolbar is presented by
default, but a large number of defined toobar action items and bitmaps are
supplied. In addition, a "Programmer's Toolbar" is provided which can be
imported and used.
8. multiple views of a file within an edit window.
9. pop-up menus (context menus).
10. Tree support (Fileman-like functionality) - create a tree listing of all
matching files on one or more drives, sort by any attribute, apply commands
to all or marked files.
11. large .ex files - more efficient, and no more 64k size limit.
12. dynamic spell checking - optionally have words spell-checked as you type
them in, with a beep and message if a word is misspelled.
13. voice recognition - dictation (IPDS) support.
14. keyword hilighting - support included for C, E, HTML, Rexx, IPF, Java,
Perl, RC, Rexx, Script, and TeX files; other languages can easily be added
by the user.
15. binary editing - loading a file in binary lets the user edit the CR, LF,
etc.
16. Enhanced bracket matching - can match #if / #else / #endif for C, COMPILE
IF / COMPILE ELSE / COMPILE ENDIF for E, :ol., :eol., etc., for GML tags,
/* and */ for comments, and SGML tags, as well as the single-character
brackets supported by version 5.51.
17. Save ring as desktop object - can save the contents of the edit ring as a
desktop object. Opening that object will load all files that were
originally in the ring, with the cursor at the original position in each
file.
18. Negated searching - can search for a line not containing a specified
string.
19. Word search - can search for a string as a word, rather than just as a
substring. Also useful for searching for 1-letter variable names without
getting lots of false hits.
20. Case-match option for Change command - will match the case (all caps, all
lower-case, initial cap, etc.) of each "hit" as it makes each change.
═══ 3. EPM Keys Help ═══
The key definitions for the EPM editor are divided into three groups: Function
Keys, which you use use to work with files and display help; Edit Window Keys,
which you use to move the cursor in the edit window; and Editing Keys, which
you use to display text editor keys.
For key definitions in each of these groups, select from the list below:
o Standard function keys
o EPM edit window keys
o EPM editing keys
═══ 3.1. Standard Function Keys ═══
F1
Displays help.
F2
Saves the current file.
F3
Exits the current file.
F4
Saves the current file.
F5
Opens a new edit window.
F6
Draws in the current file.
F7
Renames the current file.
F8
Edits a file.
F9
Undo.
F10
Switches between the menu bar and the file being edited.
F11
Switches to the previous file in the edit ring.
F12
Switches to the next file in the edit ring.
═══ 3.2. Edit Window Keys ═══
Alt+F4
Closes the edit window.
Alt+F7
Moves the edit window.
Alt+F8
Sizes the edit window.
Alt+F9
Minimizes the edit window.
Alt+F10
Maximizes the edit window.
Shift+F1
Scrolls the screen left one column.
Shift+F2
Scrolls the screen right one column.
Shift+F3
Scrolls the screen down one row.
Shift+F4
Scrolls the screen up one row.
Shift+F5
Scrolls the screen so that the line at the current cursor position is
vertically centered.
End
Moves the cursor to the end of the line.
Home
Moves the cursor to the beginning of the line.
PgDn
Moves the line at the current cursor position forward (down) one
screen.
PgUp
Moves the line at the current cursor position backward (up) one
screen.
Tab
Moves the cursor to the next tab stop.
Shift+Tab
Moves the cursor to the previous tab stop.
═══ 3.3. Editing Keys ═══
Alt+F1
Inserts a list of various graphic characters at the current cursor
position.
Alt+A
Adjusts the mark.
Alt+B
Block-marks the current cursor position.
Alt+C (*)
Copies the marked text.
Alt+D
Deletes the current mark.
Alt+E (*)
Moves the cursor to the end of the current mark.
Alt+F (*)
Prompts you for a character and fills the current mark with the
specified character.
Alt+J
Joins the next line with line at the current cursor position,
separated by a space.
Alt+L
Line-marks the line at the current cursor position.
Alt+M
Moves the current mark.
Alt+N
Types the current file name at the current cursor position.
Alt+O (*)
Overlay the current mark.
Alt+P
Reformats the paragraph, starting at the current cursor position,
using the current margins.
Alt+R
Reformats a marked block of text to a new set of margins.
Alt+S (*)
Splits the line at the current cursor position.
Alt+T
Centers the text within the current mark (or margins, if no mark).
Alt+U
Removes the current mark.
Alt+W
Marks the word at the current cursor position using a character mark.
Alt+Y
Moves the cursor to the beginning of the current mark.
Alt+Z
Character-marks the current character.
Alt+1
Edits the file name on the line at the current cursor position.
Alt+0
Executes the line at the current cursor position, or all lines within
the line at the current cursor position mark.
Alt+=
Executes the line at the current cursor position, or all lines within
the line mark.
Alt+/
Move to the next bookmark.
Alt+\
Move to the previous bookmark.
Ctrl+F1
Converts current word to uppercase.
Ctrl+F2
Converts current word to lowercase.
Ctrl+F3
Converts marked text to uppercase.
Ctrl+F4
Converts marked text to lowercase.
Ctrl+F5
Moves the cursor to the beginning of the current word.
Ctrl+F6
Moves the cursor to the end of the current word.
Ctrl+F7
Shifts marked text to the left one column. (Block or line marks
only.)
Ctrl+F8
Shifts marked text to the right one column. (Block or line marks
only.)
Ctrl+A
Scrolls down so that current line is at top of edit window.
Ctrl+B
Activates the List Bookmarks dialog.
Ctrl+C
Repeats the last CHANGE command.
Ctrl+D
Erases from the current cursor position to the beginning of the next
word.
Ctrl+E
Erases from the current cursor position to the end of the line.
Ctrl+F
Repeats the last LOCATE command.
Ctrl+I
Displays the EPM command line.
Ctrl+L
Copies the line at the current cursor position to the command line.
Ctrl+M
Activates the Set Bookmarks dialog.
Ctrl+Q
Switches between the search file and the results of the ALL command.
Ctrl+R
Starts and stops recording keystrokes.
Ctrl+S
Activates the Search dialog.
Ctrl+T
Plays back a set of recorded keystrokes.
Ctrl+2
Types an ASCII 0 (NUL character).
Ctrl+6
Types a 'к'.
Ctrl+9
Types a '{' (left brace).
Ctrl+0
Types a '}' (right brace).
Ctrl+Backspace
Deletes the current line.
Ctrl+Enter
Moves cursor to the beginning of the next line. (configurable)
Ctrl+Left
Moves the cursor to the beginning of the word.
Ctrl+Right
Moves the cursor to the beginning of the next word.
Ctrl+/
Character-marks the entire file.
Ctrl+\
Removes the current mark.
Ctrl+[
Finds the bracket that matches the current character, taking nesting
into account. Matchable characters are (){}[]<> (parentheses,
braces, brackets, and angle brackets). Also matches strings, as
follows:
If the cursor is on a '/*' or '*/', will find the matching comment
delimiter. It is assumed that comments are allowed to nest (which is true
for E and Rexx, but not true for C).
If the cursor is on a #if, #ifdef, #ifndef, #else, #elif, or #endif, will
find the matching start or end. (If the cursor is on a #else or #elif, will
jump first to the start. Press the key again to jump to the end.)
If the cursor is on the word COMPILE, followed by IF, ELSE, ELSEIF, or
ENDIF, will find the matching start or end. (If the cursor is on a #else or
#elif, will jump first to the start. Press the key again to jump to the
end.)
If the cursor is on one of :ol, :eol, :sl, :esl, :ul, :eul, :dl, :edl,
:parml, or :eparml, will find the matching tag.
If the cursor is on an SGML tag, will find the matching tag. E.g., if the
cursor is on , pressing Ctrl+[ will jump to the corresponding
, and
vice versa.
Ctrl+]
Same as Ctrl+[.
Esc
Displays the EPM command line. (ESCAPEKEY must be on.)
Del
Deletes the character at the current cursor position.
Ins
Switches between insert and replace modes.
(*)These definitions will be blocked if the Menu Accelerators option is
selected. Instead, the key will activate the corresponding action bar menu
item.
═══ 4. Mark Types ═══
There are three types of marked or selected text: Block, Line, and Character.
Advanced mode uses all three types, while basic mode uses only Character marks.
A detailed description about how to mark or select each type follows:
Block
A block mark is a rectangular area of text. To mark a block:
1. Position the cursor in the upper-right corner of the desired block.
2. Press Alt+B.
3. Position the cursor in the lower left corner of the desired block.
4. Press Alt+B.
Note: When you delete a block of text, the text is erased but the space
that contained the text remains in the file -it is not closed. To
close the space, you must use a line or character mark to delete
the text.
Line
A line mark is a mark of a line or a set of lines. To mark the line:
1. Position the cursor in the first line to be marked.
2. Press Alt+L.
3. Position the cursor in the last line to be marked.
4. Press Alt+L.
Character
A character mark is a mark of a character or set of characters. To
mark characters:
1. Position the cursor on the first character to be marked.
2. Press Alt+Z.
3. Position the cursor on the last character to be marked.
4. Press Alt+Z.
Related Information:
Mark Operations
═══ 5. Mark Operations ═══
There are several mark operations that can be performed. The most frequently
performed options and their key combinations are listed below:
Alt+A (Adjust Mark)
Copies the marked text, overlaying the text starting at the current
cursor position and filling the original text position with blanks.
Alt+C (Copy Mark) (*)
Copies the marked text to the current cursor position. The original
text remains in its position. With line marks, the marked lines are
copied after the line the cursor is on.
Alt+D (Delete Mark)
Deletes the marked text from the file.
Alt+E (End Mark) (*)
Moves the cursor to the end of the mark. If the mark is a line mark,
the column position of the cursor is preserved.
Alt+M (Move Mark)
Moves the marked text from its current position to the cursor
position, as in the Copy Mark command.
Alt+O (Overlay Mark) (*)
Overwrites the text at the current cursor position with a copy of the
marked text.
Alt+T (Center Mark)
Centers the text within the mark.
Alt+U (Unmark)
Unmarks any mark within the current ring.
Alt+Y (Begin Mark)
Moves the cursor to the beginning of the mark. If the mark is a line
mark, the column position of the cursor is preserved.
(*)These definitions will be blocked if the Menu Accelerators option is
selected. Instead, the key will activate the corresponding action bar menu
item.
═══ 6. Recording Keystrokes ═══
With the EPM editor you can record a set of keystrokes to be played back at a
later time. This is helpful if you are performing a particular action
repeatedly.
To record keystrokes:
1. Press Ctrl+R to start recording.
2. Type the keys that you want recorded.
3. Press Ctrl+R to stop recording.
Press Ctrl+T to playback the recorded keystrokes.
For example, suppose you type DIR to get a directory listing of the current
directory.
Volume in drive C is MYDISK
The Volume Serial Number is 0123:4567
Directory of C:\TCPIP\LAMAIL
ALL 1-01-90 12:01a
ALL NDX 87 1-01-90 12:01a
OUT 1-01-90 12:01a
OUT NDX 87 1-01-90 12:01a
PERSONAL 1-01-90 12:01a
PERSONAL NDX 87 1-01-90 12:01a
STUFF 1-01-90 12:01a
STUFF NDX 87 1-01-90 12:01a
MORESTUF 1-01-90 12:01a
MORESTUF NDX 87 1-01-90 12:01a
You wish to convert all of the file names from the "DIR" format to the
"name.ext" format.
After deleting all lines but the files (not subdirectories) and the file
information (show size, date, and time), you have left:
ALL NDX
OUT NDX
PERSONAL NDX
STUFF NDX
MORESTUF NDX
Place your cursor at the beginning of the first line and press Ctrl+R to start
recording. Press the following keys:
1. Ctrl+F6
2. Right "."
3. Alt+B
4. Ctrl+Right
5. Left
6. Alt+B
7. Alt+D
8. Down
9. Home
10. Ctrl+R
You have recorded the keystrokes to convert one file name. Now press Ctrl+T
twice to playback the keystrokes, and the files are converted.
There are a total of five files.
ALL.NDX
OUT.NDX
PERSONAL.NDX
STUFF.NDX
MORESTUF.NDX
═══ 7. Configuring the Mouse ═══
You can configure the mouse to be in either the basic marking mode or the
advanced marking mode. The default is the basic marking mode. In the basic
marking mode, the mark is only usable for deleting text or copying it to the
clipboard Typing any text character deletes the marked text and replaces it
with the entered character. The basic marking mode mouse actions are:
Button 1 click
Move cursor position to mouse pointer and unmark.
Button 1 + Shift
Mark text from cursor position to mouse pointer.
Button 1 click and drag
Mark text as you drag.
Button 1 double-click
Move cursor position to mouse pointer and mark the word.
In advanced marking mode, a mark stays until you explicitly delete it or
unmark. The advanced marking mode mouse actions are:
Button 1 click
Move cursor position to mouse pointer.
Button 1 + Shift
Mark text from cursor position to mouse pointer.
Button 1 click and drag
Block mark text as you drag.
Button 2 click and drag
Line mark text as you drag. If you start dragging inside a marked
region, this will instead initiate a drag of the marked text. The
text will be moved (or copied, if the Ctrl key is pressed as well) to
wherever you drop it.
Button 1 + Ctrl + drag
Character mark text as you drag.
Button 1 double-click
Unmark text.
Button 1 + Ctrl + double-click
Ask for help for the token under the mouse pointer. Looks up the
word in an index file (EPMKWHLP.NDX, or the file or files listed in
the HELPNDX environment setting; multiple files must be separated by
plus signs). Index files are provided by your applications, not as
part of EPM. For example, the OS/2 2.0 Toolkit includes an
EPMKWHLP.NDX, and the IBM C Set/2 compiler comes with a DDE4.NDX.
The index file will be looked for in the current directory, along the
EPMPATH, DPATH, in the directory from which EPM was loaded, and
finally along the PATH.
Button 2 double-click
Move cursor position to mouse pointer and mark the (space-delimited)
word.
Button 2 + Ctrl + double-click
Move cursor position to mouse pointer and mark the token according to
the parsing rules for the C language. E.g., in the line:
s = substr(string, start, end);
placing the cursor somewhere on string and performing a Button 2 +
Ctrl + double-click will result in just string being selected, while
performing a Button 2 double-click will result in substr(string,
being selected.
Button 2 + Shift + double-click
Search for the next occurrance of the token under the mouse cursor
(parsed for the C language, as above). The search starts after the
token. The current mark, if any, is not affected.
In either mode, clicking both mouse buttons together will bring up the List
ring dialog, if more than one file is loaded in the edit window, much as
clicking both mouse buttons on the desktop brings up the Window List dialog.
To select advanced marking mode:
1. Select Options.
2. Select Preferences.
3. Select Advanced marking.
To save the mark mode setting:
1. Select Options.
2. Select Save options.
Related Information:
o Mark types
o Mark operations
═══ 8. Direct File Manipulation with the File Symbol ═══
The File symbol is located in the top left corner of the edit window. It looks
like a sheet of paper with the top right corner folded down. It can be used to:
o Print the visible file.
o Copy a file to another edit window.
o Create another edit window containing your file.
o Copy files to an open file directory folder.
The File symbol is manipulated in the following way:
Select the File symbol by pointing to it with the mouse pointer and pressing
button 2. Keeping button 2 down, move the mouse pointer over one of the
following:
o An EPM edit window, to copy the file.
o The EPM icon, to create another edit window containing your file.
o An open directory, to copy the file to that directory.
═══ 9. The EPM Toolbar ═══
The toolbar is a user-configurable button bar at the top of the edit window,
which acts as an extension of the action bar. You can copy or move buttons
around (within a toolbar or across edit windows) using drag&drop. You can edit
the toolbar, and save the results by name, by bringing up the toolbar's pop-up
menu (by default, clicking mouse button 2 over the toolbar will do this). You
can select either the built-in toolbar or any saved toolbar (or turn the
toolbar on and off) via the Toolbars page of the Settings notebook. (Note that
you might have to scroll the notebook tabs down in order to access this page.)
You can configure the way the toolbar is presented via the Toolbar Style page
of the Settings notebook.
In addition to the pre-defined actions, you can set a toolbar item to execute
any external command by selecting an action of ExecuteCommand, or any EPM
command by selecting an action of '*'. In either case, the desired command
gets entered in the Parameters field. Using EPM's MC command, you can enter a
number of commands to be executed when the toolbar item is selected.
The initial set of actions available in the Functionslist is derived from the
set of *.ex files whose names appear in your Actions.LST file. If you have the
macros source and macro compiler, you can create your own actions files, using
SAMPACTN.E as an example, then add the name of the resulting .ex file to
Actions.LST.
═══ 10. Help for Search ═══
Use this window to search for a string of text or search for and replace a
string of text.
To search for text:
1. Type the search_string in the Search field.
2. Select Find to search for text. Find can be selected multiple times to
find successive occurrences of the search string.
3. Select Cancel to close the window.
To replace a string of text:
1. Type the search_string in the Search field.
2. Type the replace_string that will replace the search_string in the Replace
field.
3. Select either:
o Change to find the next occurrence of the search_string and change it to
the replace_string.
o Change, then find, to do the same as Change, and then search for the next
occurrence of the search_string after the change has been made.
Alt+F6 can be used to toggle between the Search dialog and the edit window.
Note: The search normally begins from the current cursor position. The entire
file is searched only if the cursor is at the beginning of the first
line, or if the Start at Top option is selected.
Related Information:
o Search
o Replace
o Options
o Find
o Change
o Change, then find
o Find, cancel
o Cancel
═══ 11. Help for Search ═══
Type in the Search filed the text you want to find. The text you type is
called the search_string.
═══ 12. Help for Replace ═══
Type in the Replace field the text you want to put in place of the text in the
Search field. The text in the Replace field is called the replace_string.
═══ 13. Help for Options ═══
You can choose any of the following options:
Ignore case
Ignores case in the search_string. For example, "Search", "search",
and "SEARCH" are treated the same.
Reverse search
Searches from the current cursor position to the beginning of the
file.
Change all
Causes all occurrences of the search_string to be overwritten by the
replace_string.
Marked area
Searches only the marked text.
Match case
when Change is selected, causes each occurrance of replace_string
that replaces an instance of search_string to be replaced in the same
case (all upper, all lower, initial capital, etc.) as that instance
of search_string. (See the /K option of the Change command for an
example.)
Negate search
Search for a line not containing search_string.
Normal
Perform a normal search (i.e., not one of Word, GREP, or EGREP).
Word
Search for search_string occurring as a separate word.
GREP
Searches using the GREP option.
EGREP
Searches using the Extended GREP option.
Cursor
Start the search at the cursor position.
Top
Start the search from the top of the file. (This will turn off the
Reverse search option if it was checked.)
Bottom
Start the search from the bottom of the file. (This will turn on the
Reverse search option if it was not already checked.)
═══ 14. Help for Find ═══
Select Find to locate the search_string within the current file.
═══ 15. Help for Change ═══
Select Change to replace the found text with the replace_string.
═══ 16. Help for Change, then Find ═══
Select Change, then find to replace the first occurrence of the found text with
the replace_string and then find the next occurrence of the search_string
═══ 17. Help for Find, Cancel ═══
Select Find, cancel to search for the first occurrence of the search_string and
then exit the Search window.
═══ 18. Help for Command ═══
Use this window to type editor commands. To enter a command:
1. Select a command from the selection list or type a command in the entry
field.
2. Select OK.
As you type a command, the editor will attempt to match what you're typing with
an existing line in the selection list. At any point you can press Ctrl+O to
select the matched line in the list, or Ctrl+F to find the next matching line.
Ctrl+Backspace will delete the line from the list.
Note: Commands in the selection list are saved between sessions of the editor.
Related Information:
o Editor commands
o OK
o Cancel
═══ 19. Help for Messages ═══
Use this window to display or review error messages.
Select an error message from the selection list to have it displayed in the
entry field. The message can be marked and copied from the entry field to the
clipboard.
Related Information:
o Cancel
═══ 20. Help for Describe Error ═══
The list displays all errors associated with the current line. The following
options are available:
Details
Displays a help panel giving additional information on the error
message, if this information was provided by the compiler vendor.
Cancel
Returns control to the edit window.
Help
Displays this panel.
═══ 21. Help for Save Toolbar ═══
Enter a name for the current toolbar, then select Save As to save the current
toolbar. Use the Settings dialog if you wish to make this the default toolbar.
═══ 22. Help for Tabs & Margins ═══
To set the edit window tabs:
Type the tab settings. You can type either a single number to use as an
increment, or you can type a series of numbers separated by a space that will
be used as column positions. In both cases, column one is used as a starting
point.
To set the left, right, and paragraph margins: For each setting, drag the
slider arm, select the left or right slider button, or type a new value. The
changes will be applied when you close the notebook.
For a detailed explanation of each field, select from the list below:
o Margins
o Undo
o Default
o Save settings
═══ 23. Help for Margins ═══
The left and right margins control where the cursor is positioned when typing
text. If you type beyond the right margin, the word you are typing is moved to
a new line starting at the left margin.
When you reformat a paragraph, it is justified so that all lines are between
the left margin and the right margin, except the first line, which starts at
the paragraph margin.
Related Information:
Reformatting a paragraph
═══ 24. Help for Colors ═══
Use this window to set the colors used by the editor. To change colors:
1. Select a field from the Field selection selection list.
2. Select the Set background or Set foreground radio button.
3. Select a color from the Color selection selection list.
4. Close the notebook to apply the changes.
Note: As you change colors, Sample Text will reflect your changes.
For a detailed explanation of each field, select from the list below:
o Field selection
o Color selection
o Set background
o Set foreground
o Undo
o Default
o Save settings
═══ 25. Help for Field Selection ═══
Use Field selection to select the field you want to change. The four fields
that you can choose from are:
Text
Color of normal text.
Mark
Color of a marked area.
Status
Color of the status line, if enabled, containing the line and column
numbers.
Message
Color of the message line, if enabled, and the color in which
messages will be displayed.
═══ 26. Help for Color Selection ═══
Use Color selection to select the color that you want to paint the selected
field. Select the color you want from the selection list.
═══ 27. Help for Set Background ═══
Select the Set background radio button to color the background of the selected
field with the selected color.
═══ 28. Help for Set Foreground ═══
Select the Set Foreground radio button to color the foreground of the selected
field with the selected color.
═══ 29. Help for Paths ═══
To enter paths:
1. Type a temporary path.
2. Close the notebook to apply the changes.
For a detailed explanation of each field, select from the list below:
o Temporary path
o Undo
o Default
o Save settings
═══ 30. Help for Paths ═══
To enter paths:
1. Type a temporary path.
2. Type a dictionary path and file name.
3. Type a personal dictionary path and file name.
4. Close the notebook to apply the changes.
For a detailed explanation of each field, select from the list below:
o Temporary path
o Dictionary file
o Personal dictionary
o Undo
o Default
o Save settings
═══ 31. Help for Autosave Path ═══
The subdirectory in which autosave files are stored.
Note: If you select a temporary disk (VDISK), your autosave files will be lost
if the system loses power while you are updating a file.
Do not select a temporary disk because they only exist until you reboot, and
while power is not interrupted.
Note: If you do not specify an autosave path, the current directory is used.
═══ 32. Help for Temporary Path ═══
Use Temporary paths to select the directory where temporary files are created.
This directory should be on a temporary disk, if you have one with room to
spare, both for speed and so you don't have to explicitly erase the files. A
temporary disk exists only until you reboot, and while power is not
interrupted.
Note: If you do not specify a temporary path, the current directory is used.
═══ 33. Help for Dictionary File ═══
Use Dictionary file to specify the path and file name of the file to be used
for spell checking.
═══ 34. Help for Personal Dictionary ═══
Use Personal dictionary to specify where your personal dictionary addenda
exists or should be created. Your personal dictionary addenda file is used
during the proof function.
═══ 35. Help for Autosave ═══
Use this window to control the number of modifications that are required to be
made to a file before it is automatically saved. Set the number to 0 to turn
off the autosaving feature.
For a detailed explanation of each field, select from the list below:
o Autosave
o Autosave path
o Undo
o Default
o Save settings
═══ 36. Help for Autosave ═══
Use Autosave to specify the number of changes that have to be made to a file
before it is automatically saved. To specify the number, select the slider
button, drag the slider arm, or type a new value in the field.
═══ 37. Help for Fonts ═══
To change the editor fonts:
1. Select Font name.
2. Select Size.
3. Select any of the following attributes by selecting the symbol that
corresponds to the desired feature:
o Bold
o Italic
o Underlined
o Strikeout
o Outline
4. Select the area to which you wish the change to apply by selecting from the
listbox at the lower left of the window.
Text is the default font for the text file being edited.
Status line is the font used on the status line.
Message line is the font used on the message line, and for messages that are
displayed elsewhere when the message line is turned off.
5. Close the notebook to apply the changes.
As you change fonts, Sample Text will change to show you what the font and
attributes look like.
For a detailed explanation of each field, select from the list below:
o Font name
o Size
o Undo
o Default
o Save settings
═══ 38. Help for Font Name ═══
Use Font name to specify the font you want to use. Select the arrow to the
right to display the entire selection list; then select the font that you want.
═══ 39. Help for Size ═══
Use Size to adjust the size of the font. Select the arrow to the right to
display the entire selection list; then select the font size that you want.
═══ 40. Help for Keys ═══
To define an action for the Enter key:
1. Select a key or key combination from the top selection list.
2. Select an action from the bottom selection list.
3. Close the notebook to apply the changes.
For a detailed explanation of each field, select from the list below:
o Undo
o Default
o Save settings
═══ 41. Help for Frame Controls ═══
Use this page to configure which edit window frame controls you want to be
present, and where you want them to be located. A check mark appears next to
each choice if it is currently active. The selections are:
Status window
Controls whether or not the status line window is present.
Message window
Controls whether or not the message line window is present. If the
message window is off but the status window is on, then messages will
appear temporarily overlaying the status line. If both are off, then
messages will temporarily overlay a portion of the file area.
Above
Select this to have the status and message windows appear above the
edit window.
Below
Select this to have the status and message windows appear below the
edit window.
Vertical scroll bar
Controls whether or not the vertical scroll bar is present.
Horizontal scroll bar
Controls whether or not the horizontal scroll bar is present.
Background bitmap
Controls whether or not a background bitmap is displayed behind the
text area of the edit window.
Bitmap name
The name of a bitmap file can be entered in this entry field. This
will be used for the background bitmap if the above selection is
checked. The default is that a built-in bitmap will be used.
Dropping file
Controls what happens when a file is dropped in the edit window. (If
a file is dropped on the title bar, it will always be edited.)
Edits
The dropped file will be edited - i.e., added to the current ring as
a new file.
Imports
The dropped file will be imported into the current file at the cursor
position.
Close the notebook to apply the changes.
For a detailed explanation of each field, select from the list below:
o Undo
o Default
o Save settings
═══ 42. Help for Miscellaneous ═══
Use this page to configure various edit-mode settings. A check mark appears
next to each choice if it is currently active. The selections are:
CUA marking
Controls whether the editor uses CUA-style marking or the advanced
marking mode.
Stream mode editing
Controls whether the editor uses stream-mode editing, like a word
processor, or line mode editing, like a mainframe text editor.
Rexx profile
Controls whether a Rexx profile, PROFILE.ERX, will be executed every
time an edit window is opened. The profile will be searched for
along the EPMPATH and PATH.
Long file name support
Controls whether or not the .LONGNAMES Extended Attribute is
supported. See the LONGNAMES command for further details.
Menu accelerators
Controls whether or not menu accelerators are enabled. By default,
Presentation Manager defines an accelerator for every action bar
mnemonic. For example, the F in File is a mnemonic, so PM defines
Alt+F as an accelerator. This blocks the macro definitions of the
Alt+letter for each mnemonic on the action bar, so by default EPM
blocks those accelerators in order to allow the macro definition to
take precedence. When this selection is checked, Alt+letter will
activate the action bar menu item which has that letter as a
mnemonic. When this selection is unchecked, the Alt+letter will
perform the defined EPM action.
Mouse pointer type
Allows you to choose between the I-beam text pointer or the arrow
pointer.
Cursor type
Allows you to choose between the cursor style used in command
windows, in which the replace-mode cursor is an underline and the
insert-mode cursor is a block on the bottom half of the character,
and the normal GPI cursor style, in which the insert-mode cursor is a
vertical bar at the left side of the current character and the
replace-mode cursor is a block covering the entire character.
Close the notebook to apply the changes.
For a detailed explanation of each field, select from the list below:
o Undo
o Default
o Save settings
═══ 43. Help for Toolbar Style ═══
Use this page to configure the toolbar.
You can check the following items to change the general style of the toolbar:
Show button text
Display the text at the bottom of each selection.
Automatic sizing
Select this to have the size of the toolbar be determined
automatically, based on the size of the bitmaps being displayed. If
not checked, then the Width and Height fields will be used to specify
the size (in pixels) you want to give to each item.
If the item is smaller, it is centered.
If the item is bigger, the bitmap is shrunk.
There are three shrink modes :
Discard
Ignore the lost lines and columns. Works best for bitmaps with
many colors.
And
Works best for bitmaps with dark drawings on light backgrounds.
Or
Works best for bitmaps with light drawings on dark backgrounds.
You can select the Refresh button to refresh the toolbar with the current
settings before closing the notebook, if you would like to see how your changes
look.
Close the notebook to apply the changes.
For a detailed explanation of each field, select from the list below:
o Undo
o Default
o Save settings
For a general description of the Toolbar, including information on how to edit
it, select:
o Toolbar
═══ 44. Help for Toolbars ═══
Use this page to manage your set of toolbars.
You can select a toolbar from the list, then select:
Import
Allows you to import a saved toolbar from disk.
Export
Allows you to save the selected toolbar to disk.
Delete
Allows you to delete the selected toolbar from the list (and from the
.INI file, which is where toolbars are kept internally).
Make current
Makes the selected toolbar the one used by the edit window.
Display the toolbar
Controls whether or not the toolbar is displayed.
Close the notebook to apply the changes.
For a detailed explanation of each field, select from the list below:
o Undo
o Default
o Save settings
For a general description of the Toolbar, including information on how to edit
it, select:
o Toolbar
═══ 45. Help for Formatting - Tabs & Margins ═══
To set the edit window tabs: Type the tab settings. You can type either a
single number to use as an increment, or you can type a series of numbers
separated by a space that will be used as column positions. In both cases,
column one is used as a starting point.
To control whether the Tab key moves over to the next tab stop, like a
typewriter tab key, or inserts an ASCII Tab character, select or deselect the
Tab key inserts Tab checkbox.
To set the left, right, and paragraph margins:. For each setting, drag the
slider arm, select the left or right slider button, or type a new value.
Close the notebook or change to a different page to apply the changes.
For a detailed explanation of each field, select from the list below:
o Undo
o Default
═══ 46. Help for Formatting - Enter keys ═══
To define an action for the Enter key:
1. Select a key or key combination from the top selection list.
2. Select an action from the bottom selection list.
Close the notebook or change to a different page to apply the changes.
For a detailed explanation of each field, select from the list below:
o Undo
o Default
═══ 47. Help for Text - Colors ═══
Use this window to set the colors used by the editor. To change colors:
1. Select a field from the Field selection selection list.
2. Select the Set background or Set foreground radio button.
3. Select a color from the Color selection selection list.
4. Close the notebook or change to a different page to apply the changes.
Note: As you change colors, Sample Text will reflect your changes.
For a detailed explanation of each field, select from the list below:
o Field selection
o Color selection
o Set background
o Set foreground
o Undo
o Default
═══ 48. Help for Text - Fonts ═══
To change the editor fonts:
1. Select Font name.
2. Select Size.
3. Select any of the following attributes by selecting the symbol that
corresponds to the desired feature:
o Bold
o Italic
o Underlined
o Strikeout
o Outline
4. Close the notebook or change to a different page to apply the changes.
As you change fonts, Sample Text will change to show you what the font and
attributes look like.
For a detailed explanation of each field, select from the list below:
o Font name
o Size
o Undo
o Default
═══ 49. Help for Window - Frame controls ═══
Use this page to configure which edit window frame controls you want to be
present, and where you want them to be located. A check mark appears next to
each choice if it is currently active. The selections are:
Status window
Controls whether or not the status line window is present.
Message window
Controls whether or not the message line window is present. If the
message window is off but the status window is on, then messages will
appear temporarily overlaying the status line. If both are off, then
messages will temporarily overlay a portion of the file area.
Above
Select this to have the status and message windows appear above the
edit window.
Below
Select this to have the status and message windows appear below the
edit window.
Vertical scroll bar
Controls whether or not the vertical scroll bar is present.
Horizontal scroll bar
Controls whether or not the horizontal scroll bar is present.
Background bitmap
Controls whether or not a background bitmap is displayed behind the
text area of the edit window.
Bitmap name
The name of a bitmap file can be entered in this entry field. This
will be used for the background bitmap if the above selection is
checked. The default is that a built-in bitmap will be used.
Close the notebook or select a different page to apply any changes.
For a detailed explanation of each button, select from the list below:
o Undo
o Default
═══ 50. Help for Autosave ═══
Use this window to control the number of modifications that are required to be
made to a file before it is automatically saved. Set the number to 0 to turn
off the autosaving feature.
Autosave path is the subdirectory in which autosave files are stored.
Note: If you select a temporary disk (VDISK), your autosave files will be lost
if the system loses power while you are updating a file.
Do not select a temporary disk because they only exist until you reboot, and
while power is not interrupted.
Note: If you do not specify an autosave path, the current directory is used.
Close the notebook or change to a different page to apply the changes.
For a detailed explanation of each field, select from the list below:
o Autosave
o Undo
o Default
═══ 51. Help for Configuration - Macro modules ═══
Use this window to select which .ex files (compiled macro modules) are used for
edit windows opened from this object.
Select Add to add a .ex file to the list. Select a file from the list and
select Remove to remove an entry from the list.
Close the notebook or change to a different page to apply the changes.
For a detailed explanation of each button, select from the list below:
o Undo
o Default
═══ 52. Help for Configuration - Paths and files ═══
To enter paths:
1. Type a temporary path.
2. Type a dictionary path and file name.
3. Type a personal dictionary path and file name.
4. Close the notebook or change to a different page to apply the changes.
For a detailed explanation of each field, select from the list below:
o Temporary path
o Dictionary file
o Personal dictionary
o Undo
o Default
═══ 53. Help for Configuration - Miscellaneous ═══
Use this page to configure various edit-mode settings. A check mark appears
next to each choice if it is currently active. The selections are:
CUA marking
Controls whether the editor uses CUA-style marking or the advanced
marking mode.
Stream mode editing
Controls whether the editor uses stream-mode editing, like a word
processor, or line mode editing, like a mainframe text editor.
Rexx profile
Controls whether a Rexx profile, PROFILE.ERX, will be executed every
time an edit window is opened. The profile will be searched for
along the EPMPATH and PATH.
Long file name support
Controls whether or not the .LONGNAMES Extended Attribute is
supported. See the LONGNAMES command for further details.
Menu accelerators
Controls whether or not menu accelerators are enabled. By default,
Presentation Manager defines an accelerator for every action bar
mnemonic. For example, the F in File is a mnemonic, so PM defines
Alt+F as an accelerator. This blocks the macro definitions of the
Alt+letter for each mnemonic on the action bar, so by default EPM
blocks those accelerators in order to allow the macro definition to
take precedence. When this selection is checked, Alt+letter will
activate the action bar menu item which has that letter as a
mnemonic. When this selection is unchecked, the Alt+letter will
perform the defined EPM action.
Mouse pointer type
Allows you to choose between the I-beam text pointer or the arrow
pointer.
Cursor type
Allows you to choose between the cursor style used in command
windows, in which the replace-mode cursor is an underline and the
insert-mode cursor is a block on the bottom half of the character,
and the normal GPI cursor style, in which the insert-mode cursor is a
vertical bar at the left side of the current character and the
replace-mode cursor is a block covering the entire character.
Close the notebook or select a different page to apply any changes.
For a detailed explanation of each button, select from the list below:
o Undo
o Default
═══ 54. Help for Toolbar Style ═══
Use this page to configure the toolbar.
You can check the following items to change the general style of the toolbar:
Show button text
Display the text at the bottom of each selection.
Automatic sizing
Select this to have the size of the toolbar be determined
automatically, based on the size of the bitmaps being displayed. If
not checked, then the Width and Height fields will be used to specify
the size (in pixels) you want to give to each item.
If the item is smaller, it is centered.
If the item is bigger, the bitmap is shrunk.
There are three shrink modes :
Discard
Ignore the lost lines and columns. Works best for bitmaps with
many colors.
And
Works best for bitmaps with dark drawings on light backgrounds.
Or
Works best for bitmaps with light drawings on dark backgrounds.
You can select the Refresh button to refresh the toolbar with the current
settings before closing the notebook, if you would like to see how your changes
look.
For a detailed explanation of each button, select from the list below:
o Undo
o Default
═══ 55. Help for Toolbars ═══
Use this page to manage your set of toolbars.
You can select a toolbar from the list, then select:
Import
Allows you to import a saved toolbar from disk.
Export
Allows you to save the selected toolbar to disk.
Delete
Allows you to delete the selected toolbar from the list (and from the
.INI file, which is where toolbars are kept internally).
Make current
Makes the selected toolbar the one used by the edit window.
Display the toolbar
Controls whether or not the toolbar is displayed.
For a detailed explanation of each button, select from the list below:
o Undo
o Default
═══ 56. Help for Undo ═══
Select Undo to cancel the settings changes you made to this page.
═══ 57. Help for Default ═══
Select Default to set the values to the initial system settings.
═══ 58. Help for Save settings ═══
Check Save settings if you want the changes you made to be saved permanently.
Leave Save settings unchecked if you only want to apply the changes to this EPM
session.
═══ 59. Help for Quitting a File ═══
Use Quitting a File to end an editing session before a modified file is removed
from the edit window ring. The following options are available:
Save
Saves the file as it appears in the entry field. The file name can
be modified before Save is selected.
Discard
Enables the quitting process to continue. Changes to the file are
not saved.
Cancel
Returns control to the edit window.
Note: When all files have been removed from the edit window ring, the edit
window is automatically closed.
═══ 60. Help for Closing a File ═══
Use Closing a File to end an editing session before a modified file is removed
from the edit window ring. The following options are available:
Save
Saves the file as it appears in the entry field. The file name can
be modified before Save is selected.
Discard
Enables the quitting process to continue. Changes to the file are
not saved.
Cancel
Returns control to the edit window.
Note: When all files have been removed from the edit window ring, the edit
window is automatically closed.
═══ 60.1. Help for Proof ═══
The Proof window is displayed when a possibly misspelled word is found during
the proof function. This window contains an entry field, in which you can type
a replacement for the word, and a list for words suggested as likely
replacements. The window buttons are as follows:
Suggest
The listbox will be filled with a list of suggested replacements for
the misspelled word.
Auto-suggest
If checked, the listbox will be filled automatically whenever a
misspelled word is found.
Replace
The word from the entry field is placed inside your document,
replacing the misspelled word. The replace function can also be
achieved by double-clicking on a word in the list. Replace is the
default.
Temp. Add
The word that is being questioned is placed in a temporary personal
dictionary file. Every other occurrence of that word is considered
correct during the remainder of your proof session.
Add
The word that is being questioned is placed in your personal
dictionary file. The word is permanently considered correct.
Next
Skips the current word and continues spell checking.
Cancel
Terminates the proof function.
Help
Displays this panel.
═══ 60.2. Help for Synonym ═══
The Synonym window is displayed if one or more synonyms are found during the
execution of the synonym function. This window contains a list box which holds
a selection of words. The window buttons are as follows:
Replace
The highlighted word from the list is placed inside your document,
replacing the highlighted word. The replace function can also be
achieved by double clicking on a word in the list. Replace is the
default button.
Cancel
Terminates the proof function.
Help
Displays this panel.
═══ 61. Help for Undo ═══
The number range represents changes made to the current file. The lower the
number the earlier the change.
To use Undo:
1. Move the slider to the change that you want to undo.
2. Select OK.
═══ 62. Help for List Ring ═══
The selection list contains a list of all files in the current edit ring.
To select a file from the list:
1. Select a file from the selection list to activate it.
2. Select Switch to.
Related Information:
o Switch to
o Cancel
═══ 63. Help for Switch To ═══
Select Switch to to exit the window, and make the selected file the current
file.
═══ 64. Help for Cancel ═══
Select Cancel to exit the window and leave the original file as the current
file.
═══ 65. Help for Style ═══
Use Style to apply a style, consisting of a specific font, color, or both to a
marked region of text. You can select an existing style in the Style name
field, or you can define a new style by doing the following:
1. Optionally, type a new name in the Style name field.
2. Select Font name.
3. Select Size.
4. Select any of the following attributes, if desired:
o Bold
o Italic
o Underlined
o Strikeout
o Outline
5. Select Foreground color
6. Select Background color to change the background color.
7. Select Set to apply the selected style to the marked region, or Register to
register the style and continue in the window.
As you change font and colors, Sample Text changes to show you what the style
looks like.
Note: If you do not enter a name in the Style name field, you can only apply
the style to the marked text. The style will not be registered.
For a detailed explanation of each field, select from the list below:
o Style name
o Font name
o Font size
o Font attributes
o Foreground color
o Background color
o Color selection
o Apply
o Register
o Cancel
═══ 66. Help for Style Name ═══
Use Style name to select the existing style you want to use, or to enter a new
style name. Select the arrow to the right to display the entire selection
list; then select the style that you want.
═══ 67. Help for Font Name ═══
Use Font name to specify the font you want to use. Select the arrow to the
right to display the entire selection list; then select the font that you want.
═══ 68. Help for Font Size ═══
Use Font Size to adjust the size of the font. Select the arrow to the right to
display the entire selection list; then select the font that you want.
═══ 69. Help for Font Attributes ═══
Select any of the following attributes by selecting the symbol that corresponds
to the desired feature:
o Bold
o Italic
o Underlined
o Strikeout
o Outline
═══ 70. Help for Background Color ═══
Select the Background color radio button to color the background of the
selected style.
═══ 71. Help for Foreground Color ═══
Select the Foreground color radio button to color the foreground of the
selected style.
═══ 72. Help for Color Selection ═══
Use this listbox to select the color that you want to paint the selected style.
Select the color you want from the selection list.
═══ 73. Help for Apply ═══
Select Apply to use the selected settings on the current text.
Note: If a name was entered in the Style name field, the style will
automatically be registered if it did not exist previously.
═══ 74. Help for Register ═══
Select Register to save the style settings under the name in the Style name
field.
═══ 75. Help for Cancel ═══
Select Cancel to close the dialog and discard any changes that were made.
═══ 76. Help for Set Bookmark ═══
To set a bookmark:
1. Type a name in the entry field.
2. Select Set or Set permanent.
For a detailed explanation of each field, select from the list below:
o Set
o Set permanent
o Cancel
═══ 77. Help for Set ═══
Select Set to set a bookmark that lasts for the duration of your edit session.
═══ 78. Help for Set Permanent ═══
Select Set permanent to set a bookmark that is saved with the file and loaded
the next time the file is edited.
═══ 79. Help for List Bookmarks ═══
To go to a bookmark:
1. Use the down arrow to the right to display the selection list; then select
a bookmark.
2. Select Go to mark.
To delete a bookmark:
1. Use the down arrow to the right to display the selection list; then select
a bookmark.
2. Select Delete mark.
For a detailed explanation of each field, select from the list below:
o Go to mark
o Delete mark
o Cancel
═══ 80. Help for Go To Mark ═══
Select Go to mark to position the cursor at the bookmark in the current file.
═══ 81. Help for Delete Mark ═══
Select Delete mark to erase the bookmark from the current file.
═══ 82. Help for Find Procedure ═══
To find a procedure listed in the active tags file:
1. Type a procedure name in the entry field.
2. Select OK.
or, select List to select from a list of all procedures in the tags file.
For a detailed explanation of each field, select from the list below:
o OK
o List
o Cancel
═══ 83. Help for List ═══
Select List to see a list of all procedure names in the active tags file.
═══ 84. Help for List Tags ═══
To find a procedure from the list, select it and select OK to jump to that
procedure.
For a detailed explanation of each field, select from the list below:
o OK
o Cancel
═══ 85. Help for Select Source FIle ═══
This dialog is presented when a FINDTAG command finds that the procedure
requested is listed in the tags file as appearing in more than one source file.
To pick the desired routine,
1. Select a file name from the list.
2. Select OK.
For a detailed explanation of each field, select from the list below:
o OK
o Cancel
═══ 86. Help for Tags File Name ═══
To set the name of the tags file:
1. Type a filename in the entry field.
2. Select Set or Set permanent.
For a detailed explanation of each field, select from the list below:
o Set
o Set permanent
o Cancel
═══ 87. Help for Set ═══
Select Set to set the tags file name for the duration of your edit session.
═══ 88. Help for Set Permanent ═══
Select Set permanent to set the tags file name, and record it in the .INI file,
so it will be the default the next time EPM is started.
═══ 89. Help for Make Tags File ═══
To create or update the active tags file:
1. Enter one or more filenames in the entry field.
2. Select OK.
Any filename can include wildcards, or can be a list of files (indicated by
prefixing the filename with an "at" sign, @).
d:\testbed\*.c d:\testbed\*.asm @d:\doc\source.lst
For a detailed explanation of each field, select from the list below:
o OK
o Cancel
═══ 90. Help for Tags Files Dialog ═══
The top of the dialog lists all known tags files. Below that is shown the
active tags file. To change the active tags file, select a tags file from the
list and then select Activate. To add a new tags file to the list (either an
existing one or one to be created), select New. To modify the list of files
used to build a tags file, select the file in the list and then select Edit.
To remove a file from the list, select it and then select Remove.
Related Information:
o Tags file:
═══ 91. Help for Tags File Source ═══
The top of the dialog lists all the source that will be searched to build the
tags file. To add an item to the list, enter it in the entry field, then
select Add. You can specify a simple filename (e.g., c:\project\main.c), a
filespec which includes wildcards (e.g., c:\project\*.c), or an at sign
followed by a filename, indicating that the file contains a list of filespecs
(e.g., @c:\project\source.lst). To remove an entry from the list, select it and
then select Remove.
Related Information:
o Tags file:
═══ 92. Adding and Inserting Text ═══
When the cursor is in insert mode, the text you type is inserted to the left of
the cursor and no text is overwritten.
To change the cursor to replace mode so that characters in the text are
overwritten:
1. Position the cursor where you want to begin typing.
2. Press the Insert (Ins) key.
3. Type the new characters to overwrite text.
═══ 93. Restoring Text ═══
To cancel your last action or restore text:
1. Select Edit.
2. Select Undo.
═══ 94. Finding Text ═══
To find or change text in a file:
1. Select Search.
2. Select Search.
For additional help, select Help after the window is displayed.
═══ 95. Closing Files ═══
To close or exit a file:
1. Select File.
2. Select Quit.
═══ 96. Copying Text ═══
You copy text by using the Copy and Paste choices on the Edit menu.
To copy text from one file to another file or to another place in the same
file:
1. Select the text to be copied.
2. Select Edit.
3. Select Copy.
4. Move the cursor to the point in the file where you want to place this text.
5. Select Edit.
6. Select Paste.
Related Information:
Selecting text
═══ 97. Deleting Selected Text ═══
To delete selected text from a file:
1. Select the text to be deleted.
2. Select Edit.
3. Select Delete mark.
Related Information:
Selecting text
═══ 98. Deleting Text ═══
To delete text, you can use one of the following:
o The delete (Del) key to delete the character to the right of the cursor. In
the basic marking mode, the Del key will delete all of the marked text if a
mark exists.
o The Backspace key to delete the character to the left of the cursor.
o The Ctrl+Backspace key to delete the current line.
Related Information:
Selecting text
═══ 99. Marking/Selecting Text ═══
To select (mark) text in basic marking mode:
1. Move the mouse pointer to the left of the first character to be selected.
2. Press and hold mouse button 1, and then drag the cursor to the right of the
last character to be selected.
3. Release mouse button 1.
To deselect text (remove the mark), do one of the following:
o Press mouse button 1 once within the text area.
o Select Edit; then Unmark.
Related Information:
o Mark types
o Mark operations
═══ 100. Opening Existing Files ═══
To open an existing file:
1. Select File.
2. Select Open.
For additional help, select Help after the window is displayed.
═══ 101. Entering Text ═══
To enter text:
1. Position the cursor by clicking the mouse button where you want to begin
typing.
2. Press Enter to start a new line.
3. Press the Spacebar to move the cursor to a place where there is no text.
4. Use the arrow keys or mouse pointer to move the cursor to any area of text.
The cursor moves one space to the right every time you type a character or
press the Spacebar.
═══ 102. Pasting or Inserting Text ═══
To insert text into a file that you have cut or copied to the clipboard:
1. Move the cursor to the point in the file where you want to insert the text.
2. Select Edit.
3. Select Paste.
═══ 103. Joining Lines ═══
To join lines, press Alt+J, or (in stream editing mode):
1. Press the End key to move the cursor to the end of the line.
2. Press the Del key.
The text from the line below joins the current line at the right of the cursor.
═══ 104. Moving Text ═══
You move text by using the Copy and Paste choices on the Edit menu.
To move text from one file to another file, or to a different place in the same
file:
1. Select the text to be moved.
2. Select Edit.
3. Select Cut. This places the text you cut on the clipboard.
4. Move the cursor to the point in the file where you want to place this text.
5. Select Edit.
6. Select Paste.
or, in advanced marking mode, you can press Alt+M to move the marked text
within the current edit window without affecting the clipboard.
Related Information:
Selecting text
═══ 105. Splitting Lines ═══
To split a line, press Alt+S (assuming the Menu Accelerators option is not
selected), or (in stream editing mode):
1. Position the cursor where you want to divide the text to start a new line.
2. Press Enter.
The text from the cursor to the end of the line is moved to the next line.
═══ 106. Printing Files ═══
To print a file:
1. Select File.
2. Select Print file.
═══ 107. Reformatting Text ═══
To reflow the text in the editing area so that any text extending beyond the
margin is moved to the next line:
1. Position the cursor to the right of the character where you want to start
reformatting.
2. Press Alt+P.
═══ 108. Saving Files ═══
To save a file and continue editing it:
1. Select File.
2. Press Save.
If you need help, highlight the Save choice on the File menu and press F1.
═══ 109. Naming Files ═══
To name a file or change the name of a file:
1. Select File.
2. Press Rename.
Note: This only changes the name within the editor, and does not affect any
copy of the file previously saved.
═══ 110. Issuing Editor Commands ═══
To issue or process an editor command:
1. Select Command.
2. Select Command dialog.
3. Type the command.
4. Select OK.
For additional help, select Help after the window is displayed.
For a complete list of editor commands, select Editor commands below.
Related Information:
Editor commands
═══ 111. Setting Margins ═══
To set the margins:
1. Select Options.
2. Select Preferences.
3. Select Settings.
4. Select the Margins tab on the Settings notebook.
═══ 112. Help for Open ═══
Use this window to open a new edit window, following these steps:
1. Select the down arrow to the right of the Drive list to display all the
drives on your system.
2. Select a drive from the Drive list.
3. Select a directory from the Directory list.
4. Type the name of the file in the Open filename field.
5. Select Open.
Note: If you do not type a name in the Open filename field, .Untitled will be
used as the file name.
For a detailed explanation of each field, select from the list below:
o Open file name
o Type of file
o Drive
o File
o Directory
o Open
o Cancel
═══ 113. Help for Add File ═══
Use this window to add a file to the current edit window, following these
steps:
1. Select the down arrow to the right of the Drive list to display all the
drives on your system.
2. Select a drive from the Drive list.
3. Select a directory from the Directory list.
4. Select a file name from the File list or type a file name in the Open
filename field.
5. Select Add.
For a detailed explanation of each field, select from the list below:
o Open file name
o Type of file
o Drive
o File
o Directory
o Add
o Cancel
═══ 114. Help for Import Text File ═══
Use this window to retrieve a copy of a file and insert it into the current
file, following these steps:
1. Select the down arrow to the right of the Drive list to display all the
drives on your system.
2. Select a drive from the Drive list.
3. Select a directory from the Directory list.
4. Select a file name from the File list or type a file name in the Open
filename field.
5. Select Import.
For a detailed explanation of each field, select from the list below:
o Open file name
o Type of file
o Drive
o File
o Directory
o OK
o Cancel
═══ 115. Help for Open Filename ═══
Type the name of the file you want to open in the Open filename field and then
select OK.
═══ 116. Help for Save As Filename ═══
Type the name of the file you want to save in the Save as filename field and
then select Save As.
═══ 117. Help for Type of File ═══
Select the down arrow to the right of the Type of file field to display the
available file types.
═══ 118. Help for Save File as Type ═══
Select the down arrow to the right of the Save file as type field to display
the available file types.
═══ 119. Help for Drive ═══
The Drive list displays the drives on your system. Select the drive that
contains the files you want to view.
═══ 120. Help for File ═══
The File list displays all the files in the directory you selected from the
Directory list. Select the file you want to open.
═══ 121. Help for Directory ═══
The Directory list displays the directories on the selected drive. Select a
directory to display the list of files from that directory in the File list
box.
═══ 122. Help for OK ═══
Select OK to accept all choices in the window.
═══ 123. Help for Cancel ═══
Select Cancel to remove the window from the screen without saving any changes.
═══ 124. Help for Open ═══
Use this window to open a new edit window, following these steps:
1. Select a file from the selection list or type a file name in the entry
field.
2. Select OK.
Select File list to view a list of all files.
For a detailed explanation of each field, select from the list below:
o OK
o File list
o Cancel
═══ 125. Help for Add File ═══
Use this window to add a file to the current edit window, following these
steps:
1. Select a file from the selection list or type a file name in the entry
field.
2. Select OK.
Select File list to view a list of all files.
For a detailed explanation of each field, select from the list below:
o OK
o File list
o Cancel
═══ 126. Help for Import Text File ═══
Use this window to retrieve a copy of a file and insert it into the current
file, following these steps:
1. Select a file from the list box or type a file name in the entry field.
2. Select OK.
Select File list to view a list of all files.
For a detailed explanation of each field, select from the list below:
o OK
o File list
o Cancel
═══ 127. Help for Open ═══
Select Open to open a new edit window with the selected file.
═══ 128. Help for Import ═══
Select Import to place a copy of the selected file into the current file.
═══ 129. Help for Add ═══
Select Add to place the selected file into the current edit window.
═══ 130. Help for File List ═══
Select File list to display a window that enables you to access files on the
system.
═══ 131. Help for Save As ═══
Use this window to save a file and assign it a name, following these steps:
1. Select the down arrow to the right of the Drive list to display all the
drives on your system.
2. Select a drive from the Drive list.
3. Select a directory from the Directory list.
4. Select a file name from the File list or type a file name in the Save as
filename field.
5. Select Save As.
For a detailed explanation of each field, select from the list below:
o Save as filename
o Save file as type
o Drive
o File
o Directory
o Save as
o Cancel
═══ 132. Help for Save As ═══
Select Save As to store the current file with the name you entered in the file
name field.
═══ 133. Help for Print ═══
Use this window to print the current file or display a preview of your file
before printing. To print a file as raw ascii text:
1. Select Raw Ascii text.
2. Select the printer port (LPT1, for example)
3. Select Print.
To print a file as formatted text:
1. Select Formatted text.
2. Select the print queue.
3. Set any options desired.
4. Select Print.
When printing formatted text, you may specify options: which control the layout
and presentation details of the output. In addition, you can preview: the
formatted pages before spooling them to a printer.
For a detailed explanation of each field, select from the list below:
o Formatted text
o Raw Ascii text
o Queue/port
o Options
o Print
o Preview
═══ 134. Help for Raw Ascii text ═══
Select Raw ascii to copy raw text to the specified port.
═══ 135. Help for Formatted text ═══
Select Formatted text to print to the specified print queue.
═══ 136. Help for Queue/Port ═══
Specify the print destination by selecting the desired queue or port.
═══ 137. Help for Options ═══
Press Options to display the Print Options dialog.
═══ 138. Help for Print ═══
Press Print to print to the selected queue or port.
═══ 139. Help for Preview ═══
Press Preview to view the page formatting before printing.
═══ 140. Help for Print Options ═══
Use this window to specify details for formatting text for hardcopy.
Fonts used in formatted printing are controlled using the Draft/WYSIWYG
buttons. In Draft mode, the default printer font will be used; in WYSIWYG mode
the fonts displayed on screen will be used for printing.
Monochrome specifies that that the printing will be black on white regardless
of the colors displayed on screen, while Color causes the printing to respect
these colors (within the limits of the printer being used).
The printer driver Job Properties can be displayed for setting printer-specific
properties by checking the Job Properties box.
Checking Save settings will cause the printer settings and options to be saved
on exit from the print dialog for use when printing is next invoked.
Use Undo to restore the settings to their values when this window was first
displayed.
═══ 141. Help for Print Preview ═══
Use this window to view the formatted pages before printing. Upon entering,
formatted pages will be produced in the background and made available for
viewing. The current page number and total number of pages are displayed in
the upper right area of the window. '>' and '<' buttons let you move forward
and back through the set of formatted pages.
You can specify whether a given page is to be printed using the Print this page
checkbox.
The lines from your file that are included in the currently-viewed page are
shown at the bottom of the window.
═══ 142. Help for Print Mark ═══
Use this window to print the currently marked text. To print the marked text:
1. Select a printer from the list of available printers.
2. Select Draft or WYSIWYG.
For a detailed explanation of each field, select from the list below:
o Draft
o WYSIWYG
o Cancel
═══ 143. Help for Draft ═══
Select Draft to print the currently marked text in a draft mode.
═══ 144. Help for WYSIWYG ═══
Select WYSIWYG to print the currently marked text in the style shown on the
monitor. WYSIWYG stands for "What You See Is What You Get".
═══ 145. Help for Type ═══
Use this window to set a type for the current file.
1. Select a file type from the list of file types.
2. Select Set.
For a detailed explanation of each field, select from the list below:
o File type
o Set
o Cancel
═══ 146. Help for File Type ═══
The file type is an attribute of a file that describes its contents.
═══ 147. Help for Set ═══
Select Set to change the current file type to the type you selected in the
list.
═══ 148. Help for Cancel ═══
Select Cancel if you decide not to change the current settings.
═══ 149. Help for Subject ═══
Use this window to type a subject for the current file.
1. Type a line of text (up to 40 characters) that describes the current file.
2. Select Set.
For a detailed explanation of each field, select from the list below:
o Set
o Cancel
═══ 150. Help for Set ═══
Select Set to accept the text and close the window.
═══ 151. Help for Cancel ═══
Select Cancel if you decide not to type a subject.
═══ 152. EPM Editor Commands ═══
EPM supports a variety of general-purpose editing commands. Several of the
most common commands are available on the menu bar. All of the commands can be
started from the Command window. Select any of the following commands for more
information about the command:
o [#] (Go To Line)
o ACTIVATEACCEL (Activate an Accelerator Table)
o ADD (Add Block)
o ALL (Find All Text)
o APPEND (Append to File)
o ASC (Get ASCII Value)
o AUTOSAVE (Query or Set Autosave Value)
o BOTTOM (Go To Bottom)
o BOX (Box Mark)
o BROWSE (Query or Set Browse Mode)
o BUILDACCEL (Build an Accelerator Table Entry)
o BUILDSUBMENU (Build an Action Bar Pulldown)
o BUILDMENUITEM (Add Menu Item to Pulldown)
o CD (Change Directory)
o CENTER (Center Mark)
o CHANGE (Change Text)
o CHR (Get Character for ASCII Value)
o CLOSE (Close the Edit Window)
o COPY2CLIP (Copy to Clipboard)
o CURSOR_STYLE (Change cursor style)
o CUT (Cut Text)
o DEL (Delete a File)
o DELETEMENU (Delete a Menu Item)
o DICT (Specify Dictionary Name)
o DIR (Directory List)
o DISPLAY (Change Message Display Actions)
o DOLINES (Process Lines)
o DPATH (Show DPATH Setting)
o DRAW (Draw Text Graphics)
o DYNASPELL (Toggle Dynamic Spell-checking)
o ECHO (Echo Commands)
o EDIT (Edit File)
o EPATH (Edit a File in a PATH Setting)
o EPMREXX (Execute a Rexx Macro)
o ERASE Erase a File)
o ESCAPEKEY (Toggle Escape Key action)
o EXPAND (Syntax Expansion)
o FILE (Save and Quit)
o FILL (Fill Mark)
o GET (Get a File)
o GOTO (Go To a Specific Line & column)
o INSERT_ATTR_VAL_PAIR (Insert Character Attributes)
o INSERT_ATTRIBUTE (Insert Character Attribute)
o KEY (Repeat a Key)
o LIST (Find Files)
o LOCATE (Locate Text)
o LOCK (Lock a File)
o LONGNAMES (Toggle Long File Name Support)
o LOOPKEY (Repeat a Key)
o LOWERCASE (Convert Marked Text to Lowercase)
o MARGINS (Set Text Margins)
o MATCHTAB (Use Words as Tab Stops)
o MATHx (Calculate)
o MC (Execute multiple commands)
o MESSAGEBOX (Activate Message box)
o MONOFONT (Change to monospaced font)
o MULT (Multiply Block)
o NAME (Rename Current File)
o NEWWINDOW (Move Current File to a New Edit Window)
o OPATH (Open a File in a PATH Setting)
o OPEN (Open New Edit Window)
o OS2 (Process OS/2 Command)
o PASTE (Paste Text)
o PATH (Show PATH Setting)
o POSTME (Delay Command Execution)
o PRINT (Print File)
o PROFILE (Toggle Profile Setting)
o PROOF (Spell-check a File or Mark)
o PROOFWORD (Spell-check the Current Word)
o PROOF_PUNCTUATION (Specify Punctuation Characters for PROOF)
o QD (Query Date)
o QPRINT (Print File)
o QT (Query Time)
o QUIT (Quit File)
o RC (Show Return Code)
o REGISTER_MOUSE (Register Mouse Event)
o RX (Execute a Rexx Macro)
o SAVE (Save File)
o SAYERROR (Display Error Code or Message)
o SET (Show Environment Settings)
o SETMOUSEPOINTER (Set Mouse Pointer Shape)
o SHELL (Start a Command Shell)
o SHOWMENU (Activate an Action Bar Menu)
o SORT (Sort File)
o STAY (Control Cursor Position After CHANGE Command)
o SUBJECT (Display or Set File Subject)
o SYN (Look Up Synonyms)
o TABKEY (Toggle Tab Key action)
o TRIM (Trim Edit Window)
o TABS (Set Tab Stops)
o TOP (Go To Top)
o TYPE (Display or Set File Type)
o UNIVERSAL (Change Universal Variables)
o UNLOCK (Unlock a File)
o UPPERCASE (Convert Marked Text to Uppercase)
o VER (Show Editor Version)
o VERIFY (Spell-check the Current Word)
o VOL (Show Volume Label)
Related Information:
Issuing editor commands
═══ 152.1. (Go To Line) ═══
Syntax: [+|-]nnnn
Use this command to move the cursor to another line. It can be used three
ways:
nnnn
Moves to line number nnnn.
+nnnn
Moves forward (down) nnnn number of lines.
-nnnn
Moves backward (up) nnnn number of lines.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.2. ACTIVATEACCEL (Activate an Accelerator Table) ═══
Syntax: ACTIVATEACCEL [table_name]
Use ACTIVATEACCEL in a Rexx macro to activate the named accelerator table. If
no name is given, the current accelerator table (which could have been updated
with the BUILDACCEL command) is rebuilt.
Related Information:
o BUILDACCEL
═══ 152.3. ADD (Add Block) ═══
Syntax: ADD
Use ADD to add the numeric expressions in the current mark, and display the
result on the next line after the mark. The mark must be either a block mark
or a line mark.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o MULT
o MATHx
═══ 152.4. ALL (Find All Text) ═══
Syntax: ALL /search_string[/[c]]
Use ALL to create a temporary file showing all occurrences of search_string in
the current file.
The c option ignores case in the search_string. For example, "Search",
"search", and "SEARCH" are treated the same.
The delimiter used to separate search_string and the options is the first
non-blank character following "ALL."
Once the command has completed processing, use Ctrl+Q to switch between the
result file and the search file.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.5. APPEND, APP (Append to File) ═══
Syntax: APPEND or APP [filespec]
Use APPEND to add the marked text to the file filespec. If no text is marked,
the entire current file is taken as the source. The equals sign, "=" can be
used as a shorthand for various parts of the file specifier.
For convenience, filespec can be omitted if you wish to repeat an APPEND to the
same file. APPEND commands without a filespec reuse the last-specified name.
You can print a marked block of text by issuing APPEND LPTn. (But the PRINT
command prints a block if one is marked.)
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o PRINT
o Marking text
═══ 152.6. ASC (Get ASCII Value) ═══
Syntax: ASC [char]
Use ASC to display the ASCII value of the specified character. If no character
is specified, the character at the cursor is used.
Note: The ASC command is the opposite of the CHR command.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.7. AUTOSAVE (Query or Set Autosave Value) ═══
Syntax: AUTOSAVE [#### | ON | OFF | ? | DIR]
Use AUTOSAVE to display or set the autosave values. The parameters are:
[none]
Displays the current values on the message line, and places an
AUTOSAVE command in the command window where you can change it.
####
Sets the current autosave count to the specified number.
ON
Sets the current autosave count to the default value.
OFF
Sets the current autosave count to 0, turning off autosaves.
?
Displays the current values in a window, with a button you can select
to list all files in the autosave directory.
DIR
Lists all files in the autosave directory.
The autosave values displayed are the autosave count (after this many changes
are made to the file, an automatic save is done to a temporary file) and the
autosave file name (the file which is saved whenever the autosave count is
reached). The default autosave count is set through the Configure window. The
autosave path is also set in the Configure window; the autosave file name is
constructed from the autosave path, the current file name, and a unique 3-digit
extension.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.8. BOT, BOTTOM (Go To Bottom) ═══
Syntax: BOTTOM or BOT
Use BOTTOM to move the cursor position to the last line of the file.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.9. BOX (Box Mark) ═══
Syntax: BOX 1|2|3|4|5|6|C|P|A|E|B|/character
Use BOX to draw a box around the current block mark. The box type depends on
the option specified:
1
Single line.
2
Double line.
3
Dotted line.
4
Thick line.
5
Double line horizontally; single line vertically.
6
Single line horizontally; double line vertically.
C
Comment box using C language syntax.
P
Comment box using Pascal language syntax.
A
Comment box using Assembler language syntax.
E
Erases the box surrounding the block mark.
B
Box of blanks.
/character
Box of specified character.
Note: If a proportional font is used, the lines will not appear to line up
vertically even though they are in the correct columns. Use a
non-proportional font (for example, System Monospaced or Courier) if you
want the characters to line up on the screen.
Note: The single-to-double line intersections used in box styles 5 and 6 will
display as national characters in some code pages. Either change to a
different code page, or use a different box style.
Note: Graphic characters cannot be sent in mail messages.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.10. BROWSE (Query or Set Browse Mode) ═══
Syntax: BROWSE [ON | OFF | ?]
Use BROWSE to determine if the file can be updated. The parameters are:
ON
File can be read, but not updated.
OFF
File can be read and updated.
?
Browse mode (ON or OFF) is displayed.
Note: Browse mode applies to the entire edit ring, not to a specific file.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o ReadOnly command.
═══ 152.11. BUILDACCEL (Build Accelerator Table Entry) ═══
Syntax: BUILDACCEL table flags key index command
Use BUILDACCEL to add an accelerator table entry to an accelerator. table is
the name of the table to be updated; use '*' to indicate the currently active
accelerator table. flags is a combination of flags corresponding to the AF_
constants in PMWIN.H in the OS/2 Toolkit, keys is an ASCII key value if flags =
AF_CHAR; a VK_ constant from PMWIN.H if flags = AF_VIRTUALKEY, etc. (See the
EPM Technical Reference for further details.) index is a unique number (unique
in the active menu as well as the active accelerator table), and command is the
command to be executed when the key is pressed.
/* Rexx example of accelerator key definition */
AF_CHAR = 1 /* key style constants */
AF_VIRTUALKEY = 2
AF_SCANCODE = 4
AF_SHIFT = 8
AF_CONTROL = 16
AF_ALT = 32
AF_LONEKEY = 64
VK_F1 = 32
VK_ALT = 11
'buildaccel *' (AF_CHAR + AF_CONTROL) 122 9300 'sayerror Ctrl+z pressed'
/* ASCII 122 = 'z' */
'buildaccel *' (AF_CHAR + AF_CONTROL) 90 9301 'sayerror Ctrl+Z pressed'
/* ASCII 90 = 'Z' */
'buildaccel *' (AF_VIRTUALKEY + AF_ALT) VK_F1 9302 'qtime'
/* Alt+F1 tells the time */
'buildaccel * (AF_VIRTUALKEY + AF_LONEKEY) VK_ALT 9303 'sayerror F10 = action bar'
/* Block Alt key from going to the action bar. */
'activateaccel' /* No argument => use current table name. */
Related Information:
o ACTIVATEACCEL
═══ 152.12. BUILDMENUITEM (Add Menu Item to Pulldown) ═══
Syntax: BUILDMENUITEM menuname submenuid menuitemid submenutext attrib
helppanel e_command
Use BUILDMENUITEM in a Rexx macro to add menu items to an action bar pulldown.
Buildmenuitem adds a menu item to the pulldown with ID submenuid in the menu
named menuname. The text displayed on the pulldown will be submenutext (which
can not contain spaces). The attribute will be attrib (see the menu calls in
the OS/2 Technical Reference for the various attributes, or just use 0), the
help panel resid that will be displayed if the user presses F1 while the menu
item is selected is helppanel (0 if no help for that menu item), and e_command
is the command that will be executed if that menu item is selected. All the
menuitemid's must be unique.
/* Rexx sample .erx file - adds "RexxInterface" to the action bar, */
/* with two menu entries under it. */
'buildsubmenu default 1990 RexxInterface 0 0'
'buildmenuitem default 1990 1991 AddCommentFields 0 0 rx comment'
'buildmenuitem default 1990 1992 ShowRexxDateFormats 0 0 rx rxdates'
'showmenu default'
The submenuids for the standard menus are:
File 2
Edit 8
Search 3
Options 4
Command 1
Help 6
Related Information:
o BUILDSUBMENU
o DELETEMENU
o SHOWMENU
═══ 152.13. BUILDSUBMENU (Build an Action Bar Pulldown) ═══
Syntax: BUILDSUBMENU menuname submenuid submenutext attrib helppanel e_command
Use BUILDSUBMENU in a Rexx macro to create a new action bar entry. Buildsubmenu
adds a pulldown to the action bar menu named menuname, as submenu number
submenuid. The text displayed on the action bar will be submenutext (which can
not contain spaces), the attribute will be attrib (see the menu calls in the
OS/2 Technical Reference for the various attributes, or just use 0), the help
panel resid that will be displayed if the user presses F1 while the menu item
is selected is helppanel (0 if no help for that menu item), and e_command is
the command that will be executed if that menu item is selected. It should be
blank (omitted) if you want to define a pull-down; if a command is defined in
the Buildsubmenu opcode then it will act immediately. If no command is
defined, then the pull-down menu presented will be all the menu items added via
Buildmenuitem calls that specified the same submenuid.
Related Information:
o BUILDMENUITEM
o DELETEMENU
o SHOWMENU
═══ 152.14. CD (Change Directory) ═══
Syntax: CD [ [drive:]path ]
Use CD to change the current directory to the drive and path specified. If
neither drive nor path are specified, the current directory is displayed.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.15. CENTER (Center Mark) ═══
Syntax: CENTER
Use CENTER to center the text within the current mark. If the current mark is
a line mark, the text is centered using the current margins. If the current
mark is a block mark, the text is centered using the block boundaries for the
margins.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.16. CHANGE, C (Change Text) ═══
Syntax: CHANGE or C /search_string /replace_string/options
Use CHANGE to find search_string and replace it with replace_string, depending
on the options specified:
-
Searches from the current cursor position backward.
+
Searches from the current cursor position forward.
*
Replaces all occurrences of search_string with replace_string.
M
Searches within the marked area only.
A
Searches within the entire file.
C
Ignores case while searching for search_string.
E
Respects case while searching for search_string.
R
Search reversed, right to left, within each line.
F
Search forward, left to right, within each line.
G
Use the GREP algorithm.
Note: GREP strings can only be used in the search_string, not in the replace_string.
X
Use the eXtended GREP algorithm.
Note: EGREP strings can be used in the search_string, and referenced
in the replace_string.
N
(Noisy) Provide a message indicating how many changes were made.
W
Search for search_string as a separate word.
K
Match the case of each character in replace_string, to the case of
the corresponding character in search_string. If replace_string is
longer than search_string, the case of the last alphabetic character
in search_string will be used for all unmatched characters in
replace_string. For example, the command:
c /here/there/ kcw*
would change the string:
Here is an example where we
change this here HERE to THERE.
to:
There is an example where we
change this there THERE to THERE.
The default options are + A E F.
The delimiter used to separate search_string, replace_string, and the options
is the first non-blank character following C.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o Search dialog
═══ 152.17. CHR (Get Character for ASCII Value) ═══
Syntax: CHR ASCII_character_code
Use CHR to display the character associated with the ASCII_character_code
specified.
Note: The CHR command is the opposite of the ASC command.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.18. CLOSE (Close the Edit Window) ═══
Syntax: CLOSE
Use CLOSE to quit all the files in the current edit ring and close the edit
window. Before quitting any modified files in the ring, a window appears which
enables you to select Save to save the file, Discard to discard the changes, or
Cancel to cancel the close. If you select Cancel for any of the modified
files, no files are removed from the ring.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.19. COPY2CLIP (Copy to Clipboard) ═══
Syntax: COPY2CLIP
Use COPY2CLIP to copy the text within the current mark to the clipboard for
transfer to other files being edited, or to other programs.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o CUT
o PASTE
═══ 152.20. CURSOR_STYLE (Change cursor style) ═══
Syntax: CURSOR_STYLE [1 | 2 | cursor_dimensions]
Use CURSOR_STYLE to change the style of the text cursor.
Sets the cursor shape. 1 gives a GPI-style cursor (vertical bar in insert
mode), 2 gives a VIO-style cursor (underline in replace mode), and
cursor_dimensions lets you specify the exact shape cursor you want, as follows:
replace_width.replace_height insert_width.insert_height
Each width and height value can be a positive number, representing the number
of pixels wide or high the cursor should be, or a negative number, whose
absolute value represents the number of 128ths of the character width or height
the cursor should be. So, 2.-128 would represent a cursor 2 pixels wide and
the same height as the current character.
CURSOR_STYLE 1 is equivalent to CURSOR_STYLE -128.-128 2.-128
CURSOR_STYLE 2 is equivalent to CURSOR_STYLE -128.3 -128.-64
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.21. CUT (Cut Text) ═══
Syntax: CUT
Use CUT to copy the text within the current mark to the clipboard for transfer
to other files being edited, or to other programs. The marked text is deleted
from the file.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o Marking text
o COPY2CLIP
o PASTE
═══ 152.22. DEL (Delete a file) ═══
Syntax: DEL filename
Use DEL to delete a file from disk. This front-end for the OS/2 DEL command
supports the use of the equals sign, "=", as a shorthand for various parts of
the file specifier.
═══ 152.23. DELETEMENU (Delete a Menu Item) ═══
Syntax: DELETEMENU menuname submenuid menuitemid itemonly
Use DELETEMENU to delete an action bar or pulldown menu item. menuname is the
name of the menu. submenuid is the pulldown submenu that is to be deleted.
(To delete all submenus set this parameter to 0.) menuitemid is the item to
start deleting off a particular submenu (To delete all menu items under a
submenu, set this parameter to 0.) itemonly is true if it is desired to delete
only the items under a sub-menu but not the sub-menu itself.
Related Information:
o BUILDMENUITEM
o BUILDSUBMENU
o SHOWMENU
═══ 152.24. DICT (Specify Dictionary Name) ═══
Syntax: DICT [filename [...]]
Use DICT to query or set the list of dictionaries to be used when
spell-checking. If no parameter is given, tells you the current dictionary
name. If one or more dictionary names are give, they replace the current
dictionary list.
Specify the dictionary via the Settings dialog to set the default dictionary.
Related Information:
o Spell-checking support
o Command window
o Issuing editor commands
═══ 152.25. DIR (Directory List) ═══
Syntax: DIR [ path ]
Use DIR to open a temporary file containing the directory listing for the path
or the current directory, if no path is specified.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.26. DISPLAY (Change Message Display Actions) ═══
Syntax: DISPLAY number
Use DISPLAY in a Rexx macro to control message display and screen updating. A
negative number turns the display control off, and a positive number turns it
back on. You can turn on or off multiple flags in one DISPLAY call by adding
them together, provided they are all positive or negative. -1 turns off screen
update; 1 turns it back on. -2 turns off the display of messages; 2 turns it
back on. -4 forces messages to be displayed in the message box; 4 reverts to
displaying them on the message line; -8 prevents messages from being saved in
the message box list; 8 lets them be saved.
═══ 152.27. DOLINES (Executes Lines) ═══
Syntax: DOLINES
Use DOLINES to process the current line or all marked lines as though they were
typed in the Command window. The line or lines must be editor or OS/2*
commands. If a line mark exists, you are asked if you want to process all
marked lines. You can select Yes, No (to only process the current line), or
Cancel.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.28. DPATH (Show DPATH Setting) ═══
Syntax: DPATH
Use DPATH to open a temporary file containing the DPATH environment setting.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.29. DRAW (Draw Text Graphics) ═══
Syntax: DRAW 1|2|3|4|5|6|B|/character
Use DRAW to draw lines within your document, using the built-in graphics
characters. The line is drawn as you move the cursor using the up, down, left,
and right keys. The Insert key can be used to toggle drawing on and off, in
order to move the cursor without drawing lines. The type of line drawn depends
on the option specified:
1
Single line.
2
Double line.
3
Dotted line.
4
Thick line.
5
Double line horizontally; single line vertically.
6
Single line horizontally; double line vertically.
B
Blank line, for erasing other lines.
/character
Line of specified character.
Note: If a proportional font is used, the lines will not appear to line up
vertically even though they are in the correct columns. Use a
non-proportional font (for example, System Monospaced or Courier) if you
want the characters to line up on the screen.
Note: The single-to-double line intersections used in drawing styles 5 and 6
will display as national characters in some code pages. Either change
to a different code page, or use a different drawing style.
Note: Graphic characters cannot be sent in mail messages.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.30. DYNASPELL (Toggle Dynamic Spell-checking) ═══
Syntax: DYNASPELL
Use DYNASPELL to toggle dynamic spell-checking on or off for the current file.
When dynamic spell-checking is on, each word is spell-checked as it is typed,
and a warning is given for any words not found in the dictionaries or addenda.
Related Information:
o Spell-checking support
o Command window
o Issuing editor commands
o PROOF command
═══ 152.31. ECHO (Echo Commands) ═══
Syntax: ECHO [ON | OFF]
Use ECHO to switch the echo mode on or off; anything else tells you the current
value. When echo mode is on, every command is displayed in the message field
before being processed. The parameters are:
[none]
Displays current value.
ON
Every command is displayed in the message field before being
processed.
OFF
No commands are displayed.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.32. EDIT, E (Edit File) ═══
Syntax: EDIT or E [ [options] [=]file1 ][, [options] [=]file2 ]...
Use EDIT to load the specified files into the current ring, using the options
specified for each file:
/B
Search both ring and disk - the copy of the file currently in the
ring will be activated if it is present, otherwise, the file will be
searched for on disk. This is the default.
/BIN
Load the file in binary format. All line terminators will appear in
the file, and can be edited like any other character. Lines may or
may not be broken at the line terminator, depending on the presence
and position of the /nnn option. See the description of that option
for details.
/C
Create a new file with the given name.
/D
Search for the file on disk, even if a copy of the file is already
loaded into the editor.
/K
This locks the file when opening it, preventing other applications
from modifying the file. Compare this with the LOCK command, which
prevents other applications from reading as well as from writing the
file.
/K0
This will load the file only if it is not locked by another
application.
/K1
(Same as /K.)
/K2
This locks the file when opening it, preventing other applications
from reading or modifying the file.
/L
use the OS/2 and DOS convention that a new line is signified by a
carriage return followed by a line feed. Carriage returns or line
feeds standing by themself are kept as text.
/N
Search for the file in the current ring.
/Nx
Negates option /x. Recognized options are /NK, /NR, /NS, /NT, and
/NV.
/R
Loads the file in read-only mode. (See also the ReadOnly command.)
/S
Strip trailing blanks from each line when loading the file.
/T
Do not expand tabs when the file is loaded. This is the default; use
the /NT option to expand all tabs to an appropriate number of spaces
when the file is loaded. (Note that this default is different from
version 5.51 and below.)
/U
use the Unix convention that a line feed alone is sufficient to start
a new line when loading a file. Carriage returns are discarded.
(This is the default.)
/V
open a new view of a file already in the edit ring. To open a new
view of the current file, the shorthand "e /v =" can be used.
/nnn
Load the file with a maximum line length of nnn characters. Any lines
longer than that will be split into multiple lines. The fact that
the lines were split will be remembered, and the pieces will be glued
back together when the file is saved. The default is that lines will
only be broken if they are longer than the maximum line size that can
be handled. This limit is currently 1600 characters.
If the /BIN option is specified, then the relative position of the
two options controls the result. If the /BIN option appears first,
then nnn will be treated as an upper limit; lines will be broken at a
line terminator or at nnn characters, whichever comes first. If the
/nnn option appears first, then it will be given priority and the
line terminators will be ignored, so that every line will be exactly
nnn characters long (except for the last line, which might be
shorter).
The equals sign, "=" can be used as a shorthand for various parts of the file
specifier.
Commands (inside paired single quotes) can be intermixed with the file names.
The files are loaded and the commands executed in the order in which they
appear on the command line. For example:
E new.c 'get skeleton.c' 'bot'
File names containing spaces or "=" must be enclosed inside paired double
quotes. Commands containing single quotes can have the quotes doubled up. For
example:
e "c:\This name contains spaces" 'L /It''s'
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.33. EPATH, EP (Edit a File in a PATH Setting) ═══
Syntax: EPATH or EP filespec [pathname]
Use EPATH to search an environment setting for the specified file and load it.
The path name defaults to EPMPATH, except if the file specifier extension is
CMD; then the path name defaults to PATH. '=' may be specified, to indicate
the name of the current file (without the drive or path). Examples:
ep mycnf.e
Searches the EPMPATH setting for MYCNF.E.
ep test.cmd
Searches the PATH setting for TEST.CMD.
ep main.c include
Searches the INCLUDE setting for MAIN.C.
The search order is:
1. The current directory
2. Each directory listed in the path setting
If the file is found in the search path, it is loaded from that subdirectory.
If not, an empty file with that name will be loaded. The path will default to
the current directory.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.34. ERASE (Erase Files) ═══
Synonym for the DEL command.
Related Information:
DEL
═══ 152.35. ESCAPEKEY (Toggle Escape Key Action) ═══
Syntax: ESCAPEKEY [ON | OFF]
Use ESCAPEKEY to switch the escape key mode on or off; anything else tells you
the current value. When escape key mode is on, the escape key can be used to
bring up the command line dialog (just like Ctrl+I). This is for compatability
with previous versions of EPM. The default is escape key mode off.
You must issue this command from the Command window.
To save the current escape key mode setting as your permanent default:
1. Select Options.
2. Select Save options.
Related Information:
o Command window
o Issuing editor commands
═══ 152.36. EXPAND (Syntax Expansion) ═══
Syntax: EXPAND [ON | OFF]
Use EXPAND to set syntax expansion ON or OFF. If no parameters are given, the
current value is displayed.
Syntax expansion occurs when Space or Enter is pressed while a file with a
supported language-specific extension is active (for example C, PAS, or CMD).
When automatic expansion is off, you can force expansion to occur by pressing
Ctrl+X.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.37. FILE (Save and Quit) ═══
Syntax: FILE [ [=]filename ] [options]
Use FILE to store the file (using the file name specified, or the current file
name) and quit editing the file.
If "=" is specified, filename is prefixed with the drive and path of the
current file.
See the SAVE command for the list of valid options.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o SAVE command
═══ 152.38. FILEFIND (Find Files) ═══
Synonym for the LIST command.
Related Information:
LIST
═══ 152.39. FILL (Fill Mark) ═══
Syntax: FILL [ character ]
Use FILL to fill the current mark with the character specified. If no
character is given, a dialog will be presented asking for one.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.40. FINDFILE (Find Files) ═══
Synonym for the LIST command.
Related Information:
LIST
═══ 152.41. GET (Get a File) ═══
Syntax: GET filespec
Use GET to retrieve a file and insert it starting on the next line after the
cursor position. The equals sign, "=" can be used for various parts of the
file specifier.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.42. GOTO (Go To a Specific Line & Column) ═══
Syntax: GOTO line [col]
Use GOTO to position the cursor at a specific line and column. This command is
intended primarily for passing on the command line when starting the editor
from an external program. For example, from a Rexx command file:
"start EPM" sourcefile " 'goto" error_line error_col " ' "
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.43. HELP (Open Help Browser) ═══
Syntax: HELP
Use HELP to load the EPMHELP.QHL file into a browse-mode window, which displays
help information.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.44. INSERT_ATTR_VAL_PAIR (Insert Character Attributes) ═══
Syntax: INSERT_ATTR_VAL_PAIR class attr_val [fstline lstline fstcol lstcol
[fid]]
Use INSERT_ATTR_VAL_PAIR in a Rexx macro to insert push and pop attributes as a
pair into a file. class is the attribute class; attr_val is the attribute
value; fstline lstline fstcol lstcol refer to the beginning and ending
characters where the attributes are to be inserted (if omitted, then a mark
must exist, and the attributes are inserted at the beginning and end of the
mark; for a block mark, at the left and right sides of the mark on each line),
and fid is the identifier of the file into which the attributes should be
inserted (if omitted, it defaults to the current file).
/* Rexx macro to highlight the subject line */
/* Assumes .levelofattributesupport has '1' turned on */
/* to enable color display. */
BLACK = 0; BLUE = 1; GREEN = 2; CYAN = 3; RED = 4; MAGENTA = 5; BROWN = 6;
LIGHT_GREY = 7; DARK_GREY = 8; LIGHT_BLUE = 9; LIGHT_GREEN = 10;
LIGHT_CYAN = 11; LIGHT_RED = 12; LIGHT_MAGENTA = 13; YELLOW = 14;
WHITE = 15; BLACKB = 0; BLUEB = 16; GREENB = 32; CYANB = 48; REDB = 64;
MAGENTAB = 80; BROWNB = 96; GREYB =112; LIGHT_GREYB =112;
DARK_GREYB =128; LIGHT_BLUEB =144; LIGHT_GREENB =160; LIGHT_CYANB = 176;
LIGHT_REDB =192; LIGHT_MAGENTAB =208; YELLOWB =224; WHITEB =240;
'l /Subject:/c'
if rc = 0 then do /* Found it! */
'extract /line/col'
'Insert_attr_val_pair 1' (Light_Magenta + Light_CyanB) ,
line.1 line.1 col.1 (col.1 + 7)
end
Related Information:
o Insert_attribute
═══ 152.45. INSERT_ATTRIBUTE (Insert Character Attribute) ═══
Syntax: INSERT_ATTRIBUTE class attr_val push_flag offset [col [line [fid]]]
Use INSERT_ATTRIBUTE in a Rexx macro to insert a character attribute into a
file. class is the attribute class; attr_val is the attribute value; push_flag
is 1 for push, 0 for pop, or the value appropriate for the attribute class
specified. offset is the offset from the character at which the attribute
should be inserted; line and col are the position at which the attribute should
be inserted, and default to the cursor position; and fid is the identifier of
the file into which the attributes should be inserted (if omitted, it defaults
to the current file).
Related Information:
o Insert_attr_val_pair
═══ 152.46. KEY (Repeat a Key) ═══
Syntax: KEY #### character
Use KEY to repeat a character horizontally the specified number of times. This
can be quite powerful; for example, you can repeat an entire set of recorded
keystrokes (Ctrl+T) 20 times. Example:
KEY 80 =
This writes a line of 80 equal signs into your document.
Character can be a normal ASCII character, or a string representing an extended
ASCII character.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o LOOPKEY
═══ 152.47. LIST (Find Files) ═══
Syntax: LIST filespec
Use LIST to load a list of file names that match filespec. If filespec includes
a path, then that directory is used as the starting point; if not, the current
directory is used. Both the starting directory and any subdirectories are
searched for matching files. This may take a significant amount of time (a
minute or more) if you name a filespec that qualifies an entire hard disk, such
as
list \*.*
Once you have the list, you can place the cursor on the name of a file, and
then press Alt-1 to edit that file.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.48. LOCATE, L (Locate Text) ═══
Syntax: LOCATE or L /searchstring/options
Use LOCATE to find searchstring depending on the options specified:
-
Searches from the current cursor position backward.
+
Searches from the current cursor position forward.
M
Searches within the marked area only.
A
Searches within the entire file.
C
Ignores case while searching for searchstring.
E
Respects case while searching for searchstring.
R
Search reversed, that is from right to left, within each line.
F
Search forward, this is from left to right, within each line.
G
Use the GREP algorithm.
X
Use the eXtended GREP algorithm.
W
Search for search_string as a separate word.
~
Search for a line which does not contain search_string. If
successful, the cursor will be positioned at the starting point of
the search for that line (the cursor position, if found on the first
line, or the left edge of the mark if the M option was used and a
block mark exists, or else column 1), and the length of the match
will be the remainder of the line.
The default options are + A E F.
The delimiter used to separate searchstring, replacestring, and the options is
the first non-blank character following L.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o Search dialog
═══ 152.48.1. GREP option ═══
Use the GREP option, /g (see note below), to specify special pattern-matching
characters within the search string. These characters are:
. (period)
Matches any character.
^
Matches the beginning of a line.
$
When following search string, matches the end of a line.
\ character
Matches character; used to override any special meaning given to
characters.
[list_of_characters]
Matches any of the characters in the list.
A list of characters can be indicated as a range using the hyphen (-)
For example, [a-z] matches with any letter of the alphabet. If the
first character after the [ is a ^, then the set is negated, (because
it matches any character except those in the set).
*
Matches a sequence of 0 or more of whatever expression it follows.
+
Matches a sequence of 1 or more of whatever expression it follows.
A simple example of using GREP is to use the combination .* (0 or more
iterations of any character) as a wildcard. The command
Locate /pro.*ure/ g
will locate any string beginning with pro and ending with ure. For example, it
will match procedure, procure, or proactive haute couture. If you don't want
to find the last string, you can search for pro, followed by a sequence of 0 or
more of any character except a space, and then ending with ure:
Locate /pro[^ ]*ure/ g
Additional examples are presented that search the following file:
soft
good junk
and more
stuff
even good
123456
l
do,re,mi,fa,so,la,ti,do
$35
Example searches using GREP:
/l./g
Finds "la".
/^good/g
Finds only first occurrence of "good".
/good$/g
Finds only "even good".
/\$/g
Finds "$35".
/^[m-t]/g
Finds "soft" and "stuff".
/^[caret.adeg]/g
Finds "soft", "stuff", "123456", "l", and "$35".
/caret.[m-t]+/g
Finds "soft" and "stuff".
/caret.[m-t]*/g
Finds everything.
Note: The above examples are as you would enter them on the EPM command line.
When using the Search dialog, you would enter the search string
(everything between the '/') in the Search field, and select the Grep
option in the Options section of the dialog.
═══ 152.48.2. EGREP option ═══
Use the EGREP (extended GREP) option, /x, to specify special pattern-matching
characters within the search string. These characters include all those
described under the GREP option, plus the following search string additions:
'\b' matches a backspace character.
'\c' Specifies the cursor position if a match is found.
'\f' matches a form feed character.
'\n' matches a newline character.
'\r' matches a carriage return character.
'\t' matches a tab character.
'\x'HH matches a character with ASCII code 0xHH.
'\z' matches an ASCII NUL character (0x00).
':a' matches an alphabetic character; equivalent to [a-zA-Z]
':c' matches a C language identifier; equivalent to [a-zA-Z_$][a-zA-Z0-9_$]*
':d' matches a digit; equivalent to [0-9]
':f' matches a C language function definition; optimized for usage in C tags
support.
':h' matches a hexadecimal number; equivalent to [0-9a-fA-F]+
':i' matches an integer; equivalent to [0-9]+
':n' matches an alphanumeric character; equivalent to [a-zA-Z0-9]
':o' matches optional whitespace; equivalent to [ \t]*
':q' matches a quoted string; equivalent to "[^"]*"|'[^']*'
':r' matches a Rexx language identifier; equivalent to
[a-zA-Z!?_][a-zA-Z0-9!?_]*
':w' matches whitespace; equivalent to [ \t]+
':x' matches a hexadecimal digit; equivalent to [0-9a-fA-F]
'|' alternation, matches either what appears on the left or what appears on
the right.
'(' ')' parentheses are used for grouping, and also for creating subexpressions
for use in the replacement string.
'~' negation, fails if the following string or expression is present
'@' Minimally matches a sequence of 0 or more of whatever expression it
follows. (Similar to '*', but '*' does a maximal match.)
'#' Minimally matches a sequence of 1 or more of whatever expression it
follows. (Similar to '+', but '+' does a maximal match.)
Note: The classes that match more than one character are more efficient than
the equivalent shown, because (for example) :w will match all whitespace
as a single unit, whereas [ \t]+ could back up over each matched
character in an attempt to match what follows in the search string.
Extended grep also adds the following replacement string additions:
'&' represents the entire matched string
'\'n (where n is '0' - '9') represents the corresponding subexpression of
the matched string. Each subexpression refers to the contents of a
parenthesized expression, where \1 represents the string matched
between the first open parenthesis and its corresponding close
parenthesis, \2 the second, etc., and \0 represents the entire match
(equivalent to '&').
The full syntax for this option is:
\[[+|-]width[,|;]]n
If a width is specified, that number of characters is taken up. '+'
means that the substring is left-aligned; '-' means that the substring
is right-aligned. The excess space is filled with blanks. If the
substring is wider than the width specified, then if the delimiter
between width and n is ',' the entire string will be used (resulting in
a field wider than width characters); if the delimiter is ';' then the
excess will be truncated. (The truncation always occurs on the right,
regardless of the alignment specified.)
'\&' represents the '&' character.
'\\' represents the '\' character.
'\b' represents a backspace character.
'\f' represents a form feed character.
'\n' represents a newline character.
'\r' represents a carriage return character.
'\t' represents a tab character.
'\x'HH represents a character with ASCII code 0xHH.
'\z' represents an ASCII NUL character (0x00).
Some examples:
/pro(gram|cedure)/ x
matches 'program' or 'procedure'.
/function:o\(:o\c/ x
matches 'function', optionally followed by spaces or tabs, followed
by an open parenthesis, and places the cursor on the first non-blank
character after the parenthesis.
c /id=(:c)/id='\1'/ x*
changes all strings of the form id=some_string to id='some_string'.
(I.e., it adds single quotes around the parameter, no matter what it
was.)
c /(myfunc:o\()([^,]*,)/\1 Global, \2 NULL,/*x
adds a new first and third parameter to all 'myfunc' calls. The
first parenthesized expression matches 'myfunc', optional whitespace,
and an open parenthesis. The second matches everything up to the next
comma. The replacement string uses both of these, adds ' Global, '
after the open parenthesis, and adds the string ' NULL,' at the end.
This would convert 'myfunc(first, second)' to 'myfunc( Global, first,
NULL, second)'.
/DosFree~Seg)/ x
Matches an occurrence of the string 'DosFree', which is not followed
by 'Seg'.
c =/\*(.*)\*/=/*\+40,1*/= x*
would change the following lines:
/* This is a comment */
/* This is another comment */
/* This is yet one more comment */
to:
/* This is a comment */
/* This is another comment */
/* This is yet one more comment */
while changing the '+' to a '-' would make the result:
/* This is a comment */
/* This is another comment */
/* This is yet one more comment */
Changing the '+40' to '+25' would yield:
/* This is a comment */
/* This is another comment */
/* This is yet one more comment */
(note that the last string is longer), while changing the '+40,' to
'+25;' would truncate the middle portion after 25 characters:
/* This is a comment */
/* This is another comment */
/* This is yet one more com*/
Note: The extended GREP code was originally based on code written by Henry
Spencer of the University of Toronto.
═══ 152.49. LOCK (Lock a File) ═══
Syntax: LOCK [filespec]
Use LOCK to protect the disk copy of the file from other users in a LAN
networking situation. If a file name is specified, it is loaded and then
locked; if no file name is given, the current file is locked. Other
applications are prevented from reading or writing the locked file.
Compare this with the /K option of the EDIT command, which prevents other
applications from writing the file, but which does allow them to read the file.
The file is unlocked automatically after a FILE or QUIT command, or it can be
unlocked manually with the UNLOCK command.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o FILE
o QUIT
o UNLOCK
═══ 152.50. LONGNAMES (Toggle Long Names Setting) ═══
Syntax: LONGNAMES [ON | OFF]
Use LONGNAMES to switch the long names setting on or off; anything else tells
you the current value. When long names is on, a file containing a .LONGNAMES
extended attribute will have the extended attribute value shown on the title
bar when being edited, rather than the actual file name. This is useful if a
file with a long name is copied from an HPFS drive to a FAT drive and has the
original name saved in .LONGNAME; you will be able to see the long name instead
of the truncated name. The default is long names mode off.
You must issue this command from the Command window.
To save the current long names mode setting as your permanent default:
1. Select Options.
2. Select Save options.
Related Information:
o Command window
o Issuing editor commands
═══ 152.51. LOOPKEY (Repeat a Key) ═══
Syntax:LOOPKEY [#### | ALL] character
Use LOOPKEY to repeat the character in a vertical column. The character is
typed #### times, proceeding vertically downward in the current column.
(Compare this to the KEY command, which repeats the key horizontally in the
same row.) The parameter ALL can be used instead of a number, in which case
the repetition continues to the end of the file.
Character can be a normal ASCII character, or a string representing an extended
ASCII character.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.52. LOWERCASE (Convert Marked Text to Lowercase) ═══
Syntax: LOWERCASE
Use LOWERCASE to convert all uppercase alphabetic characters in the marked area
to lowercase.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.53. MARGINS, MA (Set Text Margins) ═══
Syntax: MARGINS or MA [ left [ right [ paragraph]]]
Use MARGINS to set specified values for the margins. If right or paragraph is
omitted, the default values are as follows:
Omitted Default Value
right
The previous right margin value is used for the current value.
paragraph
The value for left is used for the current value.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.54. MATCHTAB (Use Words as Tab Stops) ═══
Syntax: MATCHTAB [ON | OFF]
If set on, Tab and Shift+Tab use the previous line's columns for the current
line's tab stops. The previous line's columns are defined by the first
character of each (space-delimited) word. If no parameter is given, the
current value is displayed.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.55. MATHx (Calculate) ═══
Syntax: MATH|MATHX|MATHO expression
Use MATHx to calculate the value of expression and display the result according
to the command specified:
MATH
Decimal.
MATHX
Hexadecimal.
MATHO
Octal.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o MULT
═══ 152.56. MC (Execute multiple commands) ═══
Syntax: MC [/ command]...
Use MC to issue multiple commands where one is expected. The delimiter is the
first non-blank character after the MC command, and need not be a '/'. Some
examples:
mc /bot/get template/+5
mc +top +c /Sample/Product/* +top +c /IBM/XYZ/*
Related Information:
o Command window
o Issuing editor commands
═══ 152.57. MESSAGEBOX (Activate Message Box ) ═══
Syntax: MESSAGEBOX [message]
Use MESSAGEBOX to display the editor message box. If a message is given, it is
added to the message box.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.58. MONOFONT (Change to monospaced font) ═══
Syntax: MONOFONT
Use MONOFONT to change to a monospaced font - a font in which all characters
take up the same width on the screen. A monospaced font is required to have
columns of tabular information line up, and to make best use of block marking.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.59. MULT (Multiply Block) ═══
Syntax: MULT
Use MULT to multiply the numeric expressions in the current mark and to display
the result on the next line after the mark. The mark must be either a block
mark or a line mark.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o ADD
o MATHx
═══ 152.60. NAME (Rename Current File) ═══
Syntax: NAME filename
Use NAME to rename the file in the editor. The Name command does not change
the name of the file on the disk. The new name is used the next time the file
is stored on the disk.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.61. NEWWINDOW (Move Current File to a New Edit Window) ═══
Syntax: NEWWINDOW
Use NEWWINDOW to store the current file if it has been changed, open a new
window containing the file, then quit the file in the current window.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.62. OPATH, OP (Open a File in a PATH Setting) ═══
Syntax: OPATH or OP filespec [pathname]
Use OPATH to search an environment setting for the specified file and load it
into a new window. The path name defaults to EPMPATH, except if the file
specifier extension is CMD, then the path name defaults to PATH. Examples:
op mycnf.e
Searches the EPMPATH setting for MYCNF.E.
op test.cmd
Searches the PATH setting for TEST.CMD.
op main.c include
Searches the INCLUDE setting for MAIN.C.
The search order is:
1. The current directory
2. Each directory listed in the path setting
If the file is found, it is loaded from that subdirectory. If not, it is loaded
without specifying a directory (which defaults to the current directory).
Note: OPATH is like EPATH, except that it executes an OPEN command instead of
an EDIT command.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o EPATH
o OPEN
o EDIT
═══ 152.63. OPEN (Open New Edit Window) ═══
Syntax: OPEN [ [=]file1 ][, [=]file2 ]...
Use OPEN to load the specified files into a new edit window.
If "=" is specified, the file name is prefixed with the drive and path of the
current file.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o EDIT
═══ 152.64. OS2 (Execute OS/2 Command) ═══
Syntax: OS2 [command_etc]
Use OS/2 to run the OS/2* command processor specified in the COMSPEC
environment variable. If command_etc is specified, it is passed as an
parameter to the command processor.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.65. PAGEBREAK (Add a Page Break) ═══
Syntax: PAGEBREAK
Use PAGEBREAK to insert a page break before the current line, for use when
doing formatted printing.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.66. PASTE (Paste Text) ═══
Syntax: PASTE [C | B]
Use PASTE to copy text from the clipboard to the editor file at the current
cursor position. The default is to paste the text as lines (each line in the
clipboard becomes a new line in the file).
C
The text is pasted as if it were inside a character mark.
B
The text is pasted as if it were in a block mark (the smallest
rectangle that would contain all the clipboard text).
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o Mark types
o COPY2CLIP
o CUT
═══ 152.67. PATH (Show PATH Setting) ═══
Syntax: PATH
Use PATH to open a temporary file containing the PATH environment setting.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.68. POSTME (Delay Command Execution) ═══
Syntax: POSTME command
Use POSTME to defer execution of a command. The POSTME command posts its
argument back to the edit window as a command to be executed. This would
normally be issued either from a Rexx command file or when passing commands to
EPM when starting up the editor. For example, if you wanted to edit a file and
set the margins to 1 and 72, you might try the following:
start epm myfile 'ma 1 72'
This would not work as desired, however, because after the file is loaded and
the margins are set by your command, a DEFLOAD event occurs, which sets the
tabs and margins to the values saved from the Settings dialog. To get the
desired result, you must use the POSTME command to delay execution of the
MARGINS command until after the DEFLOAD processing has occurred:
start epm myfile 'postme ma 1 72'
Related Information:
o Command window
o Issuing editor commands
═══ 152.69. PRINT (Print File) ═══
Syntax: PRINT [ printer ]
Use PRINT to print the marked block, if one exists, or the entire file to the
printer specified. Printer must be PRN, LPT1-LPT9, or a LAN printer name
(\\servername\queuename). If no printer is specified, the printer used is the
default printer for your system.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o Printing to a print queue
═══ 152.70. PROFILE (Toggle Rexx Profile Support) ═══
Syntax: PROFILE [ON | OFF]
Use PROFILE to switch the profile setting on or off; anything else tells you
the current value. When PROFILE is on, a Rexx profile (PROFILE.ERX) is
searched for along the EPMPATH and PATH. If found, it is executed, and passed
the same arguments that EPM was given. This happens after EPM has processed
the arguments. The default is profile mode off.
You must issue this command from the Command window.
To save the current profile mode setting as your permanent default:
1. Select Options.
2. Select Save options.
Related Information:
o Command window
o Issuing editor commands
═══ 152.71. PROOF (Spell-check a File or Mark) ═══
Syntax: PROOF [word]
Use PROOF to start a spell-check of the marked text or, if no mark exists, of
the current file. It can also be used to spell-check a specific word, passed
as the argument.
Related Information:
o Spell-checking support
o Command window
o Issuing editor commands
o PROOFWORD command
═══ 152.72. PROOFWORD (Spell-check the Current Word) ═══
Syntax: PROOFWORD
Use PROOFWORD to spell-check the current word in the file.
Related Information:
o Spell-checking support
o Command window
o Issuing editor commands
o PROOF command
═══ 152.73. PROOF_PUNCTUATION (Specify Punctuation Characters for PROOF) ═══
Syntax: PROOF_PUNCTUATION [character]...
Use PROOF_PUNCTUATION to specify the list of characters which should be
considered as being punctuation when spell-checking a file. The default set of
punctuation is:
~!@#$ЫЬЭ%^&*()_+|`1234567890-=\{}[]:";'<>?,./к─═╔╗╚╝┌┐└┘║╦╠╣╩╬┬├┤┴┼│
Related Information:
o Spell-checking support
o Command window
o Issuing editor commands
o PROOF command
o PROOFWORD command
═══ 152.74. QPRINT (Print File) ═══
Syntax: QPRINT [ flags ] [ queue_name ]
Use QPRINT to print the marked block or the entire file (depending on the flags
specified) to the printer queue specified. If no parameters are specified, this
invokes the print dialog, just as though File / Print File had been selected.
Flag Meaning
M Print marked area rather than entire file.
F Print entire file. As this is the default, it need only be specified if a
queue_name is being specified which could be confused with one of these
flags.
! Start printing immediately; don't wait for the user to select Print in the
print dialog.
M! A combination of the M and ! options.
F! A combination of the F and ! options.
Note: queue_name must be the physical name of the print queue, as shown on the
first page of the printer's Settings dialog, not the logical name (which
is shown on the desktop, and in the Print dialog).
If no queue_name is specified, the default will be the one last used by EPM,
or the default printer for your system if this is the first time printing from
EPM.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o Printing to a printer port
═══ 152.75. QUIT, Q (Quit a File) ═══
Syntax: QUIT or Q
Use QUIT to exit the current file. If there are more files in the edit ring,
the previous file becomes the current file. If there are no more files, the
edit window closes.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.76. QDATE, QD (Query Date) ═══
Syntax: QDATE or QD
Use QDATE to display the current system date in the form:
Today is Tuesday March 31, 1992.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o QTIME
═══ 152.77. QTIME, QT (Query Time) ═══
Syntax: QTIME or QT
Use QTIME to display the current system time in the form:
The time is 12:00:01 am.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o QDATE
═══ 152.78. RC (Show Return Code) ═══
Syntax: RC command
Use RC to execute the specified command and display the return code in the
information window. The command can be either an editor or an OS/2* command.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.79. READONLY (Query or Set ReadOnly Mode) ═══
Syntax: READONLY [ON | OFF | ?]
Use READONLY to determine if the file can be updated. The parameters are:
ON
File can not be updated.
OFF
File can be viewed and updated.
?
Readonly mode (ON or OFF) is displayed.
Note: Readonly mode applies to a specific file.
Related Information:
o Command window
o Issuing editor commands
o Browse command.
o Edit command (see /R option).
═══ 152.80. REGISTER_MOUSE (Register Mouse Event) ═══
Syntax: REGISTER_MOUSE which button action shifts command
Use REGISTER_MOUSE in a Rexx macro to associate a command with a mouse event.
which is 1 for the global mouse table or 0 for the local; button is the mouse
button (1, 2 or 3), action is one of:
Action meaning
CLICK Pressing and releasing the mouse button produces a click.
SECONDCLK follows click when the mouse is double-clicked.
BEGINDRAG this is called when the mouse button is depressed and the mouse is
moved.
ENDDRAG this is called when the mouse button is released after dragging it.
CANCELDRAG. this is called when the drag is cancelled (by pressing Esc before
releaseing the mouse button).
shifts is 0 for no shift, or the sum of any combination of 1 for the shift key,
2 for the Ctrl key, and 4 for the Alt key. command is the command to be
executed when this mouse event occurs, or blank if the event should be ignored.
Note: The standard mouse definitions issue a register_mouse for ENDDRAG and
CANCELDRAG as part of the BEGINDRAG processing.
/* Register an action for Ctrl+Alt+Double-click MB1 */
'register_mouse 1 1 SECONDCLK 6 rx do_line'
/* Do_Line.erx */
'MH_gotoposition' /* Move cursor to mouse position */
'extract /line/getline'
if line.1 > 0 then
getline.1 /* Execute the line as a command */
═══ 152.81. RX, EPMREXX (Execute a Rexx Macro) ═══
Syntax: RX | EPMREXX macro_name [args]...
Use RX to execute the specified Rexx macro. The default extension is .erx. If
the drive and directory are not specified, the macro will be searched for (by
the Rexx executor) along the PATH.
Note: The Rexx profile, PROFILE.ERX, is searched for along the EPMPATH as well
as the PATH, but this search is done by EPM, not Rexx, in order to avoid
an error message if the profile is enabled but PROFILE.ERX does not exist.
You must issue this command from the Command window.
Related Information:
o Rexx macros in EPM
o Rexx profile support
o Command window
o Issuing editor commands
═══ 152.82. SAVE, S (Save File) ═══
Syntax: SAVE or S {option} [[=]filename ]
Use SAVE to store the current file on the disk with the name filename, or using
the current file name if filename is not specified.
If "=" is specified, filename is prefixed with the drive and path of the
current file. option can be any of the following. If conflicting options are
specified, the last one given is used.
/L
Save the file with just a line feed terminating every line.
Note: This is different than EPM 5.51 and below, which used /L to
mean what EPM 5.60 & above use /O for.
/NE
Do not add an EOF character at the end of the file.
/NS
Do not strip trailing spaces.
/O
Save the file in standard OS/2 format - each line should be
terminated with a carriage return followed by a line feed.
/Q
Save quietly; don't give the "Saving" message.
/S
Strip trailing spaces from each line when saving.
/T
Converts excess blank characters to tabs.
/U
Save in Unix format; each line will be terminated with just a line
feed, and no EOF will be added at the End of File. This is useful
when saving files to NFS-mounted drives on an AIX or Unix system.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.83. SAYERROR (Display Error Code or Message) ═══
Syntax: SAYERROR expression
Use SAYERROR to display an error code or message in the message area.
If expression is the number 0 or 1, any pending error messages are discarded
and not displayed. 0 will refresh the screen; 1 will not.
If expression is any number other than 0 or 1, the interpreter displays the
string corresponding to that numbered error message. Error messages and their
corresponding return codes are listed in the EPM Technical Reference.
If expression is not a number, that text will be displayed on the message line.
This is useful in Rexx macros.
═══ 152.84. SET (Show Environment Settings) ═══
Syntax: SET
Use SET to open a temporary file containing all the environment settings.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.85. SETMOUSEPOINTER (Set Mouse Pointer Shape) ═══
Syntax: SETMOUSEPOINTER style
Use SETMOUSEPOINTER to set the mouse pointer style to one of the following
styles:
1 default mouse pointer (arrow)
2 default text entry pointer (I-beam)
3 wait pointer (clock or hourglass)
4 size pointer (invisible)
5 four direction arrow
6 arrow northwest southeast
7 arrow northeast southwest
8 arrow west east
9 arrow north south
10 applications icon
11 information icon
12 question mark icon
13 error icon
14 exclamation mark icon
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.86. SHELL (Start EPM Command Shell Session) ═══
Syntax: SHELL
Use SHELL to create an EPM command shell session. The first time you enter
SHELL in an edit window, two new entries are added to the Command menu. Create
command shell creates a new shell window, and Write to shell... lets you write
a string to the shell window. If the shell window is waiting at an OS/2
command prompt, then you can enter a command to be executed by either:
1. Select Command.
2. Select Write to shell....
3. Type the text to be written to the shell.
4. Select OK.
or
1. Type the text in the shell window following the prompt.
2. Press the Enter key.
If the string to be written to the shell is in response to a program prompt,
then you must perform the first sequence; the second method won't write
anything to the shell.
The shell can be used for running any non-fullscreen OS/2 program. The output
from the program is inserted in the shell window as it is generated, even if
you switch to some other file in the edit ring.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.87. SHOWMENU (Activate Menu) ═══
Syntax: SHOWMENU menuname
Use SHOWMENU to activate the action bar named menuname. Changes made with the
BuildSubMenu and BuildMenuItem commands will not be seen until the updated menu
is displayed with ShowMenu.
Related Information:
o BUILDMENUITEM
o BUILDSUBMENU
o DELETEMENU
═══ 152.88. SORT (Sort File) ═══
Syntax: SORT [R][C][I]
Use SORT to sort the lines in the current block or the entire file. The sort
key is the marked columns. The options are as follows:
R
Sorts in reverse (descending) order.
C
Sorts according to collating order, as indicated by your country and
code page settings.
I
Sorts ignoring case.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.89. STAY (Control Cursor Position after CHANGE Command) ═══
Syntax: STAY [ON | OFF]
Use STAY to control the position of the cursor after a CHANGE command. The
parameters are:
[none]
Displays current value of STAY.
ON
Cursor remains in original position after CHANGE.
OFF
Cursor moves to the last changed string.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o CHANGE
═══ 152.90. SUBJECT (Display or Set File Subject) ═══
Syntax: SUBJECT
Use SUBJECT to display, set, or change the file subject field.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.91. SYN (Look Up Synonyms) ═══
Syntax: SYN
Use SYN to look up synonyms for the current word. If found, a listbox is
presented from which you can select a synonym to replace the current word.
Related Information:
o Spell-checking support
o Command window
o Issuing editor commands
═══ 152.92. TABKEY (Toggle TAB Key Action) ═══
Syntax: TABKEY [ON | OFF]
Use TABKEY to switch the tab key mode on or off; anything else tells you the
current value. When tab key mode is on, the tab key will enter a tab
character. When TAB key mode is off, the tab key will move the cursor to the
next tab stop without typing in a tab character. The default is tab key mode
off.
You must issue this command from the Command window.
To save the current tab key mode setting as your permanent default:
1. Select Options.
2. Select Save options.
Related Information:
o Command window
o Issuing editor commands
═══ 152.93. TABS (Set Tab Stops) ═══
Syntax: TABS [ inc | tab1 tab2... tab32 ]
Use TABS to set the tab stops according to the options specified:
inc
Sets 32 tab stops, beginning with 1, inc spaces apart.
tab1 tab2 ... tab32
Sets up to 32 tab stops at the specified locations.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.94. TOP (Go To Top) ═══
Syntax: TOP
Use TOP to move the cursor position to the first line of the file.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.95. TRIM (Trim Edit Window) ═══
Syntax: TRIM
Use TRIM to resize the edit window so that no partial characters can be seen at
the right or bottom edge of the edit window.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.96. TYPE (Display or Set File Type) ═══
Syntax: TYPE
Use TYPE to display, set, or change the file type.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.97. UNIVERSAL (Change Universal Variables) ═══
Syntax: UNIVERSAL variable_name [value]
Use UNIVERSAL in a Rexx macro to update some internal universal variables
without having to recompile the macros. variable_name can be one of
default_search_options Options used by the Locate command and initial values
for the Search dialog.
default_edit_options Options used by the Edit command
default_save_options Options used by the Save command
value is the value to be set in the universal variable, and can be blank. The
value of these variables is inserted before any options passed on the command
line, so these defaults can be overridden on any specific command.
/* Profile.erx - initializations for a new edit window */
/* Make the default search be case-insensitive */
'universal default_search_options C'
/* No Tabs - expand them to spaces when loading a file */
'universal default_edit_options /nt'
/* Strip trailing blanks when saving a file */
'universal default_save_options /s'
═══ 152.98. UNLOCK (Unlock a File) ═══
Syntax: UNLOCK [filespec]
Use UNLOCK to unlock the current or specified file, which must have been locked
using the LOCK command.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
o LOCK
═══ 152.99. UPPERCASE (Convert Marked Text to Uppercase) ═══
Syntax: UPPERCASE
Use UPPERCASE to convert all lowercase alphabetic characters in the marked area
to uppercase.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.100. VER (Show Editor Version) ═══
Syntax: VER
Use VER to display the version number of the editor.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 152.101. VERIFY (Spell-check the Current Word) ═══
See the PROOFWORD command.
═══ 152.102. VOL (Show Volume Label) ═══
Syntax: VOL [drive]
Use VOL to open a temporary file containing the volume label of the specified
(or default) drive.
You must issue this command from the Command window.
Related Information:
o Command window
o Issuing editor commands
═══ 153. Equals ═══
The equals sign, "=", can be used when specifying a new file name to refer the
current file path, file name, and extension, depending on where it appears.
For example, assume the current directory is C:\EDIT, and the current file is
C:\MYDOC\PROG\FOO.DOC.
=
C:\MYDOC\PROG\FOO.DOC.
=bar.zot
C:\MYDOC\PROG\BAR.ZOT.
C:\EDIT\=
C:\EDIT\FOO.DOC.
.\=
C:\EDIT\FOO.DOC.
=bar.=
C:\MYDOC\PROG\BAR.DOC.
=.new
C:\MYDOC\PROG\FOO.NEW.
═══ 154. IBM Trademarks ═══
Trademark of the IBM Corporation.
═══ 155. Help for EPM Startup options. ═══
When starting EPM from an OS/2* command prompt (or from a Workplace Shell
program reference object), the following options can be specified:
/B
Starts EPM with a bare title bar - no system menu, min/max buttons,
or ring buttons. Intended for use when EPM is started as a child of
a special application, this option is normally not specified by the
user.
/Eexfilename
Allows a custom .EX file to be specified. (The default is EPM.EX)
/F
Presents the File dialog before opening the edit window, to allow you
to specify which files should be loaded.
/H
Like the /I option, except that the icon is hidden when an edit
window exists.
/I
Causes an EPM icon to be created. This icon can be used to drop onto
to open up a new edit window. It can be used to start an edit window
directly, by double-clicking on the icon or by activating the icon
and pressing Enter. Finally, the icon is useful for keeping EPM
active even after closing all open edit windows. The icon can be
closed from the task manager, or by selecting it and pressing F3.
Note: The icon is most useful if EPM is configured to be minimized
to the desktop. If hidden, it's only of use in keeping EPM
active so new edit windows will start faster. If in the
Minimized Window Viewer, OS/2 won't pass through the
double-click or let you drop files on it.
/M
Gives the ability to start multiple instances of EPM. By default, if
you attempt to start EPM twice, the second invocation will pass its
arguments to the existing session, then exit. This option overrides
this default. This is useful when calling EPM from a command file,
if you want to be sure that control doesn't return to the .CMD file
until the edit session has ended.
/O
Bypasses the simple dialogs and goes directly to the full file
dialogs.
/R
Passes the arguments to the topmost edit window, if one exists,
instead of starting a new window. This allows you to add files to an
existing ring from the OS/2 command line.
/W
Prepare for DDE conversation from the Workframe.
quoted string
Quoted string representing an editor command can be specified on the
editor command line. For example:
C:\> EPM mydoc.doc 'bot'
This causes EPM to open an edit window containing the file mydoc.doc
and then process the BOTTOM command, which scrolls the file to its
end.
filename
One or more file names can be specified. For example:
C:\> EPM mydoc.doc d:\yourdoc.doc herdoc.doc d:\him\hisdoc.doc
wildcard
One or more wildcards can be specified. For example:
C:\> EPM *.doc d:\test\temp*.*
Note: The command line, minus any EPM startup options, is passed as the
parameter to an Edit command. See the description of that command for
additional file-specific parameters that can be specified when starting EPM.
═══ Help for INI File Location ═══
EPM stores configuration information in an EPM.INI file. When you start EPM
for the first time, it asks you for the location of this file. If you have an
EPM.INI file from a previous release, give the path to it here. If not, supply
the directory where you would like the new one to be created. The default is
C:\OS2, which is where OS/2* keeps its .INI files.
═══ 156. Edit Ring ═══
The term ring is often used interchangeably with edit window. This is because
each edit window contains a ring, which contains one or more files, and each
ring must be associated with an edit window. The current file is the file that
is displayed by the edit window. Other files in the ring can be displayed by
use of the Next File and Previous File operations.
When you Add files, you begin to see why it's called a ring. You can move
"forward" or "backward" around the ring, using the Next file and Previous file
operations.
When you add a new file to the ring, it is inserted after the current file, and
then becomes the current file.
Initially, the ring is disabled, and you are limited to only one file per
window.
Related Information:
Enabling the edit ring
═══ 156.1. Enabling the Edit Ring ═══
To enable the edit ring or load multiple files:
1. Select Options.
2. Select Preferences.
3. Select Ring enabled.
═══ 157. Stream Versus Line Mode ═══
There are two basic types of editors for editing text files, a stream editor
and a line editor. A stream editor treats the file as one long stream of text.
A line editor treats the file as a series of individual lines, separated by a
line end character.
Stream mode
In a stream editor, a new-line character (generally an ASCII
line-feed character) is treated like any other character. It can be
inserted into the text stream, breaking the line into two at that
point, or it can be deleted from the text stream, joining the two
lines on either side of it. As you move the cursor left and right,
when it passes the beginning or end of one line, it moves to the end
or beginning of the next - because although you see individual lines
on the display, it's actually one long stream internally. Also, when
you move the cursor up and down, if you move it over a shorter line,
the cursor bounces to the left; if you continue moving it up or down
to a longer line, it bounces back to the original column.
Line mode
EPM is a line editor. If you move the cursor left or right, it stays
on that line. You can move the cursor beyond the end of the line.
If you do so, and then start typing text, the editor will fill in
spaces between the previous end of the line and the characters you
have added. Since the new-line character does not actually exist in
the file once loaded, there is no concept of inserting or deleting a
new-line. Pressing the Enter key (by default; another key can be
chosen) adds a new line after the current line, but it doesn't split
the line; it adds a new, empty line between the current line and the
following line, regardless of the cursor position.
Since some users are accustomed to using a stream-mode editor, EPM can be
configured to act like one.
Related Information:
Enabling stream-mode editing
═══ 157.1. Enabling Stream-Mode Editing ═══
To enable stream-mode editing:
1. Select Options.
2. Select Preferences.
3. Select Stream editing.
═══ 158. Bookmarks ═══
A bookmark is a reference to a particular point in a file. When a bookmark is
created, it is given a name, which is associated with the character at the
cursor position. If that character is moved around in the file, the bookmark
moves with it. If that character is deleted, the bookmark is deleted along
with it.
If a bookmark is set as a permanent bookmark, it is saved when the file is
saved, and reloaded when the file is loaded. The bookmark is stored as an
extended attribute. If the file is edited with an editor that does not preserve
extended attribute information, the bookmarks will be lost. If a file
containing bookmarks is edited with an editor that does preserve attributes,
but cannot handle EPM's bookmarks, then the line and column information will
not be updated, and the next time the file is loaded into EPM, the bookmarks
might not be accurate.
═══ 159. Fonts ═══
When you first start EPM, it asks PM to give it the default font. This is
normally System Proportional.
Note: If a proportional font is used, columnar data (e.g., line drawing or
tables) will not appear to line up vertically even though they are in
the correct columns. Use a non-proportional font (for example, System
Monospaced or Courier) if you want the characters to line up on the screen.
Note: When an application asks for the default font, PM returns the last font
appended. This is usually System Proportional, but if another
application adds its own fonts, the last font added will be returned.
In particular, IBM Personal Communications/3270 loads some non-text
fonts, which make the edit window appear to contain garbage. The
solution is to explicitly select a font via EPM's Settings dialog rather
than letting it default.
═══ 160. Tags file ═══
A tags file is a file listing where all procedures are defined in a set of
programming language source files. After a tags file has been built, you can
press a key while looking at a function call and jump to the file and location
where that function is defined.
Support is included for building a tags file from C, ASM, E, and Pascal files.
Support for additional languages can be added via macro programming.
EPM will support a tags file built by other programs that include just a
procedure name and file name on each line. The tags files built by EPM contain
the procedure name, filename, line number on which the procedure was found, and
a timestamp for the file. When asked to find a procedure, the timestamp of the
file on disk is checked. If it's the same as the timestamp in the tags file,
then the line number is jumped to directly; if not, the procedure is searched
for,
When the MAKETAGS command is invoked, if the tags file already exists, each
source file that would be searched is checked for in the tags file. If found,
the timestamp is compared with the timestamp of that file on disk. If the file
has not been modified, it will be skipped. If the file date is different, then
all entries for that file in the tags file will be deleted before searching the
source file.
If a file is searched and no procedures are found, a dummy procedure name of
'*' will be added to the tags file. This lets EPM record the timestamp for
that file, so the next time MAKETAGS is run that source file need not be
rechecked if it has not been updated.
═══ 161. Rexx macros ═══
EPM has the ability to execute Rexx macros. Although not as fast or as
powerful as using the built-in macro language (E), this lets you start
programming without having to get an additional package (see the EPMBBS package
availability under Help / Quick Reference in an EPM edit window; this package
includes the macro compiler, macro source, User's Guide, Macro Programmer's
Technical Reference, a number of EPM add-ons, and much sample code - both E and
Rexx).
A Rexx macro is executed by specifying the command name and its parameters as
parameters to the RX command.
Related Information:
o The EXTRACT command
o The RX command
o Line-oriented Rexx functions
o Field-setting Rexx functions
o Key-oriented Rexx functions
o Using Trace and Say in EPM Rexx macros
o EPM Editor commands
o OS/2 Rexx documentation
═══ 162. EXTRACT ═══
All the dot variables (internal fields) of EPM are extractable into REXX using
the extract command. For example, 'extract /getline' would set the REXX
variable getline.0 to 1 (the number of variables returned) and getline.1 to the
contents of the current line.
The fields that are extractable are:
autosave Current autosave value
col Absolute column number that the cursor is in
cursorx Screen-relative cursor column
cursory Screen-relative cursor row
dragcolor Color painted when drag-marking
dragstyle Style of current drag; 1,2,3 = Block, Line, Char.
eaarea Long pointer to buffer containing extended attributes for current
file. (FEALIST)
filename Current file name
fontheight Height of current file's default font, in pels
fontwidth Width of current file's default font, in pels
last Number of lines in current file
lockhandle File handle if file is locked (using LOCK command)
line Line number that cursor is on.
markcolor Color used for marked text
modify Modify count; 0 if file is unmodified, or 1 to .autosave
mousex X position of mouse pointer, in pels
mousey Y position of mouse pointer, in pels
textcolor Color used for unmarked text
userstring Spare field available for macro use
visible Boolean flag specifying whether or not file is visible. Invisible
files are skipped over as you move around the ring, and discarded
(even if modified) when quitting the last visible file in the ring.
windowheight Height of edit window in characters
windowwidth Width of edit window in characters
windowx gap between the bottom end of the client window's presentation space
and the bottom end of the client window.
windowy gap between the right edge of the client window's presentation space
and the right edge of the client window.
font default font for window (a number representing an entry in an
internal font table)
getmarktype Not a real field; see below
getmark "
getline "
insertstate "
Pseudo-fields:
Variable Meaning
Getmarktype Getmarktype.0 is the number of variables extracted.
Getmarktype.1 is the mark type. A NULL string means there
is no mark set. Other possible values are: "LINE", "CHAR",
"BLOCK", "CHARG", "BLOCKG".
Getmark Getmark.0 is the number of variables extracted. Getmark.1
is the first marked line. Getmark.2 is the last marked
line. Getmark.3 is the first marked column. Getmark.4 is
the last marked column. Getmark.5 is the fileid of the
file containing the mark.
Getline Getline.0 is the number of variables extracted. Getline.1
is the contents of the current line.
insertstate Insertstate.0 is the number of variables extracted.
Insertstate.1 is 1 if insert mode is on, or 0 if it is off.
(EPM 5.60 and above only.)
═══ 163. Line-oriented Rexx functions ═══
Each of the following takes an optional line number and fileid. If not
specified, the line number defaults to the current line, and the fileid
defaults to the current file.
etkdeletetext Deletes the current or specified line.
Call etkdeletetext /* delete current line in current file */
Call etkdeletetext 1 /* delete line 1 in current file */
Call etkdeletetext 1, fid /* delete line 1 in file */
etkinserttext Inserts the specified text as a new line before the current or
specified line.
Call etkinserttext 'line' /* insert before curr. line in curr. file */
Call etkinserttext 'line', 1 /* insert string before line 1 in current file */
Call etkinserttext 'line', 1, fid /* insert string before line 1 in file */
etkreplacetext Replaces the current or specified line with the given text.
Call etkreplacetext 'line' /* replace current line in current file */
Call etkreplacetext 'line', 1 /* replace line 1 in current file */
Call etkreplacetext 'line', 1, fid /* replace line 1 in file */
═══ 164. Field-setting Rexx functions ═══
The etksetfilefield function lets you set most of the fields which can be
extracted using the EXTRACT command. See the description of that command for
the meaning of the fields.
call etksetfilefield 'filename' , 'newname'
call etksetfilefield 'userstring' , 'new string'
call etksetfilefield 'autosave' , 1
call etksetfilefield 'col' , 1
call etksetfilefield 'cursorx' , 1
call etksetfilefield 'cursory' , 1
call etksetfilefield 'dragcolor' , 1
call etksetfilefield 'dragstyle' , 1
call etksetfilefield 'eaarea' , 1
call etksetfilefield 'fontheight' , 1
call etksetfilefield 'fontwidth' , 1
call etksetfilefield 'last' , 1
call etksetfilefield 'lockhandle' , 1
call etksetfilefield 'line' , 1
call etksetfilefield 'markcolor' , 1
call etksetfilefield 'modify' , 1
call etksetfilefield 'mousex' , 1
call etksetfilefield 'mousey' , 1
call etksetfilefield 'textcolor' , 1
call etksetfilefield 'visible' , 1
call etksetfilefield 'windowheight' , 1
call etksetfilefield 'windowwidth' , 1
call etksetfilefield 'windowx' , 1
call etksetfilefield 'windowy' , 1
call etksetfilefield 'font' , 1
Related Information:
The EXTRACT command
═══ 165. Key-oriented Rexx functions ═══
The etkprocesseditkey function doesn't actually process keys; it executes some
of the internal functions that are otherwise only available to users by the
keys defined in the internal macro language. The comment after each call in the
following example lists the key defined to do the same thing.
call etkprocesseditkey "ADJUST_BLOCK" /* Alt+A */
call etkprocesseditkey "BACKTAB" /* Shift+Tab */
call etkprocesseditkey "BACKTAB_WORD" /* Ctrl+Right */
call etkprocesseditkey "BEGIN_LINE" /* Home */
call etkprocesseditkey "BOTTOM" /* Ctrl+End */
call etkprocesseditkey "CENTER" /* ??? */
call etkprocesseditkey "COPY_MARK" /* Alt+C */
call etkprocesseditkey "DELETE_CHAR" /* Delete */
call etkprocesseditkey "DELETE_LINE" /* Ctrl+Backspace */
call etkprocesseditkey "DELETE_MARK" /* Alt+D */
call etkprocesseditkey "ERASE_END_LINE" /* Ctrl+E */
call etkprocesseditkey "INSERT_TOGGLE" /* Insert */
call etkprocesseditkey "JOIN" /* Alt+J */
call etkprocesseditkey "MARK_BLOCK" /* Alt+B */
call etkprocesseditkey "MARK_BLOCKG" /* */
call etkprocesseditkey "MARK_CHAR" /* Alt+Z */
call etkprocesseditkey "MARK_CHARG" /* */
call etkprocesseditkey "MARK_LINE" /* Alt+L */
call etkprocesseditkey "MARK_LINEG" /* */
call etkprocesseditkey "MOVE_MARK" /* Alt+M */
call etkprocesseditkey "NEXT_FILE" /* F12 */
call etkprocesseditkey "OVERLAY_BLOCK" /* Alt+O */
call etkprocesseditkey "PREVFILE" /* F11 */
call etkprocesseditkey "REFLOW" /* Alt+P (needs line mark) */
call etkprocesseditkey "REFRESH" /* (refresh edit window)*/
call etkprocesseditkey "REPEAT_FIND" /* Ctrl+F */
call etkprocesseditkey "RUBOUT" /* Backspace */
call etkprocesseditkey "SHIFT_LEFT" /* Ctrl+F7 */
call etkprocesseditkey "SHIFT_RIGHT" /* Ctrl+F8 */
call etkprocesseditkey "SPLIT" /* Alt+S */
call etkprocesseditkey "TAB_WORD" /* Ctrl+Right */
call etkprocesseditkey "TOP" /* Ctrl+Right */
call etkprocesseditkey "UNDO" /* F9 or Alt+Backspace */
call etkprocesseditkey "UNDOACTION" /* (creates a new undo state) */
call etkprocesseditkey "UNMARK" /* Alt+U */
═══ 166. Using Trace and Say in EPM Rexx macros ═══
In order to use Trace and Say in a Rexx macro, you need to direct the output
from the macro to something that can display it. Normally, because EPM is a PM
program, the output would be lost. The RxShell command can be used to invoke
an external program that handles the I/O for the Rexx macro. It can be invoked
with the name of the external program as a parameter; the default is that
PMMORE.EXE will be used. PMMORE.EXE is not included with OS/2, but can be
obtained for free as part of the EPMBBS package. (For details on availability,
select Help / Quick Reference from an EPM edit window.)
The RXSHELL command will spawn the PMMORE program with the environment set such
that EPM's standard output is directed to PMMORE and PMMORE's standard output
is directed to EPM. Therefore, you can use the PMMORE command line to issue
TRACE command to the EPM REXX interpreter.
For example, if the following is placed in a TRACEEPM.ERX file:
/* Trace the file... */
Trace '?A'
say 'Tracing is' trace()
and then you were to execute the EPM commands:
rxshell
rx traceEpm
Then you could see the REXX output in the PMMORE window and could use the
PMMORE command line dialog to send a command such as:
say hello
to the EPM REXX interpreter.
═══ 167. Spell-checking Support in EPM ═══
In order to perform spell-checking functions, you must have either OSLEXAM.DLL
or LEXAM.DLL in a directory in your LIBPATH config.sys setting, and you must
have a valid disctionary. A copy of LEXAM.DLL and the U.S. English dictionary
(US.DCT) can be found on the Developer's Connection CD-ROM, in the file
\comm\tcpip\tcpip\lamail1.zip. (IBM internal users can see EPM ANSWERS on
IBMPC for details on obtaining a copy.)
Note: The product version of EPM is configured so that the spell-checking menu
items will be present only if a spell-checking DLL can be found.
═══ 168. Help for File ═══
Use File to open, save, change the name of, or print a file.
═══ 169. Help for New ═══
Use New to replace the current file with a new file named .Untitled. You must
name the file by using Rename. If the current file has been modified, you will
be asked if you want to save it before continuing.
Related Information:
Rename
═══ 170. Help for Open ═══
Use Open to open a new edit window. A window appears, in which you can type
the names of one or more files. If you select Open without typing a name,
.Untitled is used as the file name.
Related Information:
OPEN
═══ 171. Help for Open .Untitled ═══
Use Open .Untitled to open a new edit window with .Untitled used as the file
name.
Related Information:
OPEN
═══ 172. Help for Import Text File ═══
Use Import text file to retrieve a file and insert it into the current file
being edited. The file is inserted starting after the current line.
A window appears, in which you can type the name of the desired file.
Related Information:
GET
═══ 173. Help for Add File ═══
Use Add file to add files to the current edit window. A window appears, in
which you can type the name of one or more files.
═══ 174. Help for Rename ═══
Use Rename to change the name of the file being edited. A window appears ready
for you type a file name.
Related Information:
NAME
═══ 175. Help for Save ═══
Use Save to store the current file on disk.
Related Information:
SAVE
═══ 176. Help for Save As ═══
Use Save as to assign a name to the current file, then store the file on disk.
It is equivalent to Rename followed by Save.
═══ 177. Help for Save and Quit ═══
Use Save and Quit to store the current file and, if there were no errors
storing it, remove the file from the edit window. If this is the only file in
the current edit window, the window closes.
Related Information:
FILE
═══ 178. Help for Quit ═══
Use Quit to remove the current file from the edit window. If there are unsaved
changes, you are asked if you wish to save the changes, discard them, or cancel
the Quit. When you quit the last file in the edit window, the window closes.
Related Information:
o FILE
o QUIT
═══ 179. Help for Print File ═══
Use Print file to print the current file.
Related Information:
PRINT
═══ 180. Help for Edit ═══
Use Edit to work with marks, access the clipboard, and undo changes you have
made to the file.
═══ 181. Help for Undo ═══
Use Undo to display up a window, which enables you step through the changes you
have made to the file.
═══ 182. Help for Copy Mark ═══
Use Copy mark to copy the marked text to the current cursor position.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 183. Help for Move Mark ═══
Use Move mark to move the marked text to the current cursor position.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 184. Help for Overlay Mark ═══
Use Overlay mark to overwrite the text at the current cursor position with a
copy of the marked text.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 185. Help for Adjust Mark ═══
Use Adjust mark to overwrite the text at the current cursor position with the
marked text and leave blanks in place of the source text.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 186. Help for Style ═══
Use Style to change the font or color of the marked text.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 187. Help for Unmark ═══
Use Unmark to remove any mark that exists in this window. The marked text is
not changed.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 188. Help for Delete Mark ═══
Use Delete mark to erase the marked text. If the mark is a block mark, the
text that is marked is erased, but the space remains in the file.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 189. Help for Push Mark ═══
Use Push mark to save the location of a mark. You can then select Unmark, mark
other text, manipulate it, and then select Pop mark to restore the original
mark.
Note: Only the boundary of the mark is saved, not the contents.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 190. Help for Pop Mark ═══
Use Pop mark to restore the location of a previous mark.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 191. Help for Push Cursor ═══
Use Push cursor to save the current cursor position. You can later select Pop
cursor to jump back to the same place in the same file.
Related Information:
Pop Cursor
═══ 192. Help for Pop Cursor ═══
Use Pop cursor to restore the previous cursor position.
Related Information:
Push Cursor
═══ 193. Help for Copy ═══
Use Copy to copy the marked text to the clipboard.
Related Information:
o PASTE
o COPY2CLIP
═══ 194. Help for Cut ═══
Use Cut to copy the marked text to the clipboard, and then delete it from EPM.
Related Information:
CUT
═══ 195. Help for Paste Lines ═══
Use Paste lines to copy text from the clipboard into the current file,
following the cursor position. Each line of text in the clipboard is added as
a new line in EPM.
Related Information:
PASTE
═══ 196. Help for Paste ═══
Use Paste to insert text from the clipboard into the current file, following
the cursor position. The text from the clipboard is treated as a character
mark - that is it is treated as a stream of text, possibly containing embedded
line breaks, rather than as a series of lines.
Related Information:
PASTE
═══ 197. Help for Paste Block ═══
Use Paste block to insert text from the clipboard into the current file,
following the cursor position. The clipboard text is treated as a block mark,
surrounded by the smallest possible bounding rectangle.
Related Information:
PASTE
═══ 198. Help for Print Mark ═══
Use Print mark to print a copy of the marked text.
Related Information:
Marking text
═══ 199. Help for Undo Line ═══
Use Undo line to reverse any changes that you just typed on the current line.
If you select this in error, you can immediately select it again to redo the
changes. Once you move the cursor off the line, the changes are committed and
you cannot use Undo line to remove them, instead; you must use Undo.
Related Information:
Undo
═══ 200. Help for Recover Mark Delete ═══
Use Recover mark delete to restore accidentally deleted text. When you select
Delete mark, the deleted text is stored in a buffer. Recover mark delete
retrieves the text from the buffer and inserts it after the current cursor
position.
Note: You can delete text from one place and restore it in another.
═══ 201. Help for Search ═══
Use Search to find and change text, and to work with bookmarks.
═══ 202. Help for Search ═══
Use Search to display the Search window, which enables you to search through
the file or change one string to another.
═══ 203. Help for Find Next ═══
Use Find next to repeat the previous Find command.
═══ 204. Help for Change Next ═══
Use Change next to repeat the previous Change command.
═══ 205. Help for Bookmarks ═══
Use Bookmarks to create, list and find bookmarks in the current file. The
options are:
Set Displays a window that enables you to create a bookmark at the
current cursor position.
List Displays a list of bookmarks for the current file. You can place the
cursor at a particular bookmark by selecting it from the list.
Next Places the cursor at the next bookmark.
Previous Places the cursor at the previous bookmark.
═══ 206. Help for Tags ═══
Use Tags to create or update a tags file, set the name of the tags file to be
used, or search for a procedure in the tags file. The options are:
Tags dialog Displays the Tags dialog, from which you can select which existing
tags file to use, build a new one, or update the list of files
covered by a tags file (and optionally rebuild the tags file).
Find current procedure Search for the procedure name that the cursor is on.
Find procedure Displays a window in which you can enter the name of the
procedure to be searched for.
Scan file Searches the current file for procedure definitions, then presents a
listbox displaying all the procedures found. You can select a
procedure from the list and you will be placed at the beginning of
the procedure definition.
═══ 207. Help for Options ═══
Use Options to list the files in the ring, query autosave values, review
previously-displayed editor messages, and configure the editor.
═══ 208. Help for List Ring ═══
Use List ring to list the files in the edit ring. Files that have been
modified and not yet saved are preceded by a period. From the list, you can
select any file and make it the current file.
═══ 209. Help for Proof ═══
Use Proof to check the spelling in a file.
═══ 210. Help for Proof Word ═══
Use Proof word to check the spelling of the word at the current cursor
position.
═══ 211. Help for Synonym ═══
Use Synonym to suggest a synonym for the word at the current cursor position.
═══ 212. Help for Dynamic Spell-checking ═══
Use Dynamic Spell-checking to toggle dynamic spell-checking on and off. When
dynamic spell-checking is on, the previous word will be checked when the space
or enter key is pressed.
═══ 213. Help for Preferences ═══
Use Preferences to switch edit-window options or display the Settings window.
═══ 214. Help for Settings ═══
Use Settings to display a window, from which you can change editor
configuration settings (such as color and fonts).
═══ 215. Help for Set Enter ═══
Use Set enter to change the action of the Enter key (in its various shift
states). You can select the Enter key on the main portion of the keyboard or
the Enter key on the numeric keypad portion of the keyboard alone or in
combination with the Alt, Ctrl or Shift key.
Each of these eight keys or key combinations can be set to one of six actions.
This setting is applied when the editor is in line mode. When the editor is in
stream mode, a different action is performed, regardless of how the keys were
set. See Stream versus Line mode for details.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
Related Information:
Stream versus Line mode
═══ 216. Help for Advanced Marking ═══
Use Advanced marking to switch between the CUA marking mode and the advanced
EPM marking mode. The mode of marking that you use affects the way your mouse
works.
A check mark appears next to this choice if it is currently active.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
Related Information:
Configuring the mouse
═══ 217. Help for Stream Editing ═══
Use Stream editing to switch between stream-mode and line-mode editing.
A check mark appears next to this choice if it is currently active.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
Related Information:
Stream versus Line mode
═══ 218. Help for Ring Enabled ═══
Use Ring enabled to allow multiple files to exist in the edit ring. The edit
ring always exists, but unless you select this option, the editor prevents you
from loading more than one file into it.
A check mark appears next to this choice if it is currently active.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
Related Information:
Edit Ring
═══ 219. Help for Menu Accelerators ═══
Use Menu accelerators to switch between the standard EPM behavior, in which
pressing an Alt+letter combination performs the EPM action defined for that
key, and a mode in which pressing Alt+letter activates the action bar item
which has that letter as its mnemonic (the underlined letter), if one exists.
The affected key combinations are dependant on the NLS version of the editor.
A check mark appears next to this choice if it is currently active.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
═══ 220. Help for Swap Mark ═══
Use Swap mark to exchange the current mark with the topmost mark on the stack
(the most recently pushed mark).
Related Information:
Push mark
═══ 221. Help for Swap Cursor ═══
Use Swap cursor to exchange the current cursor position with the topmost
position on the stack (the most recently pushed position).
Related Information:
Push cursor
═══ 222. Help for Stack Commands ═══
Use Stack commands to enable or disable the stack-related commands on the Edit
menu.
The stack commands are:
o Push mark
o Pop mark
o Swap mark
o Push cursor
o Pop cursor
o Swap cursor
A check mark appears next to this choice if it is currently active.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
═══ 223. Help for Autosave ═══
Use Autosave to display the autosave file name and the number of changed lines
per autosave. You can also list the autosave directory.
═══ 224. Help for Messages ═══
Use Messages to review displayed editor messages.
═══ 225. Help for Frame Controls ═══
Use Frame controls to configure various edit window frame controls.
═══ 226. Help for Status Line ═══
Use Status line to switch the status line on and off.
A check mark appears next to this choice if it is currently active.
═══ 227. Help for Message Line ═══
Use Message line to switch the message line on and off.
A check mark appears next to this choice if it is currently active.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
═══ 228. Help for Scrollbars ═══
Use Scrollbars to toggle the scroll bars on and off.
A check mark appears next to this choice if it is currently active.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
═══ 229. Help for File Symbol ═══
Use File symbol to switch the file symbol on and off.
A check mark appears next to this choice if it is currently active.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
═══ 230. Help for Rotate Buttons ═══
Use Rotate buttons to switch the rotate buttons on and off.
A check mark appears next to this choice if it is currently active.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
═══ 231. Help for Info at Top ═══
Use Info at top to switch the position of the Information window between the
top and the bottom of the edit window. The information window is composed of
the status line and the message line.
A check mark appears next to this choice if it is currently active.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
═══ 232. Help for Prompting ═══
Use Prompting to control if prompts are displayed when menu choices are
selected. Displaying the prompts forces the Information window to be displayed
at the bottom of the edit window instead of at the top.
A check mark appears next to this choice if it is currently active.
Note: The menu prompting is done through an internal command that is called
whenever a menu choice is selected. Therefore, the prompting will not
appear while another command is processing. This ensures that you will
always be able to select Halt command to stop processing.
To save the current state as your permanent default:
1. Select Options.
2. Select Save options.
Related Information:
Halt command
═══ 233. Help for Save Options ═══
Use Save options to store the edit window size and position, current state of
the checkable items on the preferences and frame controls menus, and current
state of the ESCAPEKEY, LONGNAMES, PROFILE, and TABKEY commands. The next time
an edit window is opened, these same settings are used.
═══ 234. Help for Book Icon ═══
Use Book icon to activate the EPM book icon, from which you can close EPM or
list all edit windows.
═══ 235. Help for Command ═══
Use Command to bring up the EPM command line, or to halt a long-running command
before it finishes.
═══ 236. Help for Command Dialog ═══
Use Command dialog to enter editor commands.
═══ 237. Help for Halt Command ═══
Use Halt command to stop a command.
═══ 238. Help for Create Shell ═══
Use Create shell to create a command shell, an OS/2 command prompt where you
can type commands. The output appears in an edit window while other programs
are running.
═══ 239. Help for Write to Shell ═══
Use Write to shell to write a string to the command shell. The string is
generally a command, but can also be the response to a prompt in the shell
window.
═══ 240. Help for Destroy Shell ═══
Use Destroy shell to quit the command shell and delete the associated command
process.
═══ 241. Help for Send Break to Shell ═══
Use Send break to shell to send a break signal to the command process
associated with the shell window.
═══ 242. Help for Commands Help ═══
Use Commands help to view the list of editor commands, from which you can
select any command in order to obtain help for that command.
═══ 243. Help for Quick Reference ═══
Use Quick reference to view the information in the quick reference file.
═══ 244. Help for Product Information ═══
Use Product information to display the copyright and version number for EPM.
═══ 245. Help for IBM ═══
Use IBM to display copyright and version number information about EPM.
═══ 246. Help for Toolbar ═══
Use Toolbar to toggle the toolbar on or off.
═══ 247. Help for Background Bitmap ═══
Use Background bitmap to toggle the background bitmap on or off. Turning the
background bitmap off, then on, will revert to the default bitmap if a
different bitmap had been dropped on the edit window.
To save the current state (on or off) and bitmap as your permanent default:
1. Select Options.
2. Select Save options.
═══ 248. Help for Toolbar Menu ═══
Use the Toolbar context menu to manipulate the Toolbar. The menu choices are:
Edit Item Lets you edit the current Toolbar button. You can change the bitmap,
text, or action associated with the button.
Create Item Lets you create a new Toolbar button. If you activate the context
menu while over a button, you can position the new item relative to
that button or at the end. If you activate the menu while to the
right of the existing buttons, you will only be able to create the
new item at the end.
Delete Item Deletes the current Toolbar button. tags file to be used.
Save As Lets you save a toolbar in the .INI file.
Buffet Presents a "Toolbar Buffet", containing all the pre-defined actions,
along with a copy of your toolbar. You can drag toolbar items from
the buffet to the copy of your toolbar in order to add new items.
Help Presents this help panel.
═══ 249. Help for Open As ═══
Use Open as to open a file, edit window, or command shell. Select the right
arrow for a menu. The default, if the edit ring is enabled, is to open another
file in the current edit window. If the edit ring is not enabled, the default
is to open a file in a new edit window.
Related Information:
Edit Ring
═══ 250. Help for New Window ═══
Use New window to open a new edit window. A window appears, in which you can
type the names of one or more files. If you select Open without typing a name,
.Untitled is used as the file name.
Related Information:
OPEN
═══ 251. Help for Same Window ═══
Use Same window to add files to the current edit window. A window appears, in
which you can type the name of one or more files.
═══ 252. Help for View ═══
Use View to search for text, work with tags or bookmarks, turn dynamic spell
checking on or off, list the files in the edit ring, save or restore the cursor
position, access the command dialog, or halt a long-running command.
═══ 253. Help for Selected ═══
Use Selected to work with marks (selected text), access the clipboard, and undo
changes you have made to the file.
═══ 254. Help for Select all ═══
Use Select all to select all the text in the file. A character mark will be
used.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 255. Help for Deselect all ═══
Use Deselect all to remove any mark that exists in this window. The marked text
is not changed.
Related Information:
o Marking text
o Mark types
o Mark operations
═══ 256. Help for Undo ═══
Use Undo to undo changes you have made to the current file.
═══ 257. Help for Paste ═══
Use Paste to copy text from the clipboard into the current file, following the
cursor position. You can elect to paste the text as a character stream (the
default), as new lines, or as a rectangular block.
Related Information:
PASTE
═══ 258. Help for Save Config ═══
Use Save config to save the edit object's configuration to a file. You would
want to do this before deleting the object in order to install a new version of
the editor, so that you can later reload the same configuration.
═══ 259. Help for Load Config ═══
Use Load config to load the edit object's configuration from a file. You might
want to do this to copy a base configuration from another editor object, or to
restore a previously saved configuration.
═══ ═══
Prints the text to the selected printer using the default printer font.
═══ ═══
Prints text using the same fonts as displayed on-screen
═══ ═══
An extended ASCII character can be entered in a KEY or LOOPKEY command as
follows:
a+x
Alt+X, where "x" is any alphabetic key.
c+x
Ctrl+X, where "x" is any alphabetic key.
Fn
Function key N, where "n" is 1 to 12.
x+Fn
shifted Function key N, where "n" is 1 to 12, and "x" can be "s" for
Shift, "a" for Alt, or "c" for Ctrl.
In the above, "+" can actually be "+", "-", or "_". For example:
KEY 10 c-F8
═══ ═══
An area of computer memory, or storage, that temporarily holds data. Data in
the clipboard is available to other programs.
═══ ═══
The visual indicator in a slider that shows that the numerical value can be
changed by manipulating it. See also slider.
═══ ═══
A control that represents a quantity and its relationship to the range of
possible values for that quantity. In some cases, you can change the value of
the quantity. See also slider arm.
═══ ═══
A family of characters of a given size and style; for example, 9-point
Helvetica.
═══ ═══
A symbol that shows that a choice is currently active.
═══ ═══
For example, if the search_string is "the", the search will skip over "there"
or "rather". A potential match is considered to not be a separate word if the
preceding or following character is a letter, number, underscore (_), or dollar
sign ($). This makes it useful when searching for programming language tokens,
as well as for normal words.
═══ ═══
Additional information that the system or a program associates with a file.
The file system or program then uses this information, which is not visible to
you, to recognize the file.