home *** CD-ROM | disk | FTP | other *** search
- Enhanced Editor - Quick Reference (Press F1 for full online help.)
-
- Section Description
- ----------------------------------------------
- 1 Function Key Definitions
- 2 Alt-key Function Summary
- 3 Ctrl-key Function Summary
- 4 Edit and Termination Commands
- 5 Command Summary
- 6 Cursor Movement and Mouse Actions
- 7 Copying, Moving, and Deleting text
- 8 Drag and Drop
- 9 Writing Macros in REXX
- 10 IBM Workframe/2 for compiling programs
- 11. ASCII Reference Chart
- ------------------------------------------------------------------------
- Note: This Quick Reference file (EPMHELP.QHL) is an expandable help file
- that can be modified to contain your personal notes on the
- Enhanced Editor. Select Help / Product Help for the complete help.
-
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 1: Function Key Definitions
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-
- Key Unshifted Alt + key Shift + key Ctrl + key
- ----------------------------------------------------------------------------
- F1 Help ^ Box characters Scroll left Uppercase word
-
- F2 Save & continue Scroll right Lowercase word
-
- F3 Quit w/o save Scroll up Uppercase
- selection
-
- F4 Save and quit Close Window ^ Scroll down Lowercase
- selection
-
- F5 Open Dialog Restore Window ^ Center line vrt. Cursor to
- beginning of word
-
- F6 Show draw opts. Cursor to
- end of word
-
- F7 Change filename Move ^ Shift selection
- to the right
-
- F8 Edit new file Size ^ Shift selection
- to the right
-
- F9 Undo cur. line Minimize ^
-
- F10 Activate Menu ^ Maximize ^
-
- F11 Prev file
-
- F12 Next file
-
- Note: ^ - key defined by PM
-
-
-
-
-
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 2: Alt-key Function Summary
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-
- Key Description
- ----------------------------------------------------------------------------
- a-A Adjust selected area, blank old
- a-B Select Block
- a-C Copy Selected area to cursor
- a-D Delete Selected area
- a-E cursor to End of Selected area
- a-F Fill Selected Area Dialog
- a-G -- Not Used --
- a-H -- Not Used --
- a-I -- Not Used --
- a-J Join (with following line)
- a-K -- Not Used --
- a-L Select Line
- a-M Move selected area
- a-N keyin file Name at cursor
- a-O Overlay selected area at cursor
- a-P reformat following Paragraph
- a-Q -- Not Used --
- a-R Reflow selected area
- a-S Split line at cursor
- a-T cenTer Text in selected block, or within margins
- a-U Unmark selected text
- a-V -- Not Used --
- a-W mark Word
- a-X -- Not Used --
- a-Y cursor to beginning of mark
- a-Z Select text, character mode
- a-1 Edit file named on current line
- a-2 - a-9 -- Not Used --
- a-0 Same as a-=
- a-- highlight cursor
- a-= Execute the current line or the selected set of
- lines as commands
- a-/ move to next bookmark
- a-\ move to previous bookmark
-
-
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 3: Ctrl-key Function Summary
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-
- Key Description
- ----------------------------------------------------------------------------
- c-A -- not used--
- c-B Bookmark list
- c-C Change next
- c-D Delete word
- c-E Erase to end of line
- c-F repeat previous Find command
- c-G list files in rinG
- c-H -- not used--
- c-I command dIalog
- c-J -- not used--
- c-K duplicate line
- c-L copy current Line to command line
- c-M Set Bookmark dialog
- c-N Next file in ring
- c-O Open Dialog
- c-P Previous file in ring
- c-Q Swap to/from .ALL file
- c-R Record Keys/ End Record
- c-S bring up Search dialog
- c-T Play Keys Back into editor
- c-U Activate Undo dialog
- c-V -- not used--
- c-W -- not used--
- c-X force syntaX expansion
- c-Y activate Style dialog
- c-Z -- not used--
- c-2 Enter NULL character
- c-3 - c-5 -- not used--
- c-6 Enter '¬' character
- c-7 - c-8 -- not used--
- c-9 Enter '{' character (left brace)
- c-0 Enter '}' character (right brace)
- c-enter like enter, no new line (can be reconfigured via Options/Settings)
- c-Backspace Delete line
- c-Tab Enter a tab character
- c-[, c-] Move to matching bracket - [], {}, (), <>
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 4: Edit and Termination Commands
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- How To Edit Additional Files during an EDIT session:
- ----------------------------------------------------------------------------
- OPEN [d:][\path\]filename.ext
- will load the file into a separate window
- EDIT,ED, E [d:][\path\]filename.ext
- will load the file into the ring of the current window, if it's
- not already present in the window.
-
- How to exit the Enhanced Editor
- ----------------------------------------------------------------------------
- FILE, F command (F4) saves and then removes the file from memory.
-
- QUIT,Q command (F3) removes the file from memory without saving. If
- QUIT is entered after any data has been altered, the "Quitting file"
- dialog will be presented. Select Discard to quit, Cancel to continue.
-
- CLOSE quit all files in window and close window.
-
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 5: Command Summary
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Command Syntax
- [L] /pattern/[c|e][m|a][-|+](locate string
- C /old/new/[ c | e ][ m | a ][ - | + ]
- NAME, N [filespec] renames for next save
- PRINT
- SAVE, S [filespec] [/T]
- PUT filespec saves selected area
- APPEND [filespec] appends selected " "
- GET filespec
- FILL chr -- fills selected area
- BOX [1|2|C|P|A|E|R]
- KEY # chr-repeat horizontally
- LOOPKEY # chr-repeat vertically
- LIST, FINDFILE filespec
- MATCHTAB [ON | OFF]
- EXPAND [ON | OFF]
- MArgins left right new-pgrp
- TABS # or t1 t2...t32
- AUTOSAVE # sets # of change before autosave
- QTIME,QT shows current time
- QDATE,QD shows current date
- DRAW [1][2][3][4][5][6][B][/any char.]
- MATH expression
- Operators -,+,*,/,%
- Numbers decimal, hex (leading x),
- or octal (leading o)
- Example: math 10+xff-o77
- MATHX same as math, result shown in hex
- MATHO same as math, result shown in octal
- ASC [char] gives Ascii value of char,
- e.g. ASC X = 88. If no argument
- specified, uses current text char.
- CHR # shows character corresponding to Ascii #
- ADD adds marked column of numbers
- SORT sorts selected area or all
- #### goto line ####
- +[#] down # lines (or EOF)
- -[#] up # lines (or TOF)
- XCOM [internal command]
- [DOS] [command]
- (Any OS/2 command can be simply typed on the command line.
- Output must be redirected or it will be lost.)
- OS2 [command] Opens an OS/2 command window and executes [command]
- in it.
- PROFILE [ON | OFF] If set ON, a PROFILE.ERX is searched for along
- the EPMPATH and PATH whenever a new edit window is opened.
- If found, it will be called and given the EPM command line
- arguments. See the section on Rexx for details on writing a
- profile. The setting will be saved by Options / Save Options.
-
-
-
-
-
-
-
-
-
-
-
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 6: Cursor Movement and Mouse Actions
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-
- ------ Cursor movements --------
- Up/dn/left/right Moves cursor one position up/down/left/right.
- Home/End Moves cursor to column 1/end of the current line.
- Page up/down Displays text above/below current page.
- Ctrl-Home/End Moves cursor to top/bottom line of file.
- Tab/Shift-tab Moves cursor to next/previous tab stop.
- Ctrl-PgUp/PgDn Moves cursor to top/bottom of screen.
- Ctrl-left/right Moves cursor to beginning of word left/right of cursor.
- ------ Mouse actions ----
- Button 1 click Move cursor to mouse.
- Button 1 click & drag Block select as you drag.
- Button 2 click & drag Line select as you drag. If inside a selected
- area, moves selected text; w/ Ctrl, does copy
- Button 1 + Ctrl key & drag Character selection as you drag.
- Button 1 double click Unmark
- Button 2 double click Move cursor to mouse and select the word.
-
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 7: Copying, Moving, Deleting Text
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- 1. Press a Text-Select key (see list below) once at the beginning of the
- text and again at the end of the text to be copied, moved, or deleted.
-
- 2. To copy or move, move the cursor to the desired destination.
-
- 3. Press an Operator key (see list below).
-
- 4. This is for Advanced Mark Mode; in the base mode, marking works as
- in all other PM applications. Options / Preferences to switch
- mark modes.
-
- Text-Select Keys (a = Alt Key)
- -----------------------------------
- a-L : line selection for one line or paragraph
- a-Z : character selection for sentences, phrases and characters
- a-B : block mark rectangles a-U : unmarks any area
- a-W : word select (uses block mark)
- a-C : copy selection to cursor
- a-M : move selection to cursor
- a-D : delete selection
- a-O : overlay selection
- a-A : adjust selection (a-O with blank fill of source)
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 8: Drag and Drop
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-
- The Enhanced Editor can drag text as either an:
- + Entire file
- + Selected area of text. (line, block, character)
- (Text can be dragged from EPM by directly manipulating the
- selected area.)
-
- The Enhanced Editor can accept drops of text on any of three landing
- strips:
- + Titlebar
- - Text
- EPM will create a new file containing either a file
- or partial text selection.
- - Code
- If code in the form of an EPM macro *.EX or EPM REXX macro
- *.ERX is dropped on the titlebar, EPM will implicitly link
- and run the macro.
- + Client Window (text entry area)
- - Text
- EPM will import the dropped text into the current file.
- - Code
- If code in the form of an EPM macro *.EX or EPM REXX macro
- *.ERX is dropped on the titlebar, EPM will link the macro.
- + EPM icon (when EPM is started with the /i option)
- - Text
- EPM/G will open up a new window containing the dropped text
- object.
-
-
-
-
-
-
-
-
-
-
-
-
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 9: Writing Macros in REXX
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-
- Starting an Enhanced Editor REXX macro
- --------------------------------------
- To Start an Enhanced Editor REXX macro use the RX command at the
- Enhanced Editor's command line. For example,
- RX EPMTEXT
- would run the EPMTEXT.ERX macro. A REXX macro PROFILE.ERX can be
- run automatically when a new edit window is opened, by entering on the
- Enhanced Editor's command line: PROFILE ON
- and then selecting Options / Save Options.
-
- Extracting Specific Information
- ---------------------------------
- Internal EPM variables 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", "col", "cursorx", "cursory", "dragcolor", "dragstyle",
- "filename", "fontheight", "fontwidth", "last", "line", "markcolor",
- "modify", "mousex", "mousey", "textcolor", "userstring", "windowheight",
- "windowwidth", "windowx", "windowy", "font", "getmarktype",
- "getmark", "getline"
-
- Using the EPM/REXX functions
- -------------------------
- Line-oriented functions
-
- The EPM functions that are available from REXX are a subset of the
- EPM programming language functions.
-
- Examples:
- ---------
- /*
- * Name EPMTEST.ERX
- * Function A Rexx Macro for EPM
- */
- parse arg args
- Call etkdeletetext /* delete current line in current file */
- Call etkdeletetext, 1 /* delete line 1 in current file */
- Call etkinserttext 'line' /* insert 'line' before curr line in curr file */
- Call etkinserttext 'line' /* insert 'line' before line 1 in current file */
- Call etkreplacetext 'line' /* replace current line in current file */
- Call etkreplacetext 'line', 1 /* replace line 1 in current file */
-
- Setting EPM field functions
- -----------------------------
- /*
- * Name SETFIELD
- * Function A Rexx Macro for EPM to test the setting of fields
- */
- call etksetfilefield 'filename' , 'newname'
- call etksetfilefield 'userstring' , 'new string'
- call etksetfilefield 'autosave' , 1
- call etksetfilefield 'xxxx' , 1
- where 'xxxx' can be:
- 'cursorx', 'cursory', 'dragcolor', 'dragstyle', 'eaarea', 'fontheight',
- 'fontwidth', 'last', 'lockhandle', 'line', 'markcolor', 'modify',
- 'mousex', 'mousey', 'textcolor', 'visible', 'windowheight', 'windowwidth',
- 'windowx', 'windowy', 'font'
-
- Key-oriented functions
- ----------------------
- /*
- * Name KEYTEST
- * Function A Rexx Macro for EPM to test the keys.
- */
- call etkprocesseditkey "ADJUST_BLOCK"
- call etkprocesseditkey "BACKTAB"
- ...
- call etkprocesseditkey "XXXX"
- where XXXX can be:
- "BEGIN_LINE", "BOTTOM", "CENTER", "COPY_MARK", "DELETE_CHAR",
- "DELETE_LINE", "DELETE_MARK", "ERASE_END_LINE", "INSERT_TOGGLE",
- "JOIN", "MARK_BLOCK", "MARK_BLOCKG", "MARK_CHAR", "MARK_CHARG",
- "MARK_LINE", "MARK_LINEG", "MOVE_MARK", "NEXT_FILE", "OVERLAY_BLOCK",
- "PREVFILE", "REFLOW", "REFRESH", "REPEAT_FIND", "RUBOUT",
- "SHIFT_LEFT", "SHIFT_RIGHT", "SPLIT", "TAB_WORD", "TOP", "UNDO",
- "UNDOACTION", "UNMARK"
-
- Creating Menus
- --------------
- /*
- * Name MYMENU
- * Function A Rexx Macro for EPM to add new menus...
- */
- /**/
- 'buildsubmenu default 1990 MyRexxMenu 0 0'
- 'buildmenuitem default 1990 1991 Directory 0 0 dir'
- 'buildmenuitem default 1990 1992 AddSelection 0 0 add'
- 'buildmenuitem default 1990 1993 TopofFile 0 0 top'
- 'buildmenuitem default 1990 1994 BottomofFile 0 0 bot'
- 'showmenu default'
- -------------------------------------------------------------------------
- Additional information about programming the EPM editor is available in the
- IBMBBS package, which is available on the IBM BBS systems, via anonymous FTP
- from software.watson.IBM.com (and various other FTP sites), and through
- Compuserve Information Services. This package includes the latest version
- of EPM, the ETPM macro compiler, E macro source, EPM User's Guide, EPM Macro
- Programmer's Technical Reference, and various sample E and Rexx macros.
-
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 10: Enhanced Editor support for IBM Workframe/2
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-
- To configure IBM WorkFrame/2 (WorkFrame) to use the EPM...
-
- 1) Click on 'Editor' from the 'Configure' pull-down menu. The
- 'Configure Editor' window will appear.
-
- 2) Change the editor name to EPM.EXE. This assumes that the EPM
- editor is in a path specified by the PATH environment variable.
- If the editor is not on the PATH, you must fully qualify the name.
-
- 3) In the 'Invocation string' field, type:
- /w %a %z
- The /w switch tells the EPM editor to enable its WorkFrame
- support. The substitution variables (%a %z) tell the WorkFrame
- to pass all selected files (not just the first file) to EPM.
- Replacement variables are specified in invocation parameters.
- The replacement variable is a symbol that consists of a percent
- sign (%) followed by a character.
-
- 4) Click on the 'Send compiler errors' checkbox. This causes the
- WorkFrame to communicate with the editor whenever compilation
- errors occur.
-
- 5) Click on OK to save the changes and close the window. The changes
- you made are in effect for the current session only. If you want
- the changes to be saved for future sessions, you must select
- the 'Save Profile' option from the 'Save Settings' entry on the
- 'File' pulldown.
-
- To make use of the WorkFrame support in EPM, do the following:
-
- 1) In a monitor window that contains error messages that resulted from
- a compilation error, double-click on the message that you are
- interested in. This will cause the WorkFrame to call the compiler
- DLL associated with the project to parse the error and return the
- file name, the line number and possibly the column number of the
- error. The WorkFrame will then start an editor session with that
- file and via a Dynamic Data Exchange (DDE) interface it will
- communicate the information to EPM/EE. The editor will then scroll
- to the correct line number and possibly column number.
-
- 2) Using the 'Compiler' pulldown that will appear only when EPM/EE is
- invoked this way, you can move between errors using the 'Next Error'
- and 'Previous Error' items.
-
- 3) Select 'Describe Error' under the 'Compiler' pulldown in order to
- see the errors associated with the current position in the file.
-
- 4) On the Describe errors list, you can select the 'Details' pushbutton
- in order to start the help associated with the compiler and to
- display an explanation of the error as well as the action(s) needed
- to recover from the error.
-
-
-
-
-
-
-
-
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- Section 11: ASCII Reference Chart
- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
- To enter an ASCII character, hold Alt key & enter decimal value on num pad
- +-----+--------------------------------------------------------------------+
- | DEC | ═ │ 0 │ 1 │ 2 │ 3 │ 4 │ 5 | 6 | 7 | 8 | 9 | 10| 11| 12| 13| 14| 15|
- | |HEX | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | A | B | C | D | E | F |
- +-----+----+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
- | 0 | 0_ |NUL| | | | | | | | | HT| LF| | | CR| | |
- | 16 | 1_ | | | | | | | | | | | | | | | | |
- | 32 | 2_ | | ! | " | # | $ | % | & | ' | ( | ) | * | + | , | - | . | / |
- | 48 | 3_ | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | : | ; | < | = | > | ? |
- | 64 | 4_ | @ | A | B | C | D | E | F | G | H | I | J | K | L | M | N | O |
- | 80 | 5_ | P | Q | R | S | T | U | V | W | X | Y | Z | [ | \ | ] | ^ | _ |
- | 96 | 6_ | ` | a | b | c | d | e | f | g | h | i | j | k | l | m | n | o |
- | 112 | 7_ | p | q | r | s | t | u | v | w | x | y | z | { | | | } | ~ | |
- | 128 | 8_ | Ç | ü | é | â | ä | à | å | ç | ê | ë | è | ï | î | ì | Ä | Å |
- | 144 | 9_ | É | æ | Æ | ô | ö | ò | û | ù | ÿ | Ö | Ü | ¢ | £ | ¥ | ₧ | ƒ |
- | 160 | A_ | á | í | ó | ú | ñ | Ñ | ª | º | ¿ | ⌐ | ¬ | ½ | ¼ | ¡ | « | » |
- | 176 | B_ | ░ | ▒ | ▓ | │ | ┤ | ╡ | ╢ | ╖ | ╕ | ╣ | ║ | ╗ | ╝ | ╜ | ╛ | ┐ |
- | 192 | C_ | └ | ┴ | ┬ | ├ | ─ | ┼ | ╞ | ╟ | ╚ | ╔ | ╩ | ╦ | ╠ | ═ | ╬ | ╧ |
- | 208 | D_ | ╨ | ╤ | ╥ | ╙ | ╘ | ╒ | ╓ | ╫ | ╪ | ┘ | ┌ | █ | ▄ | ▌ | ▐ | ▀ |
- | 224 | E_ | α | ß | Γ | π | Σ | σ | µ | τ | Φ | Θ | Ω | δ | ∞ | φ | ε | ∩ |
- | 240 | F_ | ≡ | ± | ≥ | ≤ | ⌠ | ⌡ | ÷ | ≈ | ° | ∙ | · | √ | ⁿ | ² | ■ |DEL|
- +-----+----+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+
-