home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c / comlink / Manual / Version_Nb / Update < prev    next >
Text File  |  1993-03-03  |  15KB  |  359 lines
  1. ComLink Instructions Update
  2. ---------------------------
  3.  
  4. The manual has been updated but if you have been using an older version of
  5. ComLink you may need to make small changes to the scripts. So read the
  6. relevant update information in this file!
  7.  
  8. Changes from version 1.00 to 1.15
  9. ---------------------------------
  10.  
  11. ComLink has been changed so it will work in the TNC transparent mode, this
  12. helps prevent the program from being upset if someone connects to you.
  13. Escaping from the transparent mode can be achieved in two ways: by sending
  14. three control codes, or, by sending a "break". The latter method is the most
  15. reliable therefore a new command has been added called BREAK:, this is
  16. described later in this document.
  17.  
  18. The READ: command originally performed two functions, scanning an incoming
  19. list and then reading it. These functions now have separate commands, these
  20. are SCANLIST: and READ:. These commands would normally follow each other
  21. with a WAITFOR: command in between looking for a prompt. Splitting the
  22. read command like this allows a list only to disc to be performed.
  23.  
  24. The search strings for the list are now specified after the SCANLIST:
  25. command and NOT after the READ: command. Comments may now be placed after
  26. the READ: command if desired and will be ignored.
  27.  
  28. Problems were experienced with version 1.00 when attempts were made to
  29. read messages from a PMS, this was because the program looked for a blank
  30. line as the signal that a list had ended. Unfortunately when reading a list
  31. from a PMS a blank line is not produced at the end, instead we need to look
  32. for something else eg. Bytes free. To cater for this situation yet another
  33. command has been added called ENDLIST:, to tell ComLink what to look for as
  34. the end of list charecter sequence.
  35.  
  36. AUTOLF need no longer be set to ON, and can be ON or OFF, since the command
  37. is not effective in the transparent mode. ComLink has therefore been changed
  38. to accept a "carraige return" as the end of line character.
  39.  
  40. The state of CONOK is no longer relevant and may be left ON.
  41.  
  42. The instructions accompanying the program have been updated.
  43.  
  44.  
  45. Changes since Version 1.08 up to version 1.11
  46. ---------------------------------------------
  47.  
  48. Double clicking on a script file will now load ComLink and the script will
  49. then be run. Presently a new copy of ComLink is loaded each time a script
  50. is double clicked, future versions of ComLink will perform a check to see
  51. if ComLink is already running.
  52.  
  53. Future versions of ComLink will also allow the upload and download file paths
  54. to be specified in the script.
  55.  
  56. Script dragging and dropping on the ComLink icon is still allowed.
  57.  
  58. The MONITOR: command has now been implemented, it should be used for
  59. script debug only, as it does slow down ComLink slightly.
  60.  
  61. Changes from version 1.11 to 1.12
  62. ---------------------------------
  63.  
  64. Two new commands have been added, these are DIRUP: and DIRDOWN:, they allow
  65. the upload and download directories to be specified. If these commands are
  66. not used then the upload/download directories will be "For_Upload" or
  67. "Download" respectfully within the ComLink application.
  68.  
  69. Update up to version 1.13
  70. -------------------------
  71.  
  72. A new command has been added to allow a "Message numbers" file to be scanned
  73. for numbers to be read. The command causes the file to be examined, if the
  74. 6 th charecter of any line is a "*", then the five characters before it
  75. are assumed to be a message number. This will be read later if the READ:
  76. command is used. The command is FILESCAN: and must be followed by a SCANLIST:
  77. command.
  78.  
  79. Update to version 1.15
  80. ----------------------
  81.  
  82. A command OSCLI: has been added to allow command line commands to be
  83. executed within the script.
  84.  
  85. Update to version 1.16
  86. ----------------------
  87.  
  88. A command APPEND:<text> has been added, the <text> will be sent at the end
  89. of each upload file. The upload file must NOT contain the end of message
  90. code, eg /ex or CTRL/Z, these MUST be put at the end of the APPEND:
  91. command.
  92.  
  93. Update to version 1.17
  94. ----------------------
  95.  
  96. A command KILL:<text> has been added, messages in a list can be marked with
  97. a "-" and a FILESCAN: performed. The method of marking messages is the same
  98. as in the FILESCAN: command. If a KILL: command is used later, then the
  99. marked messages will be deleted. The <text> must be the BBS or PMS kill
  100. command, for a PMS it is usually "Kill" but for a BBS "K".
  101.  
  102. Update to version 1.19
  103. ----------------------
  104.  
  105. Modifications have been performed to raise character output/input rate
  106. significantly. This reduces the time grabbed from the desktop by the
  107. ComLink application.
  108.  
  109. Double clicking on a script will load ComLink if not already loaded, but
  110. will not run the script. (I haven't been able to get the parameter passing
  111. working yet!) Once ComLink is loaded, double clicking the script will run
  112. it.
  113.  
  114. Update to version 1.26
  115. ----------------------
  116.  
  117. Added the DAYTIME: command to set the TNC clock and the FLUSH: command to
  118. keep the serial input buffer flushed.
  119.  
  120. The number of lines allowed in a script has been increased from 100 to 150.
  121.  
  122. Setting the upload and download directories.
  123. -------------------------------------------
  124.  
  125. !ComMail provides an easy way of setting your upload and download path.
  126.  
  127. A !ComMail directory has been added which allows the path of upload and
  128. download to be set easily. Simply put the !ComMail directory where you like
  129. on floppy, in RAM drive etc. Double click on the !ComMail directory to be
  130. used for upload and download. A system variable ComMail$Dir will be set to
  131. point to the selected directory. This can be used in your scripts, eg :-
  132.  
  133. DIRDOWN:{ComMail$Dir}.From_BBS
  134. DIRUP:{ComMail$Dir}.To_BBS
  135. OSCLI:Filer_OpenDir {ComMail$Dir}.From_BBS
  136.  
  137. !Convert has been changed slightly, it will now not only change text files
  138. to scripts but also scripts back to text files.
  139.  
  140. Update to version 1.30
  141. ----------------------
  142.  
  143. Wildcards "#" are now allowed in the MYPROMPT: command.
  144.  
  145. Conditional loop commands LOOPIF: and UNTIL: have been added.
  146.  
  147. MYPROMPT: can have an optional prompt length in the command.
  148.  
  149. TYPE: text can contain system variables in {} brackets.
  150.       eg TYPE:L {OldList$Num}
  151.  
  152. FILESCAN: extracts the first found message number from the file and
  153.           puts it in a system variable {OldList$Num}.
  154.  
  155. ***IMPORTANT***
  156. READ: now has a parameter, a string which is optional and defines the
  157. message start character sequence. (So get rid of any comment you may have
  158. after the read command!!!)
  159.  
  160. Update to version 1.33
  161. ----------------------
  162.     ********************  IMPORTANT   ***********************
  163.  
  164.                 The ENDLIST command has been scrubbed.
  165.  
  166. The ENDLIST: command must be deleted from old scripts along with any
  167. WAITFOR: command after a SCANLIST: since the SCANLIST: command now finishes
  168. having seen a prompt.
  169.  
  170.     *********************************************************
  171.  
  172. Update to version 1.40
  173. ----------------------
  174.  
  175. A terminal program has been incorporated into !ComLink.
  176.  
  177. Update to version 3.02
  178. ----------------------
  179.  
  180. More features have been added to the terminal program!
  181.  
  182. Update to version 3.50
  183. ----------------------
  184.  
  185. More features have been added to the terminal program, in particular the
  186. suspension of incoming text when Ctrl+Shift is pressed and the user defined
  187. colour option in the terminal window.
  188.  
  189. Update to version 3.66
  190. ----------------------
  191.  
  192. 1. "Send with" or "Send without" fn key buttons for file uploads initiated
  193. by dragging.
  194.  
  195. 2. Downloaded messages from the BBS are now put in DIRECTORIES of the same
  196. name as the search string. The messages are then put in these directories
  197. with a reversed date as the filename. Subsequent connections to the BBS on
  198. the SAME day, will result in new messages being appended to the end of that
  199. days file, a new file is created every day ComLink is used and mail etc can
  200. be sorted at your leisure without being overwritten.
  201.  
  202. NOTE THIS CHANGE MEANS THAT EXISTING FILES IN YOUR DOWNLOAD DIRECTORY
  203. WHICH HAVE THE SAME NAME AS ONE OF YOUR SEARCH STRINGS MUST BE DELETED.
  204. OTHERWISE COMLINK WILL NOT BE ABLE TO CREATE THE APPROPRIATE DIRECTORY.
  205.  
  206. 3. The foreground and background colours for the terminal window can be user
  207. defined and saved.
  208.  
  209. 4. For those of you who have found the bug in !DeskEdit