home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Interactive Guide / c-cplusplus-interactive-guide.iso / c_ref / csource3 / 179_01 / tvx_refb.doc < prev    next >
Text File  |  1986-01-28  |  34KB  |  1,125 lines
  1.  
  2.  
  3. TVX Reference Manual                                          11/27/85
  4.  
  5.  
  6. the mistake, all the edit commands before the last '^B' as well as the
  7. '^B' should be removed from the log file before  applying  it  to  the
  8. previous  version  since '^B' created a backup copy of the file.  This
  9. means that all the editing  commands  entered  before  the  '^B'  will
  10. already  be  saved,  and thus should not be restored.  Failure to take
  11. this into account will result in a randomly edited file!!! 
  12.  
  13.      The other case involves the '^Y' yank external file command.  The
  14. external file read as a part of the '^Y' command  is  read  using  the
  15. same I/O channel as the backup log file input, and thus both cannot be
  16. used  at  the  same  time.   If  the backup log file contains any '^Y'
  17. commands (displayed in the log file as '@Y'), you  must  remove  them.
  18. Obviously,  this will alter the order of the commands in the file, and
  19. you will need to use a special procedure.  Suppose, for example,  that
  20. the  backup  log  file contained one '^Y' command.  Make two copies of
  21. the backup  log  file.   Edit  the  first,  and  remove  all  commands
  22. following the '^Y' command, including the '^Y' command.  Then edit the
  23. other  copy,  and  remove  all commands before the '^Y', including the
  24. '^Y'.  Then, edit the backup copy of the original file.  First,  apply
  25. the  first  backup  log  file.   This  will get you to the point right
  26. before the '^Y'.  Then without changing the cursor position,  manually
  27. enter  the '^Y' command and file name.  Finally, apply the second copy
  28. of the backup log file. 
  29.  
  30.      It is also possible to write log command files  of  your  own  to
  31. carry  out  specific  commands.   This allows the creation of "macros"
  32. that can be executed as needed.  When creating log files of your  own,
  33. you should remember that control characters and backspaces must appear
  34. as  encoded  characters.   The '@' is the encoding character.  Control
  35. characters will appear as '@' followed by the appropriate letter: '^I'
  36. = '@I', enter = '@M', etc.  An '@' itself is '@@',  and  backspace  is
  37. '@H',  although  you  should  never need a backspace in your own files
  38. (use -K). 
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.                                  -18-                                 
  65.  
  66.  
  67.  
  68.  
  69. TVX Reference Manual                                          11/27/85
  70.  
  71.  
  72.                   *** USER CUSTOMIZATION of TVX ***
  73.  
  74.      A program called TVCONFIG is also provided with most versions  of
  75. TVX.   It  allows you to customize TVX to a great extent.  The program
  76. generates a file called  CONFIG.TVX.   When  TVX  is  started  with  a
  77. command  line  of  the  form: 'TVX filename -c=config.tvx", the values
  78. defined in CONFIG.TVX will be used instead of the defaults.  (Warning:
  79. TVCONFIG is may not be implemented for all systems.  Specifically, the
  80. default Unix distribution does not provide TVCONFIG capabilities.)
  81.  
  82.      TVCONFIG is mostly self explanatory.  It allows you to change the
  83. following:
  84.  
  85. 1. Commands.  All of the approximately 50 commands can  be  redefined.
  86. There are some restrictions: all commands must be a single letter, and
  87. case  is  ignored.   The  '@',  ESCAPE,  and  '<>'  commands cannot be
  88. changed.  Commands cannot be a number, including a '-'. 
  89.  
  90. 2. Synonyms.  You may define some synonyms, such as space  for  right,
  91. or   RETURN   for  down.   You  cannot  duplicate  previously  defined
  92. commands. 
  93.  
  94. 3. Function Keys.  Up to  50  function  keys  may  be  defined  to  be
  95. equivalent  to  any command (in fact any letter or character).  When a
  96. function key is pressed, TVX will translate it to  the  character  you
  97. specify.   If  your function keys use an ESCAPE as a prefix character,
  98. you will have to redefine a function key to be ESCAPE! 
  99.  
  100. 4. Parameters.  You  may  change  the  default  for  any  of  the  ':'
  101. parameters. 
  102.  
  103.      After you  have  built  a suitable working version of CONFIG.TVX,
  104. another program called TVPATCH has been provided (for  MS-DOS  systems
  105. only) to allow TVX.EXE (or TVX.COM) to be permanently patched with the
  106. options  set by TVCONFIG.  This means you won't have keep track of the
  107. CONFIG.TVX file any more, and won't need the '-c' switch. 
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.                                  -19-                                 
  131.  
  132.  
  133.  
  134.  
  135. TVX Reference Manual                                          11/27/85
  136.  
  137.  
  138.                         *** Error Messages ***
  139.  
  140. *** Abort, are you sure? 
  141.      This message is displayed after  the  "abort"  command  has  been
  142. entered.  A reply of y or Y will cause the session to be terminated. 
  143.  
  144. *** Bad O= switch
  145.      An incorrect format was specified for the O= switch. 
  146.  
  147. *** Bad @ name
  148.      An invalid file name was specified.  Re-enter. 
  149.  
  150. *** Bad command: x
  151.      The command is not a valid TVX command. 
  152.  
  153. *** Bad file name
  154.      An invalid file name was specified.  Re-enter. 
  155.  
  156. *** Bad output file: filename
  157.      An invalid output file was specified. 
  158.  
  159. *** Bad par (val | name)
  160.      An invalid value or parameter name was specified. 
  161.  
  162. *** Bad switch
  163.      An invalid   switch   was  specified.   Re-enter  file  name  and
  164. switches. 
  165.  
  166. *** buffer empty
  167.      Information message.   Displayed  after  a  new  file  has   been
  168. created,  or  when  the  write buffer command is executed and the text
  169. buffer is empty. 
  170.  
  171. *** Can't create new name
  172.      TVX was unable to create a new name for the  output  file.   Free
  173. some disk space, rename the file, try again. 
  174.  
  175. *** Can't insert that
  176.      There are three values that TVX uses internally, and thus are not
  177. valid as user inserted characters in the text buffer. 
  178.  
  179. *** Compacting buffer
  180.      Information message.    Displayed  when  TVX  is  compacting  the
  181. buffer.  The compaction process may take several seconds. 
  182.  
  183. *** Compacting done
  184.      Information.  The compaction is complete. 
  185.  
  186. *** Compactor lost: quit now! 
  187.      An internal error has been discovered.  Exit TVX immediately, and
  188. preserve the backup copy.  Try the session again. 
  189.  
  190. *** Create?  (y/n)
  191.      The file name specified does not exist.  A y  answer  will  cause
  192. the  file  to  be  created.  A n answer will allow the file name to be
  193. respecified. 
  194.  
  195.  
  196.                                  -20-                                 
  197.  
  198.  
  199.  
  200.  
  201. TVX Reference Manual                                          11/27/85
  202.  
  203.  
  204. *** Error reopening
  205.      Something has gone  wrong  with  the  'File  beginning'  command.
  206. Exit,  and try editing the file again.  Be careful since an empty file
  207. may have been created. 
  208.  
  209. *** File only part read
  210.      There was not enough room in the save buffer to hold  the  entire
  211. external  file specified in the 'merge' command.  Try re-editing using
  212. the 's' big buffer switch. 
  213.  
  214. *** lines filled
  215.      TVX has run out of room  to  add  more  lines.   Use  the  'write
  216. buffer' or 'file beginning' command to get more space for new lines. 
  217.  
  218. *** no get room
  219.      There is  not  enough  room  in the text buffer to insert all the
  220. text in the save buffer.  Use  the  'file  begin'  or  'write  buffer'
  221. commands, and try again.  The '-^W' command is often useful. 
  222.  
  223. *** no more lines for insert
  224.      See "lines filled". 
  225.  
  226. *** no nesting
  227.      TVX does not allow nested repeat loops: "<<..>>". 
  228.  
  229. *** no save room
  230.      There is  not  enough room left to save any more text in the save
  231. buffer.  Try saving smaller blocks, or use the 'file begin' command to
  232. get more space. 
  233.  
  234. *** No!  buffer empty
  235.      Many TVX commands are not allowed on an empty buffer.  Sometimes,
  236. just inserting a blank line will  allow  the  desired  command  to  be
  237. used. 
  238.  
  239. *** No: read only
  240.      'File beginning'  command  invalid  when the 'r' read only switch
  241. was used. 
  242.  
  243. *** not found
  244.      The current find pattern was not found. 
  245.  
  246. *** Not last line! 
  247.      TVX will allow you to save the last line of the file only once. 
  248.  
  249. *** reading file... 
  250.      Displayed while TVX is reading in the file. 
  251.  
  252. *** rename fai