home *** CD-ROM | disk | FTP | other *** search
/ ftp.swcp.com / ftp.swcp.com.zip / ftp.swcp.com / InternetTCP / newswatcher-readme < prev    next >
Text File  |  2017-03-03  |  5KB  |  113 lines
  1. This directory contains a beta version of NewsWatcher with
  2. experimental modifications to allow it to work over serial (dialup)
  3. lines. This version has not been extensively tested and should be used
  4. at your own risk. This version is designed to work either over dialup
  5. or highspeed (using MacTCP) lines. If you have problems with this
  6. version (even when using it with MacTCP) DO NOT BOTHER John Norstad
  7. with trouble reports. Send all trouble reports to:
  8.    ray@sfu.ca
  9.  
  10. The serial connections are made using the Communications Toolbox and
  11. scripts are used to navigate the connection. This works in the same
  12. way as serial connections for the SFU version of Eudora. This includes
  13. the navigations strings method as documented in Appendix D of the
  14. Eudora documentation and the scripts as documented in the C- manual
  15. (available from ftpserver.sfu.ca in pub/mac/eudora/doc/scripts). 
  16.  
  17. A number of example scripts and navigation strings are available in
  18. this directory. The script in NW-Dialup-Script-1.0.hqx is for use at
  19. SFU and is not likely to be useful at other sites. It may be of use as
  20. an example of writing a fairly complex script.
  21.  
  22. If you are going to use Serial NewsWatcher over a dialup line directly
  23. into a Unix box, then there are two scripts/navigation strings that
  24. may be of use to you. To use either of these, simply put them into the
  25. Preferences folder of you System Folder. The following short
  26. description of these scripts should help you make use of them.
  27.  
  28. NW-Direct-Unix-Navs
  29.  
  30. This file contains a set of navigation strings much like the ones in
  31. appendix D of the Eudora documentation. These navigation strings
  32. should work fine with Eudora as well. They contain two extra
  33. navigation strings that Eudora doesn't use, but are needed by
  34. NewsWatcher to handle moving the .newsrc file.
  35.  
  36. To handle the problem with echoing, these navigation strings use
  37. srialpop to handle the terminal settings. Note that the standard
  38. version of srialpop written for use by Eudora will not let you connect
  39. to the NNTP port or to the Telnet port. In fact it needs a bit of
  40. smarts to talk to a Telnet port. A version that can do that is
  41. available in the srialpop directory.
  42.  
  43. NW-Direct-Unix-Script
  44.  
  45. This is a script that does much the same thing that the navigation
  46. strings mentioned above do. The one major difference is that the
  47. script does not use srialpop. NewsWatcher handles the echoing from the
  48. Unix machine itself. This has the advantage that you don't need
  49. srialpop running on Unix. It has the disadvantage that the echoing
  50. slows things down a bit.
  51.  
  52. Rolling your own
  53.  
  54. The following notes might help in writing the scripts. You should also
  55. be familiar with Appendix D of the Eudora documentation (available
  56. from ftp.qualcomm.com) and the C- documentation (C- is the language
  57. that the scripts are written in if you go that route).
  58.  
  59. The "Navigate In" script is used to get connected to a point where a
  60. telnet command can be issued by NewsWatcher. Note that NewsWatcher may
  61. leave itself in a state where it has not issued a telnet command, so
  62. connecting to a terminal server that will time out in such a
  63. circumstance is not a good idea. Also note that NewsWatcher cannot
  64. handle echos of any kind. The scripting language has a way of handling
  65. echos but the navigations strings do not. If you cannot get the host
  66. to turn off echoing then you will have to
  67. run a program like srialpop after
  68. modifying it to accept telnets to ports 119 and 23, and teaching it to
  69. talk to a telnet port. A version of srialpop that does this is
  70. available in the directory pub/mac/newswatcher/srialpop. 
  71. Finally, you may have to
  72. alter the form of a number of strings that are used by the scripts and
  73. NewsWatcher to do various serial connection things. They are kept in
  74. STR resources and my be changed with ResEdit, or if you are using
  75. scripts, from the Navigate In script with the Save function. For
  76. example:
  77.     Save(1202, "telnet %s %d\r");
  78.         Save(1204, "echo \\\004 | cat %s -");
  79.  
  80. The strings to look at are as follows:
  81.  
  82.    STR    default value                 string use
  83.   -----  ---------------               ------------
  84.    1201   \n                            Line end character
  85.    1202   telnet %s %d\r                Telnet Command 
  86.    1203   cat - > %s                    Put file command
  87.    1204   echo \\\4 | cat %s -          Get file command
  88.    1205   \004                          End of file character
  89.  
  90.  
  91. Note that the form of the telnet command uses "%s" rather than the
  92. Eudora "%p".
  93.  
  94. The "Navigate Mid" script is responsible for getting the connection back
  95. to a state that another telnet command can be issued. Little more is
  96. needed here but a script that will pause for a short while to make
  97. sure that the other end is ready for another telnet command.
  98.  
  99. The "Navigate Out" script is responsible for ending everything. If you
  100. know you are using a modem, this could be an empty script (hanging up
  101. the phone should disconnect you). The example scripts are nicer about
  102. issuing a logout command.
  103.  
  104. Two extra scripts that are not needed by Eudora are needed by
  105. NewsWatcher to connect to the host that contains the .newsrc file.
  106.  
  107. The "Navigate Telnet In" script is used to log into a telnet
  108. connection to the host that contains the .newsrc file. The telnet
  109. command itself will already have been given, so the script must supply
  110. the id and password and whatever else is needed to log in.
  111.  
  112. The "Navigate Telnet Out" script is used to log out of the telnet
  113. connection. This will usually be just a logout command.