OS/2 Shareware BBS: 5 Edit/05-Edit.zip/epm603a.zip/EPMAPP.ZIP/EPM.HLP

OS/2 Help File | 1995-10-05 | 189KB | 6,638 lines

ΓòÉΓòÉΓòÉ 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, and Rexx.

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+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.
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          <DIR>      1-01-90  12:01a
ALL      NDX       87   1-01-90  12:01a
OUT          <DIR>      1-01-90  12:01a
OUT      NDX       87   1-01-90  12:01a
PERSONAL     <DIR>      1-01-90  12:01a
PERSONAL NDX       87   1-01-90  12:01a
STUFF        <DIR>      1-01-90  12:01a
STUFF    NDX       87   1-01-90  12:01a
MORESTUF     <DIR>      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.

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 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 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 QUIT (Quit File)
o QD (Query Date)
o QT (Query Time)
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. 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.23. 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.24. 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.25. 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.26. 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.27. 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.28. 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.29. 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.30. 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.31. 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.)
/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.32. 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.33. 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.34. 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.35. 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.36. FILEFIND (Find Files) ΓòÉΓòÉΓòÉ

Synonym for the LIST command.

Related Information:

LIST


ΓòÉΓòÉΓòÉ 152.37. 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.38. FINDFILE (Find Files) ΓòÉΓòÉΓòÉ

Synonym for the LIST command.

Related Information:

LIST


ΓòÉΓòÉΓòÉ 152.39. 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.40. 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.41. 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.42. 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.43. 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.44. 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.45. 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.46. 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.46.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.46.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.47. 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.48. 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.49. 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.50. 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.51. 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.52. 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.53. 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.54. 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.55. 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.56. 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.57. 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.58. 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.59. 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.60. 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.61. 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.62. 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.63. 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.64. 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.65. 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.66. 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


ΓòÉΓòÉΓòÉ 152.67. 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.68. 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.69. 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.70. 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.71. 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.72. 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.73. 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.74. 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.75. 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.76. 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.77. 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.78. 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.79. 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.80. 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.81. 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.82. 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.83. 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.84. 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.85. 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.86. 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.87. 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.88. 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.89. 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.90. 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.91. 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.92. 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.93. 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.94. 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.95. 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.96. 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.97. VERIFY (Spell-check the Current Word) ΓòÉΓòÉΓòÉ

See the PROOFWORD command.


ΓòÉΓòÉΓòÉ 152.98. 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.


ΓòÉΓòÉΓòÉ <hidden> 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 <fid> */

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 <fid> */

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 <fid> */


ΓòÉΓòÉΓòÉ 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.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Prints the text to the selected printer using the default printer font.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

Prints text using the same fonts as displayed on-screen


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

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


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

An area of computer memory, or storage, that temporarily holds data.  Data in
the clipboard is available to other programs.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

The visual indicator in a slider that shows that the numerical value can be
changed by manipulating it. See also slider.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

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.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

A family of characters of a given size and style; for example, 9-point
Helvetica.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

A symbol that shows that a choice is currently active.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

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.


ΓòÉΓòÉΓòÉ <hidden>  ΓòÉΓòÉΓòÉ

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.