home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 5 Edit
/
05-Edit.zip
/
epmapp.zip
/
EPMHELP.QHL
< prev
next >
Wrap
Text File
|
1994-07-20
|
21KB
|
529 lines
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
EPMBBS package, which is available on the IBM BBS systems, via anonymous FTP
from software.watson.IBM.com (and various other FTP sites), through
Compuserve Information Services, and on the Developer's Connection CD-ROM.
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|
+-----+----+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+---+