home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d1xx / d113 / dme.lha / Dme / dme.doc < prev    next >
Text File  |  1987-11-21  |  30KB  |  768 lines

  1.  
  2. DME.DOC         DME version 1.28f        Matthew Dillon
  3.             15 November 1987
  4.  
  5. DME V1.28f (C)CopyRight 1987, Matthew Dillon.  All Rights Reserved. This
  6. software may be distributed for non-profit only.  This software is NOT
  7. shareware.
  8.  
  9.     Matthew Dillon
  10.     891 Regal Rd
  11.     Berkeley, Ca. 94708
  12.  
  13.     Source is avalable:
  14.  
  15.     (1) By anonymous FTP to UCBVAX.BERKELEY.EDU (ARPANET)
  16.     (2) By regular mail (send a disk, don't worry about return postage)
  17.     (3) By Electronic mail:
  18.         ARPANET:    dillon@ucbvax.berkeley.edu
  19.         USENET:    ...!ihnp4!ucbvax!dillon
  20.  
  21.     (4) The BBS I frequent most often is BBSJC @ 415-961-7250, but this
  22.         is not a guarenteed path.
  23.  
  24.     Donations welcome but not solicited (I ain't a starving artist).
  25.  
  26.     NOTE! Major Changes this release:  You can now use open and close parenthesis
  27.     rather than open and close single quotes () vs `' to surround arguments.
  28.     Thus you can do: (') or `(', and foreign keyboards which do not have
  29.     `' can use parenthesis.
  30.  
  31.     icon by Bryce Nesbitt
  32.  
  33. ---------------------------------------------------------------------------
  34.  
  35. I   Overview
  36. II  Keymapping        key and mouse mapping
  37. III Command Sequences    DME commands
  38. IV  File Particulars    notes on loading and saving files,
  39. V   Workbench Support
  40. VI  Revision Summary    revision numbering, changes made, etc...
  41. VII Compiling        compiling instructions
  42.  
  43.                     I
  44.                  OVERVIEW
  45.  
  46. See REVISIONS section for revisions.  DME is an editor designed mainly for
  47. programmers.  Although it is not a word processor, it does include many
  48. word processing features such as Word-Wrap and automatic paragraph
  49. formatting.  Here is a quick 'features' list:
  50.  
  51.     -control language based on a rich command set accessed manually
  52.      or via arbitrary mapping of keys.  (Every key may be mapped to 128
  53.      different things via qualifier and mouse keys)
  54.  
  55.     -fast visual response (it scrolls quickly)... even faster when
  56.      BlitzFonts or similar text speedup utilities are installed.
  57.  
  58.     -title-line statistics showing your current position in the file,
  59.      file name, whether the file has been modified or not, etc...
  60.  
  61.     -Multiple Windows, ability to iconify windows
  62.  
  63.     -Word Wrap and automatic paragraph formatting.
  64.  
  65.     -ability to map any KEY or MOUSE BUTTON combination.
  66.  
  67. DME has been designed to allow easy expansion, and I intend to make many
  68. future improvments.  It has not been designed for user friendliness, but is
  69. straight forward if you read this document [care]fully.
  70.  
  71. DME can take any number of arguments.  Any argument without a '-' in front
  72. of it is considered to be a file.   Normally, DME will automatically SOURCE
  73. two script files, S:.EDRC, and the .EDRC in your current directory. These
  74. files do not have to exist.  These script files usually contain mappings
  75. and do things (for example, turn on savetabs).
  76.  
  77.     FLAGS:
  78.         -ffilename        -source this script file instead of .EDRC
  79.  
  80.         -b            -normally when multiple files are specified,
  81.                  DME opens them with small windows.  This opens
  82.                  them with normal sized windows.
  83.  
  84.         -tN     -Open the window on scan line N
  85.         -lN     -Open the window offset N scan columns
  86.         -wN     -Make the window N pixels wide
  87.         -hN     -Make the window N pixels high
  88.  
  89.  
  90.                     II
  91.                  KEYMAPPING
  92.  
  93. MOUSE BUTTONS:
  94.  
  95.     The mouse buttons and combinations thereof may now be mapped.  The
  96.     default mappings for the mouse buttons are as follows:
  97.  
  98.     Left-button:    Move cursor to current mouse position
  99.     Right-button:   Iconify window
  100.     Left-button held down while moving mouse tracks the cursor
  101.  
  102.     The iconification features:
  103.     -Remembers original window size and placement
  104.     -Remembers placement of iconified window when you re-iconify later.
  105.  
  106.     Currently, you will crash the machine if you run out of memory and DME
  107.     is unable to open the icon window or original window, so be careful.
  108.  
  109.     see below for mapping the mouse buttons and mouse movement.
  110.  
  111.  
  112. KEYBOARD:
  113.  
  114. The rest of the Functional interface for DME is based on key/mouse mappings
  115. and a rich command set.  Unlike other text editors, any non-qualifier key
  116. in DME may have any meaning whatsoever.  It just so happens that the
  117. default keymappings assign such things as the `return' key to the RETURN
  118. function, the `up' key to the UP function, etc...  Keys are named by their
  119. keycap labels with the following exceptions:
  120.  
  121.     the name for Back-Space is    BS
  122.     the name for numeric keypad keys are prepended with an NK, except for
  123.     the Enter key which is named 'ENTER'.
  124.     The four cursor control keys are labeled UP, DOWN, LEFT, and RIGHT
  125.     The three mouse buttons are labeled RMB, MMB, and LMB.
  126.  
  127. *NOTE*    the normal Amiga mouse has only two buttons, the Left and the Right
  128. mouse buttons (LMB, RMB).  A properly installed three-button mouse is
  129. also supported.
  130.  
  131. *NOTE*    You must type commands in lower-case, except for text, which can be
  132. either lower or upper case, and for upper-case alpha keys when specifying
  133. keymaps (i.e.  A and s-a are the same key).  The exception is the AMIGA
  134. qualifier key, which uses 'A' instead of 'a'(Alt).
  135.  
  136. Each key may be qualified with any combination of CTRL, ALT, SHIFT, AMIGA,
  137. or any of the MOUSE buttons.  With 6 qualifiers (7 if your mouse has a
  138. middle button), you can assign up to 64 (128) different maps to each
  139. physical key on the keyboard.
  140.  
  141. NOTE: The CAPS-LOCK, when lit, is equivalent to SHIFT only for Alpha keys.
  142.  
  143. NOTE: The AMIGA-ALT (aA) combination isn't very usable since Intuition uses
  144. the sequence to duplicate a Mouse SELECT.  Other AMIGA sequences are used
  145. by intuition for mouse movement and other things.  Some other qualifier
  146. combinations may not be usable due to other special sequences.
  147.  
  148.     ***EXAMPLES:***
  149.  
  150.     tab tab
  151.     a-a ALT a
  152.     A-a AMIGA a
  153.     sA-a    SHIFT AMIGA a
  154.     s-tab    SHIFT tab
  155.     c-tab    CTRL tab
  156.     ac-?    ALT-CTRL ?
  157.     s-f5    SHIFT F5
  158.     nk0 Numeric Keypad 0
  159.     cs-nk0    CTRL SHIFT Numeric Keypad 0
  160.     L-lmb    Left Mouse button pressed
  161.     L-mmove    Mouse moved while left mouse button held down
  162.     LR-lmb    left mouse button hit while right mouse button held down
  163.  
  164.     ***************
  165.  
  166. MAPPING MOUSE BUTTONS
  167.  
  168.     Mouse buttons serve both as QUALIFIERS and as KEYS.  Thus, you can map
  169.     both normal keystrokes which require a mouse button to be held down:
  170.  
  171.     map L-a ``left button and an a''
  172.  
  173.     as well as the mouse keys themselves:
  174.  
  175.     map L-lmb   ``left mouse key''
  176.  
  177.     note that you had to specify the left mouse button down qualifier L as
  178.     well as the left mouse button LMB.
  179.  
  180.     If you map the left mouse button, and also map a sequence such as left
  181.     mouse button + a:
  182.  
  183.     map L-lmb   tomouse
  184.     map L-a     ``hello''
  185.  
  186.     Note that the first mapping will always get executed even if you
  187.     intended L-a (that is, BOTH mappings would get executed).  In order
  188.     to avoid confusion you might want to UNMAP the system default mapping
  189.     for the right mouse button (mapped to ICONIFY) if you wish to apply
  190.     combinations to the right mouse button.
  191.  
  192.     MOUSE MOVEMENT is mapped with one or more mouse qualifiers (L, R, M),
  193.     plus 'MMOVE' for the key.  That is:
  194.  
  195.     map LR-mmove ``moving the mouse with both buttons held down''
  196.  
  197.     Or how bout capping the characters under the mouse while moving the
  198.     mouse?
  199.  
  200.     map LR-mmove `tomouse if cl `tlate -32''
  201.  
  202.  
  203.  
  204. DEFAULT KEYMAPPINGS:
  205.  
  206.     All Printable Ascii keys mapped to their ascii equivalent. BS, DEL, UP,
  207.     DOWN, LEFT, RIGHT, TAB, S-TAB, and ENTER are mapped properly.  These are
  208.     the default system keymappings.
  209.  
  210.  
  211.     map `a-c'       `bcopy'
  212.     map `a-d'       `bdelete'
  213.     map `a-down'    `scrolldown'
  214.     map `a-l'       `while cu `tlate +32 right''
  215.     map `a-m'       `bmove'
  216.     map `a-r'       `nextr'
  217.     map `a-s'       `bsource'
  218.     map `a-u'       `while cl `tlate -32 right''
  219.     map `a-up'      `scrollup'
  220.     map `bs'        `bs'
  221.     map `c-/'       `escimm `find ''
  222.     map `c-]'       `ref'
  223.     map `c-1'       `goto block'
  224.     map `c-b'       `block'
  225.     map `c-c'       `'
  226.     map `c-del'     `remeol'
  227.     map `c-down'    `pagedown'
  228.     map `c-esc'     `recall'
  229.     map `c-f'       `reformat'
  230.     map `c-g'       `escimm `goto ''
  231.     map `c-i'       `insertmode on'
  232.     map `c-j'       `join'
  233.     map `c-l'       `wleft'
  234.     map `c-n'       `next'
  235.     map `c-o'       `insertmode off'
  236.     map `c-p'       `prev'
  237.     map `c-q'       `quit'
  238.     map `c-r'       `wright'
  239.     map `c-s'       `split first down'
  240.     map `c-u'       `unblock'
  241.     map `c-up'      `pageup'
  242.     map `c-w'       `wordwrap toggle'
  243.     map `del'       `del'
  244.     map `down'      `down'
  245.     map `enter'     `return'
  246.     map `esc'       `esc'
  247.     map `f1'        `escimm `insfile ''
  248.     map `f10'       `saveold quit'
  249.     map `f2'        `escimm `newfile ''
  250.     map `f3'        `escimm `newwindow newfile ''
  251.     map `f6'        `saveold iconify'
  252.     map `f7'        `escimm `bsave ''
  253.     map `f8'        `saveold escimm `newfile ''
  254.     map `f9'        `saveold'
  255.     map `L-lmb'     `tomouse'
  256.     map `L-mmo'     `tomouse'
  257.     map `left'      `left'
  258.     map `R-rmb'     `iconify'
  259.     map `return'    `return insline up firstnb down'
  260.     map `right'     `right'
  261.     map `s- '       `` ''
  262.     map `s-del'     `deline'
  263.     map `s-down'    `bottom'
  264.     map `s-left'    `first'
  265.     map `s-right'   `last'
  266.     map `s-tab'     `backtab'
  267.     map `s-up'      `top'
  268.     map `sa-s'      `unblock block block bsource'
  269.     map `tab'       `tab'
  270.     map `up'        `up'
  271.  
  272.  
  273.  
  274.                     III
  275.                  COMMAND SEQUENCES
  276.  
  277. DME has a rich command set which allows you to embed commands within
  278. commands, or specify multiple commands in a row.  A command consists of a
  279. KEYWORD followed by a FIXED number of arguments (0, 1, 2...).  The argument
  280. delimeter in DME is a SPACE.  Therefore, to embed strings containing spaces
  281. as a single argument, you must surround the string with `string'
  282. (backsinglequote-string-singlequote).  TEXT to be written as if typed is
  283. also specified via a string in backquote-quotes.  For example:
  284.  
  285.     right right `hello' right right `hello' enter down
  286.     map f4 `right right' map f5 `left left'
  287.     map f4 ``hello''
  288.  
  289. Reiterating (because this is important!)... If a command expects ONE
  290. argument, then it really does expect a single argument, and any remaining
  291. arguments are thought to be the next command... so:
  292.  
  293.     map f4 right
  294.                     -right is only one word, so no need
  295.                      for `'.
  296.     map f4 `right right'
  297.                     -we want to map f4 to two rights... we
  298.                      need the `' or the second right will
  299.                      not be part of the map.
  300.  
  301.     map c-del `repeat cright del'
  302.                     -this is already implimented as REMEOL,
  303.                      but shown here for clarity.
  304.  
  305. Some arguments will eventually be fed through the command interpreter more
  306. than once.  The MAP command is a good example.    When you execute a MAP
  307. command, the first run through the command interpreter installs the map
  308. string minus a set of quotes.  So, if you want to specify text, you must
  309. enclose the text in two sets of ``text'' because the map string gets passed
  310. through the command interpreter again when you hit the mapped key.  Here
  311. are some more complex examples:
  312.  
  313.     map f4 `right right `hello' left left'      *RIGHT*
  314.     map f4 right right hello left left        *WRONG*
  315.  
  316.     map f4 `map f4 ``hello'''
  317.                     -the first time you hit F4, it's command
  318.                      is to re-map itself to the TEXT `hello'.
  319.                      (gads!).
  320.  
  321.     map c-i `repeat tr `` '''
  322.                     -example of how to embed a space in a
  323.                      map and repeat (goes through command
  324.                      interpreter three times!).
  325.  
  326.  
  327. An easy way to fool around executing commands or making maps is either to
  328. use the ESC key (which enters command mode), or  a-S (alt-shift-s), which
  329. EXECUTES the current DME line that the cursor is on.... so you can use DME
  330. to edit and test your new keymappings.
  331.  
  332.  
  333.     COMMAND LIST
  334.  
  335.     `text'          -enter text as if typed.
  336.     key         -execute a keymap as a macro (example:  c-a)
  337.     BACK        -same as BS
  338.     BACKTAB        -backward tab
  339.     BCOPY        -copy block before cursor line
  340.     BDELETE        -delete the block
  341.     BLOCK        -Set start or end of block
  342.     BMOVE        -move block before cursor line
  343.     BOTTOM        -Move to Bottom of File
  344.     BS            -backspace, (delete char to left of cursor)
  345.     BSAVE file        -save the block to a file
  346.     BSOURCE        -source current text block as if it were a script file
  347.     CHFILENAME name -change the name of the working file
  348.     DEL         -delete, (deletes char under cursor)
  349.     DELINE        -delete line
  350.     DOWN        -cursor down
  351.     DOWNADD        -cursor down.  If at bottom of text, add a line.
  352.     ESC         -toggle manual command entry mode
  353.     ESCIMM arg        -go into command entry mode prompting with a
  354.              predefined string.
  355.     EXECUTE comm    -Execute a CLI command
  356.     FIND string     -SET the search pattern and do a NEXT
  357.     FINDR s1 s2     -Set find and replace patterns and do one find/rep.
  358.     FINDSTR string  -SET the search string pattern
  359.     FIRST        -move to column 1
  360.     FIRSTNB        -Move to first non-blank in line.
  361.     GOTO BLOCK        -Goto the beginning of the marked block.
  362.     GOTO START        -same as GOTO BLOCK.  undefined if no block
  363.     GOTO END        -goes to the END of the marked block.  undef. if no blk.
  364.     GOTO [+/-]N     -Goto an absolute or relative line number
  365.     HEIGHT N        -set height in pixels for any new windows
  366.     ICONIFY        -iconify the window
  367.     IF cnd act        -IF/WHILE/IFELSE.. SEE BELOW
  368.     IFELSE cnd ifact elseact
  369.     INSERTMODE what -set INSERTMODE.  what = on, off, or toggle
  370.     INSFILE name    -insert a file into the current text.
  371.     INSLINE        -insert line
  372.     JOIN        -join next line to line at cursor
  373.     LAST        -move one beyond the last non-space in a line.
  374.     LEFT        -cursor left
  375.     LEFTEDGE N        -set leftedge in pixels for any new window
  376.     MAP key map     -map a key to a keymap
  377.     MARGIN N        -set WordWrap and paragraph formatting margin
  378.              (related to WORDWRAP and REFORMAT)
  379.     NEWFILE name    -replace current text with new file
  380.     NEWWINDOW        -open newwindow
  381.     NEXT        -find next occurance of search pattern
  382.     NEXTR        -find next occurance and replace
  383.     PAGEDOWN        -pagedown a partial page (see PAGESET)
  384.     PAGESET n        -n PERCENT (0 to 100). page step size relative to the
  385.              current number of rows in the window.
  386.     PAGEUP        -pageup a partial page (see PAGESET)
  387.     PREV        -find previous occurance of search pattern
  388.     PREVR        -find previous occurance and replace
  389.     QUIT        -quit
  390.     RECALL        -recall most recently entered command.  Must be used
  391.              from a keymap (c-esc).
  392.     REF         -reference string under cursor (see below)
  393.     REFORMAT        -reformat paragraph using the margin.
  394.     REMEOL        -Remove text under and beyond the cursor.
  395.     REPEAT cnt comm -SEE BELOW
  396.     REPSTR string   -SET the replace string pattern
  397.     RESETTOGGLE N   -clear toggle array entry N(0..31)
  398.     RESIZE cols rows-Resize current window. E.G:  `resize 70 23'
  399.     RETURN        -same as `FIRST DOWNADD'
  400.     RIGHT        -cursor right
  401.     SAVEAS file     -save current text under a different name (title
  402.              line name does not change)
  403.     SAVEMAP file    -save user keymappings
  404.     SAVEOLD        -save current text under current name
  405.     SAVESMAP file   -save all keymappings, including system keymaps
  406.     SAVETABS on/off -Optimize file saves by crunching spaces to tabs.
  407.              The default is OFF.
  408.     SCANF ctlstr    -scan the string at the current text position (C scanf)
  409.              example:    `scanf %s'          SEE BELOW
  410.     SCREENBOTTOM    -Move cursor to the bottom of the screen.
  411.     SCREENTOP        -Move cursor to the top of the screen
  412.     SCROLLUP        -Scroll up without moving cursor
  413.     SCROLLDOWN        -Scroll down without moving cursor
  414.     SETTOGGLE N     -set toggle array entry N  (0..255)
  415.     SOURCE file     -source a script file. '#' in first column for comment
  416.     SPLIT        -Split line at cursor
  417.     TAB         -forward tab
  418.     TABSTOP N        -Set tab stops every N.  does not effect text load
  419.     TLATE [+/-]N    -translate character by +N or -N, or set character
  420.              to exactly N if no + or -. (e.g. TLATE +65 TLATE 3)
  421.     TOGGLE N        -flip toggle array entry N (0..255)  (See IF)
  422.     TOMOUSE        -moves cursor to mouse position
  423.     TOP         -Move to Top of File
  424.     TOPEDGE N        -set topedge in pixels for any new window
  425.     UNBLOCK        -clear the block markers for the current window
  426.     UNMAP key        -unmap a key
  427.     UP            -cursor up
  428.     WHILE cnd act   -(see below)
  429.     WIDTH N        -set width in pixels for any new window
  430.     WLEFT        -move to beginning of previous word.  If in the
  431.              middle of a word, move to beginning of current word.
  432.     WORDWRAP on/off/toggle
  433.             -Word Wrap mode (related to MARGIN)
  434.     WRIGHT        -move to beginning of next word
  435.  
  436.  
  437.  
  438.     -------------    More Info on Complicated Commands    -----------------
  439.  
  440.     REF     (c-])   -(1.28d and beyond).  This is a very powerful new
  441.              command that allows you to bring up a reference to
  442.              a keyword with a single keystroke.  This is useful for
  443.              programmers who have on-line documentation or fully
  444.              commented include files.  DME opens a window just big
  445.              enough to fit the reference.
  446.  
  447.              The reference keyword is the alpha-numeric string
  448.              currently under the cursor.  REF will attempt to find
  449.              a match in the file DME.REFS, S:DME.REFS,
  450.              DF0:S/DME.REFS ... DF3:S/DME.REFS.  This file must be
  451.              built by the user.  Each line has the following format:
  452.  
  453.              `key' `lines or endstring' `file' `beginstring'
  454.  
  455.              Upon finding a successful match, `file' is openned and
  456.              scanned until `beginstring' is found.  The section of
  457.              text between `beginstring' and `endstring' inclusive
  458.              is placed in a temporary file and a new DME window is
  459.              openned with the contents.  (if `endstring' is a
  460.              number, it specifies the number of lines to be
  461.              transfered to the new DME window).  The temporary file
  462.              is then deleted.
  463.  
  464.              When scanning for `endstring' or `beginstring',
  465.              compares are anchored at the beginning of each line in
  466.              `file'.  Thus, any spaces in front of either string is
  467.              critical and must be included in the DME.REFS entry.
  468.  
  469.              T: must be assigned to a temporary directory, usually
  470.              RAM:   See the included example DME.REFS file.  The
  471.              most common things referenced are the autodocs and
  472.              commented include files.
  473.  
  474.              Some modification of the included DME.REFS files may
  475.              be required due to differences in include file and
  476.              autodoc format.
  477.  
  478.  
  479.     SCANF ctlstr    -This is equivalent to the C scanf() function with the
  480.              restriction that only one conversion is allowed, that
  481.              conversion being a string.  Thus:
  482.  
  483.              scanf %s        will place the string under the
  484.                     cursor in the variable $scanf
  485.  
  486.              scanf %4s        The first four chars of the string.
  487.  
  488.              scanf %[0123456789]
  489.                     will scan the string while it contains
  490.                     specified chars (e.g. scan a number)
  491.  
  492.              scanf %[~,]    will scan the string until it finds
  493.                     a ','.
  494.  
  495.             The variable $scanf may be used as an argument in any
  496.             command.  Example:    `insfile $scanf'
  497.  
  498.  
  499.     REPEAT N arg    -Repeat `arg' N times.  Apart from being a number, N
  500.              can also be one of:
  501.  
  502.             line    Current line # (lines begin at 1)
  503.             lbot    #lines to the bottom, including current line
  504.             cleft    column # (cols begin at 0)
  505.             cright    #chars to eol, including current char under cursor
  506.             tr    #char positions to next tab
  507.             tl    #char positions to next back tab
  508.  
  509.             Certain commands can abort a REPEAT loop.
  510.             Specifically, any FIND[R], NEXT[R], or PREV[R] in which
  511.             the search string is NOT found will abort a REPEAT.
  512.             Most operations which can go out of bounds, such as
  513.             UP, LEFT, RIGHT, DOWN, also abort a repeat.
  514.  
  515.             Specifying -1 as N causes REPEAT to go on forever
  516.             (well, actually, 0xFFFFFFFF times) or until an abort.
  517.  
  518.     IF [!]condition arg
  519.     WHILE [!]condition arg
  520.     IFELSE [!]condition arg else arg
  521.  
  522.         If the specified condition is true, execute the argument.  For
  523.         WHILE, the argument is executed until the condition is false
  524.         (be careful!).
  525.  
  526.         the optional '!' inverts the logic.
  527.  
  528.         Conditions:
  529.  
  530.         #        if toggle entry # is SET.  there are 256 toggles (0..255)
  531.         t        if On line 1
  532.         b        if On last line
  533.         l        if At column 0
  534.         r        if At end of line (spaces below and beyond)
  535.         m        if Text has been modified
  536.         i        if in insert mode
  537.         x[<=>]# if column position (starts at 1) is (any OR combo of
  538.             <, =, or >) than some number.  Example:   x<=20
  539.         y[<=>]# if Line number (starts at 1) is (same as for x)
  540.         cl        character under cursor is lower case alpha
  541.         cu        character under cursor is upper case alpha
  542.         ca        character under cursor is alpha-numeric
  543.         cn        character under cursor is numeric
  544.         c[<=>]# character under cursor is ascii code # (# in decimal)
  545.             optional conditionals as in 'x' and 'y'.
  546.         cb        cursor within a block
  547.  
  548.     Example: simulating an insert mode toggle: ALT-i (not CTL-i)
  549.  
  550.     map a-i `ifelse 0 `toggle 0 insertmode OFF' `toggle 0 insertmode ON''
  551.  
  552.     Example: while lower case, map to upper case and move right.
  553.  
  554.     map c-U `while cl `tlate -32 right''
  555.  
  556.     Example: Search/Replace all of text.
  557.  
  558.     map c-R `escimm `findstr ' escimm `repstr ' repeat -1 nextr'
  559.  
  560.      if c<32 ``char under cursor is smaller than 32''
  561.      if c<>32 ``char under cursor is not equal to 32''
  562.      while !b down
  563.  
  564.  
  565.                     IV
  566.                  FILE PARTICULARS
  567.  
  568. No Matter what you set internal tabs to, tabs in disk files will be 8.
  569. This allows you to use your favorite tabs stops (mine are 4) and still
  570. have your disk files compatible with TYPE, a printer, etc...  DME by
  571. default doesn't bother to optimize when writing out files and simply uses
  572. spaces. If you `SAVETABS on' before saving (or in your S:.EDRC, etc...),
  573. DME will attempt to optimize the file by placing TABS in appropriate
  574. places.  DME will not place any TABS after the first single, back, or
  575. double quote is encountered in a line.    If this does not cover every
  576. situation in your particular application that you want to be *sure* no tabs
  577. will occur in sensitive sections, then you should not use `SAVETABS on'.
  578.  
  579. It should be noted that since DME removes spaces at the end of the line,
  580. editing UUENCODED ascii files will not work for uuencoded lines which end
  581. with a space.  The nominal fix is to add an extra character after each
  582. uuencoded line (anything) in the proper column, which is ignored by the
  583. UUDECODE program.
  584.  
  585. The command to save the current document under the default name is SAVEOLD,
  586. *not* SAVE.  SAVE is not a valid command.  This is to prevent people who
  587. have not read the documentation from assuming 'save' takes an argument (and
  588. screwing up their work).  SAVEOLD does NOT take an argument, SAVEAS does.
  589.  
  590. SAVEOLD/SAVEAS do not automatically backup the destination file.  If you
  591. are working in an enviroment where you are worried about ensuring a viable
  592. copy can be recovered if your Amiga crashes in the middle of the save, you
  593. can write a macro to save the file into two places.  Usually, people backup
  594. their working disks so this is not neccesary.
  595.  
  596. Workbench Support:  If DME is run from the workbench, it will automatically
  597. construct an icon file when you save a document.  If run from a CLI, no
  598. icon file is generated.
  599.  
  600.                     V
  601.                   WORKBENCH SUPPORT
  602.  
  603. DME V1.26 and beyond support the workbench in the following way:  (1) you
  604. can click on the DME icon to bring up DME with the file "unnamed".  (2) you
  605. can select one or more standard ascii documents which have DME as the
  606. default tool.  If DME has no knowlege of a text icon, it uses its own.
  607. Command line arguments are passed to DME via the tooltypes entries for
  608. DME's application icon or via individual document icons.  The following
  609. format is used:  (This is a hack, no?)
  610.  
  611.     ARG=flag
  612.  
  613.     See the OVERVIEW section for allowed flags.  Only one argument per line
  614.     is allowed (sorry).  The tooltypes for the application icon are
  615.     processed first, then the tooltypes for each document icon are
  616.     processed before each file is loaded.
  617.  
  618.     ARG= -t10
  619.     ARG= -l10
  620.  
  621.                     VI
  622.                   REVISION SUMMARY
  623.  
  624. V1.28f RELEASE
  625.     Fixed macro bug created in 1.28e... could not specify macros on the
  626.     command line.
  627. V1.28e INTERNAL/BETA
  628.     New Commands:   REF     (c-])   -cross reference the word under the
  629.                      cursor and bring up a new window
  630.                      containing a description for that
  631.                      word.  See docs above.
  632.  
  633.     -The keymapping has been fixed and should now work on any foreign
  634.      keyboard.
  635.     -MAJOR ADDITION:  () may be used instead of `' to enclose commands.
  636.      One can enclose the other ... that is, to get the "'" character you
  637.      can say (this is a charlie's day).
  638.  
  639. V1.28c RELEASE
  640.     New Commands:   CHFILENAME        -change default filename for a window
  641.             RECALL  (c-esc) -recall command line (e.g. you make a
  642.                      mistake).    Must be used from a keymap,
  643.                      default is c-esc.
  644.  
  645.             SCANF        -C scanf (single string only).  Extract
  646.                      strings from the text for use in any
  647.                      arbitrary command.
  648.  
  649.     Command Parser: $scanf        -as an argument by itself is recognized
  650.                      to be the extracted string from scanf.
  651.                      Currently, the variable name (after
  652.                      the dollar) can be anything since only
  653.                      one variable exists, but use '$scanf'
  654.                      for future compatibility.
  655.  
  656.     -Many Bug fixes (mainly benign bugs)
  657.     -^C (CONTROL C) now recognized when typed in a window.  c-c is mapped
  658.      to `' (no action).
  659.     -Please look at the revised default keymappings listed in these docs.
  660.  
  661.  
  662. V1.28 LIMITED RELEASE
  663.     New Commands :  SCROLLUP    (a-up)
  664.             SCROLLDOWN    (a-down)
  665.     Modified Cmds:  ESCIMM
  666.     The execution of commands specified by an ESCIMM is blocked until
  667.     the user hits return on the ESCIMM command line.
  668.  
  669.             BCOPY
  670.     No longer unblocks the block.
  671.  
  672.     -Title bar status line no longer blinks when it changes
  673.     -Key releases no longer effect operation
  674. V1.27 RELEASE
  675.     -macros run about 20% faster due to hashing of the command table
  676.     -Maximum # of toggles raised to 256 (see IF/WHILE)
  677.     -small fixes to the code (nothing major)
  678.     -child windows inherit tab stops, insert mode, and wordwrap mode
  679.     -MOUSE BUTTONS AND MOVEMENT CAN NOW BE MAPPED
  680.     -New Commands: ICONIFY    (used to be hardwired.  Is now a command)
  681.     -Extended Commands: GOTO    (GOTO END of block)
  682. V1.26 Beta, minimal Release
  683.     -Workbench support
  684.     -New Command:   EXECUTE
  685. V1.25 RELEASE
  686.     -BSAVE does NOT UNBLOCK after saving (switch in functionality yet again)
  687.     -various bugs fixed (IF, tabs on file save)
  688.     -New Commands: MARGIN, REFORMAT, WORDWRAP, RESIZE,
  689.            TOPEDGE, LEFTEDGE, WIDTH, HEIGHT
  690.     -Command line options added for setting the window size and an optional
  691.      specified script file (when specified, local .EDRC not sourced).
  692.  
  693.     -Enhanced Commands: IF  ..more control with conditions, addition of
  694.                   a couple more specifications.
  695.                JOIN .. functionality slightly changed
  696.     -keymaps may now be used as macros in other commands. (macros)
  697.     -New keymaps added to the default set.
  698.     -Mouse movement cleaned up a little.
  699.  
  700. V1.24 Internal
  701.  
  702. V1.23 RELEASE
  703.     -S:.EDRC now sourced instead of C:.EDRC
  704.     -User keymappings now work in COMMAND mode (when you hit ESC).
  705.     -You can now map the Amiga keys ('A' for Amiga, since 'a' is alt).
  706.     -Enhanced Commands: IF/IFELSE/WHILE (optional '!' in front of cond)
  707.             new condition 'cb' 'character in selected block'
  708.             GOTO (can now say `goto block')
  709.     -NewCommands:    PAGESET SAVETABS
  710.     -Writing TABS (always 8) out to disk to save space now supported.
  711.  
  712. V1.22 RELEASE (BUF FIXES FROM 1.20)
  713.     -'newfile' fixed
  714. V1.21 RELEASE (BUG FIXES FROM 1.20)
  715.     -iconify and window handling fixed
  716.     -left mouse button now tracks the mouse.
  717. V1.20 RELEASE
  718.     -bug fixes: bsave now unmarks the block, bdelete now sets 'modified' flag.
  719.         (other small fixes).
  720.     -enhancements: overwrite mode status indicator, find, find-replace now
  721.         completely implemented (yahhoo!!!)
  722.     -changed commands:    FIND NEXT PREV: no longer loop back to the top of
  723.         file or top->bottom in the case of PREV.  DELINE will now delete
  724.         text on the line if there is only one line of text.
  725.     -enhanced commands: GOTO REPEAT
  726.     -new commands: SAVEMAP SAVESMAP TOGGLE SETTOGGLE RESETTOGGLE TLATE
  727.            IF IFELSE WHILE BSOURCE
  728.            FINDSTR REPSTR FINDR NEXTR PREVR
  729.            NEWWINDOW
  730.     -new keymappings: (see a-s, a-S, f3)
  731.     -window iconification with mouse menu button.
  732.  
  733.  
  734. V1.12 RELEASE
  735.     -cursor is now pen #3 rather than #1.
  736.     -changeover to AZTEC C, smaller executable.
  737.     -now maps shift space to a space.
  738.     -new commands: REMEOL, WLEFT, WRIGHT
  739.     -display bug fixes (SPLIT)
  740.     -FIND/PREV/NEXT will now abort a REPEAT if string not found.
  741.  
  742. V1.11 RELEASE NOTES
  743.     -Bug fixes (mainly graphical mistakes).
  744.     -User keymappings are disabled in command mode (so you can unmap
  745.       single ascii characters you may have mapped).
  746.     -Illegal key combinations no longer give garbage (e.g. ALT-CURSOR-DOWN)
  747.       you can, of course, still map them to anything you wish.
  748.     -Save now checks for error conditions on write.
  749.     -Uses Default Console Keymap (i.e. no longer assumes USA)... but there
  750.       *is* some stangeness.
  751.  
  752. V1.00 RELEASE NOTES
  753.     -has find, but no replace function
  754.     -marked blocks are not highlighted
  755.     -assumes USA keyboard            (fixed 1.11)
  756.     -disk files written out use spaces instead of tabs&spaces
  757.     -No scroll bar yet.
  758.  
  759.  
  760.                     VII
  761.                 COMPILING
  762.  
  763. DME compiles only under AZTEC.    You must compile with the 32 bit int
  764. option, but may use the small code/data model.    A support lib which I have
  765. created (SUP32.LIB) is also required.  I use a precompiled symbol file
  766. containing ALL the AMIGA includes (but not any Aztec standard includes).
  767.  
  768.