home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / bigemacs.arc / UEMACS.DOC < prev   
Encoding:
Text File  |  1986-07-29  |  9.9 KB  |  245 lines
  1. This file should be sufficient for anyone with previous editor experience
  2. to be able to begin using the Public Domain subset of EMACS called UEMACS,
  3. or, specifically, its successor BIGEMACS.
  4.  
  5. First off, BIGEMACS is probably called BIG because it can edit big files
  6. (well, igger than UEMACS' 32k limit, anyway). On a 640k PC with about 550k
  7. of TPA you won't run out of room until you hit about 280k's worth of data
  8. in the buffer. Slightly less, maybe, if you've been doing lots of patching.
  9.  
  10. BIGEMACS (from now on called EMACS for simplicity) contains commands to move
  11. the cursor (destructively and nondestructively) and buffer commands. Let's,
  12. however, start at the beginnming....
  13.  
  14.  
  15. EMACS is invoked by typing its name, optionally followed by a file name.
  16. If no file name is entered, EMACS will open a buffer and wait for input or
  17. commands. If a filename was specified, a buffer will be opened and given
  18. the name of the file. If the file exists and is not empty, it will be read
  19. into the buffer and the first 22 lines will be displayed.
  20.  
  21. Line 23 is the status line. From left to right, it contains the following
  22. information:
  23. - a star in column 2 means buffer has been modified, a dash is displayed
  24.   otherwise.
  25. - The name, MicroEMACS
  26. - the name of the current buffer
  27. - the name of the current file
  28.  
  29. There are two terms worth mentioning with regard to EMACS, namely the
  30. POINT and the MARK. The POINT is the location in text where the next insertable
  31. character will be inserted and is identical to the cursor location.
  32. The MARK is a point which can be inserted at the cursor location with a special
  33. command. The MARK will remain stationary until explicitly moved.
  34. All buffer commands operate on data between POINT and MARK.
  35.  
  36. 0. COMMAND CONVENTIONS
  37.    -------------------
  38.  
  39. There are three types of commands in EMACS:
  40.  
  41. - single-character commands, which are certain CONTROL characters (ie hold
  42.   down the CTRL key while pressing the command key). They will be shown as
  43.   "^", as in "^C" meaning CONTROL-C
  44. - double-key commands prefixed by CTRL-X. They will be shown as "^Xx" where
  45.   "x" is the secondary key. You press and repease ^X, then press the seconday
  46.   command key. Example, "^X^C" to exit EMACS.
  47. - meta commands, which are commands prefixed by ESC just like the "^X" commands.
  48.  
  49.  
  50. 1. POINT MOVEMENT
  51.    --------------
  52.  
  53. The point (or cursor) can be moved in all directions with the following
  54. commands:
  55.  
  56.    1.1  NONDESTRUCTIVE MOVEMENT
  57.  
  58. ^P    cursor up. If cursor is at the top, move the screen down by 1/2
  59.     screen and position the cursor in the center line.
  60. ^N    cursor up. If cursor is at the bottom, move the screen up by 1/2
  61.     screen and position the cursor in the center line.
  62.    NOTE that the above commands will "remember" the cursor column.
  63. ^B    cursor left. if cursor is at the start of a line, moves cursor to
  64.     the end of the previous line.
  65. ^F    cursor right. If cursor is at the end of a line, move it to the
  66.     start of the next line.
  67. ^V    next page. cursor moves to the next page and is positioned in
  68.     row 1, column 1
  69. ESC ^V    previous page. cursor moves to the previous page, row 1 col 1.
  70. ESC <    sof. cursor moves to start of file.
  71. ESC >    eof. cursor moves to end of file.
  72. ^A    cursor moves to start of line.
  73. ^E    cursor moves to end of line.
  74.   NOTE    use the ARROW keys on IBM PC under BIGEMACS, as well as HOME=ESC<,
  75.     END=ESC>, and PgUp and PgDn for movement.
  76.  
  77. ^X^P    (also Alt-P) scrolls the whole screen down
  78. ^X^N    (also Alt-N) scrolls the whole screen up.
  79.  
  80. ESC F    move to next word
  81. ESC P    move to previous word
  82. ESC !    reposition cursor on screen (moves display so that cursor is
  83.     in row 1 col 1)
  84. ESC .    Set point equal to mark (point at current cursor position)
  85. ^X^X    Exchange MARK and POINT (move cursor to POINT, move POINT to
  86.     previous cursor location).
  87.  
  88.    1.2    DESTRUCTIVE MOVEMENT AND DELETE/INSERT
  89.  
  90. ^H    (or backspace key) moves the cursor left, removing the character
  91.     to the immediate left. concatenates current and previous line if
  92.     used at the start of a line.
  93. ^D or
  94. DEL    (delete key) deletes the character UNDER the cursor (logically, it
  95.     is just to the right of the cursor).
  96. INS    (insert key) inserts a newline at the cursor location.
  97. ^T    juxtapose character under cursor and previous character.
  98. ESC^H    delete previous word
  99. ESC D    delete next word
  100. ESC C    capitalize word
  101. ESC L    lowercase word
  102. ESC U    uppercase word
  103.  
  104. 2. BUFFER COMMANDS
  105.    ---------------
  106.  
  107. The remainder of the commands, with the exception of the spawn and status
  108. commands operate on buffers.
  109.  
  110.    2.1    BUFFER DELETE/UNDELETE
  111.  
  112. The delete/undelete sequence can be used to move blocks of data. All killed
  113. data will be stored in a KILL BUFFER until the next kill. It may be retrieved
  114. from the kill buffer at a keystroke, as many times as desired.
  115.  
  116. ^K    KILL from the cursor position to the end of the line. If the cursor
  117.     is at the end of the line, the newline character will be removed.
  118. ^W    WIPE ALL DATA from the cursor position to the POINT. Note that if
  119.     POINT is at SOF and cursor is at EOF, whole file will be WIPEd.
  120. ^Y    YANK (unkill) contents of kill buffer at current cursor location.
  121.  
  122.    NOTE that consecutive ^Ks append to the kill buffer until any other
  123.     command is issued! Thus (and you may try this), ^K^K^N^Y moves
  124.     a line below the next line, while ^K^K^N^K^K^Y irretrievably
  125.     deletes the first-killed line, and moves the second-killed
  126.     line in place.
  127.     The KILL BUFFER is global in nature, ie the contents may be yanked
  128.     in any buffer or window.
  129.  
  130.    2.2  BUFFER MOVEMENT
  131.  
  132. EMACS can use many different buffers with different files active in each.
  133.  
  134. ^XB    select new buffer. You will be asked to enter a buffer name. If it
  135.     does not exist, the screen is cleared and a new buffer is created.
  136.     Otherwise, the contents of the new buffer are displayed.
  137. ^XN    switch to next buffer (below current buffer). Good only if more than
  138.     one buffer is displayed.
  139. ^XP    switch to previous buffer (above current buffer).
  140.  
  141. ^X1    expand current buffer to fill the screen (use after splitting screem)
  142. ^X2    split current buffer on screen. repeated use creates successively
  143.     smaller screen windows. The same buffer is displayed in both windows,
  144.     but a different buffer may be selected with the ^XB command.
  145.  
  146.    2.3    BUFFER LOAD/SAVE
  147.  
  148. Buffers are loaded form disk or saved to disk with one of the following
  149. commands. All commands operate on the current buffer only!
  150.  
  151. ^X^R    Prompts for a file to be read into the current buffer. You will be
  152.     reminded of unsaved changes before they are overwritten.
  153. ^X^S    Saves the current buffer to its associated filename. No operation if
  154.     the buffer does not have a file name.
  155. ^X^W    prompts for a file name and saves the current buffer under that name.
  156. ^Z    quick getaway. saves buffer under current file name and exits.
  157.    NOTE that ^X^S and ^Z do not perform any disk write if the buffer is
  158.     unchanged!
  159. ^X^C    exit EMACS
  160.    NOTE THAT ^Z and ^X^C will ask for verification if ANY buffer contains
  161.     updated (but unwritten) data!
  162. ^X^V    visit file. reads a file into a buffer by the same name (creates buffer
  163.     if need be) and makes that buffer the current buffer.
  164. ^X^F    names the current buffer's associated file.
  165. ^XK    kill specified buffer
  166.  
  167. 3. SEARCH
  168.    ------
  169.  
  170. You can search for charcters or character sequences with the folloqing commands:
  171.  
  172. ^S    prompts for search string. RETURN delimits string and starts search
  173.     FORWARD. Cursor is only moved if a match is found.
  174. ^R    same as ^S, but searches backwards.
  175.    NOTE    that hitting RETURN as the only character will repeat the previous
  176.     search.
  177.    NOTE that you can search for control-sequences by prefixing with the QUOTE
  178.     character. (see below)
  179.    NOTE that ^R and ^S are NOT case sensitive (ie eMaCs will match EmAcS...)
  180.  
  181.  
  182. 4. SEARCH AND REPLACE
  183.    ------------------
  184.  
  185. Sorry, folks. Not in this version of EMACS, but see below...
  186.  
  187. 5. MISCELLANEOUS
  188.    -------------
  189.  
  190. ^Q    QUOTE character. Causes the NEXT character to be inserted, even if it
  191.     would normally be a command character.
  192.  
  193. EMACS is always in INSERT mode. Any character typed which is not a command
  194. character is inserted at the cursor position. Note that an invalid second
  195. character in a 2-character sequence is IGNORED.
  196.  
  197. ^L    Redisplay the screen, useful is something (??) caused your screen
  198.     display to become jumbled...
  199.  
  200. ^X^B    displays a list of buffers, their associated file names and contents
  201.     in characters. Also splits screen, so if no longer needed, hit ^X1.
  202. ^G    stop command with no execution. also rings the bell.
  203. ^U or
  204. ^Un    (where optional "n" is a positive signed integer) - set repeat factor.
  205.     The repeat factor applies to the following command ONLY. Typing ^U
  206.     repeatedly will increment the repeat factor by 4 (4-16-64-256...).
  207.  
  208. ^X^Z    shrink the current window by 1 line (if more than 1 window)
  209. ^XZ    enlarge current window by 1.
  210.  
  211. ^X=    show current position (row/col, current character in hex, number of
  212.     between sof and point, location in file, percentage wise)
  213.  
  214. 5. ADVANCED STUFF
  215.    --------------
  216.  
  217. ^X!    prompts for a DOS command to be executed while in EMACS
  218. ^C    execues COMMAND.COM while in EMACS to allow many commands to be
  219.     run until EXIT is entered at the DOS prompt
  220.  
  221. EMACS has a very powerful macro definition facility. In this version, only
  222. one macro may be defined as follows:
  223.  
  224. ^X( followed by commands, followed by ^X). This, in effect, constitutes one
  225. execution of the macro.
  226. ^XE    executes the macro (^U times, if specified).
  227.  
  228. This way, you CAN do a global search-replace...
  229.  
  230.  
  231. 6. MORE...
  232.    -------
  233.  
  234. There are some more commands according to COMMANDS.DOC (distributed with
  235. UEMACS/BIGEMACS) but they don't seem to work. Full EMACS has many, many
  236. more commands available, but you also spend many, many more dollars.
  237. You can't beat the price of BIGEMACS and it certainly works. After using
  238. it for a few days I refuse to use anything else... except full EMACS,
  239. maybe.
  240.  
  241. Now who has the source to BIGEMACS for some improvements??????
  242.  
  243. Sigi Kluger, Thousand Oaks CA
  244. For comments, GEmail to S.F.Kluger, or call 1000 Oaks RCPM 805-492-5472
  245.