home *** CD-ROM | disk | FTP | other *** search
/ Frozen Fish 1: Amiga / FrozenFish-Apr94.iso / bbs / alib / d6xx / d673 / shelltools.lha / ShellTools / Recorder.doc < prev    next >
Encoding:
Text File  |  1992-06-13  |  1.6 KB  |  61 lines
  1.  
  2. Recorder
  3.  
  4.     Template: TO=ON,PROCESS/K/N,APPEND/S,OFF/S
  5.  
  6.  
  7. The Recorder command is used to capture all the input and output in a particular
  8. shell and save it to a file.
  9.  
  10.  
  11. To use the recorder, merely type its name, ie
  12.  
  13. recorder
  14.  
  15.  
  16. will activate the recorder, sending its output to the default file called
  17. "recorder.output"
  18.  
  19.  
  20. If you wanted to use a different file name, you could have said:
  21.  
  22. recorder ram:work.in.progress
  23.  
  24. And the output would have been send to the file ram:work.in.progress
  25.  
  26.  
  27.  
  28. To stop the recorder, the OFF option is used, ie
  29.  
  30.  
  31. recorder OFF
  32.  
  33. This must be issued in the same shell that invoked the recorder.
  34.  
  35.  
  36. To append new information to an existing file, the APPEND keyword is used, ie
  37.  
  38.  
  39. recorder ram:work.in.progress append
  40.  
  41.  
  42. will add new information to the already existing file.  This command
  43. can be issued after a recorder OFF command;  In this way you can start
  44. and stop the recorder at will.
  45.  
  46. Note:  The recorder process can also be stopped by sending it a break
  47.        signal.  This would be required to properly close the recorder
  48.        output file if you inadvertently close the shell while the
  49.        recorder is running.  In that case, the shelll window would not
  50.        close until you found the recorder process by using the STATUS
  51.        command from another shell, and used the BREAK command to
  52.        send the recorder process a control-C.
  53.  
  54.  
  55. The Process keyword is used internally by recorder.
  56.  
  57. Recorder should not be RUN, as it attaches to the current process, so is
  58. generally not useful in its own short-lived process.
  59.  
  60. Recorder is based on ideas from Phillip Lindsey and David Cervone.
  61.