home *** CD-ROM | disk | FTP | other *** search
/ Power Programming / powerprogramming1994.iso / progtool / editor / tvx_edit.arc / VIX.REF < prev   
Text File  |  1986-03-17  |  9KB  |  214 lines
  1.                VIX - A vi-like editor based on TVX
  2.  
  3.     Vix is an extension to tvx that provides a close emulation
  4. of the Unix editor vi.  While the majority of the common commands
  5. are identical, there are some inherent differences in the way tvx
  6. and vi treat text.  Most of the commands were implemented directly
  7. using the TVX equivalent, although some commands were required new
  8. code.  If the vi command could not be implemented, its command letter
  9. was left unused, and will produce an error message.
  10.  
  11.     Vix does not have the underlying ex editor, so none of the
  12. escape to ex commands work.  Vix does have the TVX repeat loop,
  13. however, and this compensates to a great extent for the need for ex
  14. features. Please consult the TVX manual for examples of using the
  15. repeat loop.  Note that when using the repeat loop with vix, the commands
  16. will be vix commands and not tvx commands.
  17.  
  18.     Another significant difference is that tvx (and thus vix)
  19. treats the end of line character as just another character.  Thus
  20. cursor movement commands move over the end of line in a fashion one
  21. would expect.  However, when one moves to the end of the line, the
  22. cursor is placed 'over' the newline (displayed after the last real
  23. character in the line).  This makes the '$' command work somewhat
  24. differently. This also means that you can include a <return> in a
  25. search pattern. Vix and tvx use ESCAPE to end the search pattern
  26. instead of <return>.
  27.  
  28.     Vi uses the ':' command to read and write the file (among
  29. other things).  Vix uses the ':' to set operating parameters such
  30. as autoindent, screen size, etc.  The 'ZZ' (or 'ZA' to abort without
  31. changes) command is used by vix to exit.
  32.  
  33.     Unlike vi and ex, tvx and vix try to load the entire file
  34. being edited into memory (called the buffer by tvx/vix, as opposed
  35. to the yank or save buffer).  If the entire file doesn't fit, the
  36. user must manually 'page' the file in and out of memory manually. 
  37. Most of the 'q' ("tvx" prefix) commands are supplied to handle buffer
  38. manipulation.  For more details, consult the TVX manual.  TVX/vix
  39. also uses the concept of the "last thing" as a major editing tool.
  40. Whenever you find a pattern, skip over a word with b or w, save text
  41. into the save buffer with the 'y' or 'Y' commands, or put text from
  42. the save buffer, that text is considered the "last thing". The 'c/'
  43. and 'd/' commands will delete the last thing.  Entering a new command
  44. will forget what the last thing was until you again enter a "last
  45. thing" command.
  46.  
  47.     The available vix commands are summarized below.  The first
  48. column of each entry has a character noting similarities and 
  49. differences with the real vi commands in the following fashion:
  50.  
  51. - means present in vi, not implemented in vix.
  52. = means commands work identically {with possible minor variations}
  53. + means new or significantly different command
  54. * means "equivalent" command, somewhat different than vi
  55. <space> means command unused in both vi and vix.
  56.  
  57.   n in front of command means command takes count argument
  58.   [synonyms indicated in brackets]
  59.  
  60.    ^@: Unused
  61.    ^A: Unused
  62. = n^B: Backward window. {2 lines of continuity not preserved}
  63.    ^C: Unused
  64. = n^D: Down half window.
  65. -  ^E: Not implemented
  66. = n^F: Forward window.
  67. *  ^G: memory status, short info line
  68. = n^H: backspace Command mode: left; Insert mode: del last char
  69. =  ^I: inserts tab in insert mode, not a command.
  70. = n^J: down arrow in column [j,^N]
  71. + n^K: up in column [k,^P]
  72. =  ^L: verify screen [^R,z]
  73. = n^M: down to beginning of line [+]
  74. = n^N: [j, ^J]
  75.    ^O: Unused
  76. = n^P: [k, ^K]
  77. =  ^Q: Unused (flow control)
  78. =  ^R: Redraw screen [^L,z]
  79. =  ^S: Unused (flow control)
  80. +  ^T: TVX prefix command - see q [q,Q,T]
  81. * n^U: Up half window.  ** in insert mode, does NOT erase line **
  82. *  ^V: Not a command.  NOT literal quote in insert mode.
  83. *  ^W: Not a command.  NOT used for delete word in insert.
  84.    ^X: Unused
  85. -  ^Y: Not implemented
  86. -  ^Z: Not implemented
  87. =  Escape: forces command mode, safe follow char for d,c,q.
  88.    ^\: Unused
  89. -  ^]: Not implemented
  90. -  ^^: Not implemented
  91.    ^_: Unused
  92. =  <space>:  [r]
  93. +  n!: Tidy.  Fills n lines up to wrap margin. [see autowrap]
  94. -   ": Not implemented
  95. + n#p: execute repeat loop number 'p' 'n' times
  96. =   $: goto end of current line {end is newline, not last char}
  97. -   %: Not implemented
  98. -   &: Not implemented
  99. -   ': Not implemented
  100. -   (: Not implemented
  101. -   ): Not implemented
  102. +   *: insert last matched pattern into text buffer
  103. =  n+: [CR, ^M]
  104. -   ,: Not implemented
  105. *   -: Used in vix for negative counts, use K for up line.
  106. -   .: Not implemented, repeat loops are a substitute
  107. =   /: search {Escape used to end pattern, multi-line patterns ok}
  108. *   0: 0 is used for counts (especially for : parameters)
  109. = 0-9: count value for numeric arguments {may be negative!}
  110. -   :: Not implemented - use ZZ and ZA to exit
  111. -   ;: Not implemented
  112. +  n<: Begin repeat loop. Loop terminated with >$$. ($ = Esc)
  113. +   =: Help screens
  114. +   >: Used to terminate repeat loops.
  115. =   ?: Reverse search {search begins on previous line}
  116. +  n@: execute current repeat loop n times (shorthand for n#p)
  117. =   A: append to end of line
  118. *  nB: back a word {vix's concept of words is different than vi}
  119. =   C: changes rest of line
  120. =   D: delete rest of the line
  121. -   E: Not implemented
  122. -   F: Not implemented
  123. =  nG: goes to line number n, or end of buffer if no n supplied
  124. *   H: Beginning of buffer (first line in buffer)
  125. =   I: inserts at beginning of line
  126. =   J: join lines {not needed since vix treats newlines as chars}
  127. +  nK: Up a line to beginning of line
  128. *   L: bottom line of file
  129. +  nM: return to marked location n (n from 1 to 9, see m)
  130. =   N: like n, but in reverse direction
  131. =  nO: open a line above current line. n opens n blank lines.
  132. =   P: put save buffer above current line {save buffers not named}
  133. +   T: tvx commands (see q) [^T,q,Q]
  134. *   U: very limited undo!! It only restores the LAST line killed!
  135.     V: Unused
  136. *  nW: Moves forward n words [w] {vix's concept of words not same}
  137. =  nX: delete n characters before cursor
  138. +  nY: append n lines to save buffer (see y), does not change buffer
  139. =+ Zx: exit from vix (ZZ: normal, writes file, ZA: abort, no changes)
  140. -  [[: Not implemented
  141.     \: Unused
  142. -  ]]: Not implemented
  143. =   ^: beginning of line {1st char of line, NOT 1st non-white char}
  144. +   _: invoke indirect command file
  145. =   a: append text starting after cursor
  146. *   b: back up a word [see B]
  147. =   c: change c, <sp>, ^, $, or / (delete, enter insert mode)
  148.     =   c - change line
  149.     =   <sp> - change one character
  150.     =   ^ - to beginning of line
  151.     =   $ - to end of line
  152.     -   w, b, and any others not mentioned not implemented
  153.     +   / - the last thing found, yanked or put
  154. =  nd: delete d, <sp>, ^, $, or /
  155.     =   d - delete line
  156.     =   <sp> - delete character
  157.     =   ^ - to beginning of line
  158.     =   $ - to end of line
  159.     -   w, b, and any others not mentioned not implemented
  160.     +   / - the last thing found, yanked or put
  161. -   e: Not implemented
  162. -   f: Not implemented
  163.     g: Unused
  164. =  nh: Move left n characters [BS,^H] {will move over lines, too}
  165. =  ni: insert (if value n supplied, then that ascii code inserted)
  166. =  nj: down lines, in column [^J,^N]
  167. =  nk: Up lines, in column [^K,^P]
  168. =  nl: right n characters [<space>] {moves over lines, too}
  169. *  nm: mark cur. line as location n.  Use M to return to location.
  170. =   n: find next (in same direction as last ? or /)
  171. =  no: open n following lines
  172. =   p: put save buffer after cur line
  173. +   q: Prefix character for "tvx" extended commands
  174.         !: call operating system
  175.         b: goto real beginning of the file
  176.         e: edit repeat buffer
  177.         j: jump back to last location
  178.         p: put external file from save buffer
  179.         r: restore repeat buffer
  180.         s: print screen
  181.         w: read in next page of file
  182.         y: yank external file to save buffer
  183.         /: cross buffer search
  184.       n:p: set parameter 'p' to value 'n', parameters are:
  185.          a: autoindent (1 means on, 0 off for all "switch" pars)
  186.          c: "cut" mode (means 'dd' saves line in yank buffer, too)
  187.          e: expand tabs to n spaces (8 default)
  188.          d: home display line (where cursor homes after verify)
  189.          f: find case mode (0 is case insensitive, 1 exact match)
  190.          m: match wildcards (1 use ^A, ^L, etc., 0 no wild cards)
  191.          o: requests new name for output file
  192.          s: scroll window, cursor moves s lines before scrolling
  193.          t: tty mode - 1: tty mode, 0: visual mode
  194.          u: requests entry of user wild card set
  195.          v: virtual window size
  196.          w: autowrap limit.
  197. =   r: replace next char with next character entered
  198. =  ns: substitute: delete n characters, enter insert mode
  199. -   t: Not implemented
  200. -   u: Not implemented (see U)
  201.     v: Unused
  202. *  nw: advance word (see W)
  203. =  nx: delete n characters
  204. *  ny: yank text to save buffer - will save n lines into save buffer
  205.        (Only one save buffer, 1st y clears buffer, rest add until
  206.     non y command entered. dd works in a similar fashion, but
  207.     kills as it saves (if cut_mode enabled)).
  208. =   z: refresh screen (^L,^R)
  209. -   {: Not implemented
  210. -   |: Not implemented
  211. =  n~: Change case of next n characters
  212. * nDEL: Same as X, delete previous character
  213.  
  214.