home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / utilities / c / comlink / Manual / Version_Nb / Update < prev    next >
Encoding:
Text File  |  1993-03-03  |  14.3 KB  |  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 where multiple
  210. copies are loaded with obscure error messages if an open file is double
  211. clicked: I have made ComLink change the filetype of all text files it opens.
  212. The file icon then looks like a text icon but it has a red pen instead of a
  213. blue one. This has a handy repercussion, as it is possible to see which
  214. files are open! Double clicks on an open file are then ignored.
  215.  
  216.  
  217. Update to version 4.20
  218. ----------------------
  219.  
  220.  
  221.      * New on screen "Wimpkey" window, incorporating on screen function
  222.        keys, these allow scripts to be run or short commands sent to the
  223.        TNC. Up to 9 sets of 8 Wimpkeys may be set up!
  224.        
  225.      * New CHAIN: command, allows scripts to run other scripts.
  226.  
  227.      * New MORE: command, generates automatic "Y" to requests for "More Y/N"
  228.        from a BBS during a SCANLIST:
  229.          
  230.      * The REPORT: command now has an "OFF" option to allow the status
  231.        window to be closed from a script.
  232.        
  233.      * New WKEY: command allows the "Wimpkeys" to be programmed from
  234.        scripts.
  235.  
  236.      * During a FILESCAN:, the system variable OldList$Num will be set to
  237.        the largest listed number found, and not the first found.
  238.  
  239.      * "Scroll Lock key will stop the scrolling in the terminal window
  240.      
  241.      * Control codes above ASCII 127 are filtered from the terminal window.
  242.  
  243.  
  244. Update to version 4.45
  245. ----------------------
  246.  
  247. 1. ARM code is used for character input/filtering/spooling screen scrolling.
  248.    To get the best from this you need to run the TNC-ARC link at 9600 baud.
  249.    RISCOS 3 still has an interrupt latency problem so characters can get
  250.    lost at higher baud rates.
  251.  
  252. 2. When first run !ComLink loads the WimpKey definitions from the WimpKeys
  253.    directory within !ComLink. It will look for files with names in the range
  254.    1 to 8. The script file "0" will be run when !ComLink is installed on the
  255.    icon bar.
  256.  
  257. 3. The WimpKey 'definitions' are stored in program memory for quick access
  258.    to each set without hard disc access being required.
  259.  
  260. 4. Each yellow WimpKey can now:-
  261.      - Send up to 128 characters to the TNC (stored in memory)
  262.      - Run a script
  263.      - Send a file to the TNC
  264.    If the file path for the script or file is not specified, then it is
  265.    assumed to be in the WimpKeys directory. The files and scripts are
  266.    accessed on hard disc.
  267.  
  268.    Control codes and system variables can be included in the text
  269.    definitions of the wimpkeys.
  270.  
  271.  
  272. 5. Clicking 'menu' over the WimpKey panel pops up the wimpkey edit panel.
  273.    The key 'type' can be changed from 'None' to 'File' to 'Script' to
  274.    'Text'. The label can be different from the text/file name definition.
  275.  
  276.    Controls in the edit window are:-
  277.  
  278.    The 'Yellow keys' button swops to the 'White keys' as desired to allow
  279.    these to be viewed/altered.
  280.  
  281.    The 'Use' button makes !ComLink use any changes you have made, without
  282.    saving the new definitions to disc.
  283.  
  284.    The 'Save' button..... saves the new definitions to disc and also makes
  285.    !ComLink use the new definitions.
  286.  
  287.    The 'Clear' button clears the definitions on view, without the results
  288.    taking effect, the old definitions can be recovered using the 'Restore'
  289.    button. After a 'Save' or 'Use' the old definitions can not be restored!
  290.  
  291.    If you type in a label for a 'File'/'Script'/'Text' type key but not the
  292.    definition and then press 'Use' and 'Restore', then the definition field
  293.    will be filled in for you using the label as the file name/text.
  294.  
  295.    Text strings must end in [13] to be sent. Just pressing any control
  296.    sequence eg 'Ctrl+C' or 'Return' will enter the code in the definition.
  297.  
  298.    Clicking Select on the "WimpKey Set" icon increments the set number,
  299.    clicking 'Adjust' decrements it.
  300.  
  301. 6. The WKEY: script command has changed from previous versions of !ComLink
  302.    however the old form of the command will still be correctly interpretted.
  303.  
  304. 7. There is a scroll back facility in the tx area of the terminal window.
  305.    Use the cursor up/down keys. The scroll back is 50 lines, after 50 it
  306.    wraps back around to the start again, ie its a circular buffer. The 'Page
  307.    Up' and 'Page Down' keyboard keys also move back/forwards through the tx
  308.    buffer. The facility is dead handy  in a 'live' QSO to look back through
  309.    the sent text and also when a link is lost to send again the last few
  310.    lines. Use "Shift + Return" to send old lines, this will prevent the
  311.    next line 'below' the tx window from being cleared when the tx window
  312.    scrolls up if the caret is on the bottom line.
  313.  
  314. 8. A 'word grab' facility has been added to put a word/callsign/number into
  315.    the selected (green) wimpkey. Simply click the mouse 'select' button
  316.    on the word. This allows callsigns to be grabbed for a connect or message
  317.    numbers to be grabbed to read/killed etc.
  318.  
  319. 9. A 'line grab' facility has been added to allow lines from the rx window
  320.    to be put into the bottom line of the tx window. To use this facility,
  321.    double click on the line in the rx window. The line can then be eddited
  322.    and sent.
  323.  
  324. 10 The number of lines in the rx window is configurable, the minimum is 100
  325.    lines. The maximum is only limited by your memory!!! (I've had an 18,000
  326.    line window!!). !ComLink cleverly optimises the use of memory allocated
  327.    by the task manager. (160K total application size gives approx 500 lines)
  328.  
  329. 11 Built in !Help application, can be installed on the bar and gives a
  330.    summary of !ComLinks facilities. This is useful until you become familiar
  331.    with !ComLink.
  332.  
  333. Update to version 4.46
  334. ----------------------
  335.  
  336. Minor bug fixes only.
  337.  
  338.  
  339. Update to version 4.51
  340. ----------------------
  341.  
  342. 1. The mouse action for the 'word grab' facility has been altered, you must
  343.    now DOUBLE CLICK the mouse 'select' button on the word.
  344.  
  345. 2. The mouse action for the 'line grab' facility has been altered, you must
  346.    now 'PRESS AND HOLD' the mouse select button on the line in the rx
  347.    window. The line will appear in the tx window after a short delay, this
  348.    can then be eddited and sent.
  349.  
  350. 3. An IGNORE: script command has been added, this can be used to prevent
  351.    reading back the messages you have uploaded. Alternatively it can be used
  352.    so message to/from certain callsigns are ignored. See the script manuals
  353.    for more information.
  354.  
  355. 4. Message marking has been changed slightly, now the +/- mark for messages
  356.    to be read does not have to be placed at the 6th character location, it
  357.    can be placed after the message number anywhere from the 1st to 8th
  358.    character location.
  359.