home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / BDSC / BDSC-2 / TELED12.DOC < prev    next >
Text File  |  2000-06-30  |  7KB  |  171 lines
  1.             Teledit 1.1       3/20/82
  2.         Documentation by Nigel Harrison
  3.  
  4.     [Editor's note: "Teledit" is a cross between the original BDS
  5.      Telnet program, Ward Christensen's MODEM program, its MODEM7
  6.      derivative, a C version called XMODEM, and Nigel's tiny
  7.      screen editor. In fact, this program was used for a while as
  8.      the primary editor on a CDC 110 micro system, until they got
  9.      Mince up. It may not be the LAST modem program you'll ever
  10.      need, but it's gotta have more roots than any other!
  11.                         -leor]
  12.  
  13.  
  14.     Teledit is a communications program for transmitting files and
  15. connecting to other systems or networks as an ASCII terminal.  It has a
  16. simple editor with which one can manipulate lines of text collected
  17. during a session with a remote system.  The file transmission modes 
  18. allow sending/receiving either binary or text files.  The modes selected
  19. from the menu are:
  20.  
  21. T: Terminal mode - no text collection
  22.  
  23. Teledit behaves like an ASCII terminal.  Eight-bit characters are sent
  24. and received; no parity bits are checked, inserted or removed.  To
  25. return to the selection menu the SPECIAL character is typed.  The 
  26. The SPECIAL character of <ctrl>shift uparrow was chosen because it
  27. is unlikely to be struck accidentally.  To change the SPECIAL character,
  28. recompile Teledit with the desired #define SPECIAL ...
  29.  
  30. X: terminal mode with teXt collection
  31.  
  32. Same as terminal mode above, except that any text characters received
  33. on the communication link are saved in a text buffer.  The tab, newline
  34. and formfeed characters are also placed into the buffer; any other
  35. characters are discarded.  While in terminal mode, the editor is
  36. entered by holding down the control key while typing the letter
  37. "E" (control-E).  X mode prompts the user for a filename to be used
  38. for the gathered text.  After 500 lines of text have been collected
  39. and saved in the text buffer, each additional line collected causes
  40. the console bell (alarm) to sound.  When this happens the user should
  41. find a convenient time to suspend communication with the remote
  42. station so that the accumulated text can be saved (flushed) onto
  43. disk as described below.
  44.  
  45. G: toGgle echo mode (currently set to echo)
  46.  
  47. Should not be toggled if the user is communicating in full duplex
  48. mode and receiving an echo from the remote station, or the user is
  49. in half duplex mode. Use this option to talk to another person running
  50. Teledit, typically in between file transfers to inform the person of the
  51. next file to be transmitted.
  52.  
  53. E: Edit text collected
  54.  
  55. Enters the editor from the menu display.  This will not work until
  56. X: terminal mode with teXt collection has been entered and a text
  57. collection file opened.  Editor commands are described below.
  58.  
  59. F: Flush text collection buffer to text collection file
  60.  
  61. Flushes the text collection buffer accumulated in text collection
  62. mode. Does not close the file.
  63.  
  64. U: select cp/m User area
  65.  
  66. For users who have user areas, others should ignore this command.
  67.  
  68. V: select cp/m driVe
  69.  
  70. Select any of the disk drives available.  The drive selected becomes
  71. the currently logged disk.
  72.  
  73. D: print Directory for current drive and user area
  74.  
  75. S: Send a file, MODEM protocol
  76.  
  77. Prompts for the name of the file to send, then waits for the receiver
  78. (who must be using this program or one which uses the same protocol)   
  79. to "synch up".
  80.  
  81. Returns to menu after completion, successful or not.
  82.  
  83. R: Receive a file, MODEM protocol
  84.  
  85. Prompts for the name of the file to be received, then waits for the
  86. sender to begin transmission.  The sender must be using Teledit or
  87. a program that employs the same MODEM protocol.       
  88.  
  89. Q: Quit
  90.  
  91. Quits.  If a text file has been accumulated in X mode, the user
  92. is asked whether or not he/she wants it saved.
  93.  
  94. SPECIAL: sends SPECIAL character to the communication line,
  95. should that ever be necessary.
  96.  
  97.  
  98.             Editor
  99.  
  100. The editor prompts with "*" when entered.  The current line usually
  101. appears directly below the prompt.  The editor commands are:
  102.  
  103. A: Append (Yank in) a file and insert it before the current line.
  104.  
  105. B: go to the Beginning of the file and display a page. The current line
  106.    becomes the first line of the text file.
  107.  
  108. F: Find line that contains the pattern following the "F". If found, it       
  109.    becomes the current line.  Search starts forward and wraps around.
  110.  
  111. I: enters Insert mode.  To leave insert mode, <ctrl>Z is struck, followed
  112.    by <cr>.  The escape insert mode sequence should only be entered at
  113.    the beginning of a line; lines having an embedded ^Z are lost.
  114.  
  115. K: Kill the current line
  116.  
  117. nK Kill n lines.
  118.  
  119. L: Find line that begins with the pattern following the "L".
  120.  
  121. O: Overwrite lines of text until <ctrl>Z is struck.  <ctrl>Z should
  122.    be struck only at the beginning of a new line.
  123.  
  124. P: Page forward in text.  -P pages backward.
  125.  
  126. Q: Quit editor.
  127.  
  128. Sn<cr>  Sets screen size to n lines.  The default is 22 for 24-line
  129.     displays.  S23 should be used for 25-line consoles, and S28
  130.     for the Control Data 110.
  131.  
  132. Z: Go to Zee end of the file.  Convenient, for example, to go to the end
  133.    then -P to view last page.
  134.  
  135. n<cr>  Move forward in the file by n line(s).
  136.  
  137. <cr>   Move forward in the file by one line.
  138.  
  139. -n<cr> Move backward in the file by n line(s).
  140.  
  141. Space Bar  Move backward in the file by one line.
  142.  
  143. #      print number of text lines in file.
  144.  
  145.  
  146.  
  147.             Installation
  148.  
  149. Teledit must be compiled in BDS C with the following constants special
  150. to the installer's particular environment.
  151.  
  152. #define HC "s*"     /* where s is the string necessary to home the cursor
  153.                on the user's console screen */
  154.  
  155. #define CLEARS "s"    /* where s is the string necessary to clear the screen
  156.                        on the user's console    */
  157.  
  158. CLEARS should already be properly defined in "bdscio.h".  In addition to the
  159. above defines (which must be present during compilation for Teledit to work)
  160. it is IMPORTANT to have storage allocation enabled in both the header file
  161. and in deff.crl.  See the BDS C compiler manual if this has not already been
  162. done.  In addition to CLEARS, the bdscio.h constants MDATA, MSTAT, MOMASK,
  163. MIMASK and MAHI must be correctly set.  See the bdscio.h header file for
  164. information on how to do that.
  165.  
  166. Any of the editor commands not needed can be removed by removing the corresp-
  167. onding case statement from the editor function in the source code, then
  168. recompiling Teledit.  Good luck!
  169.  
  170. << END TELEDIT.DOC>>
  171.