home *** CD-ROM | disk | FTP | other *** search
/ ProfitPress Mega CDROM2 …eeware (MSDOS)(1992)(Eng) / ProfitPress-MegaCDROM2.B6I / MISC / NETWORK / TRUMP103.ZIP / NEWS.DOC next >
Encoding:
Text File  |  1991-11-13  |  10.0 KB  |  292 lines
  1.                       Trumpet Version 1.03
  2.  
  3.                 A News Reader for MS-DOS machines.
  4.  
  5.                      Written by Peter R. Tattam
  6.  
  7.                       Copyright (c) Sep, 1991
  8.  
  9.  
  10. ************************** IMPORTANT ***********************************
  11. YOU MUST SET UP YOUR NEWS READER NEWS.PRM FILE BEFORE EXECUTING NEWS.EXE
  12. ************************************************************************
  13.  
  14. The following document describes the setup of the news reader.
  15.  
  16. The files required are :
  17.  
  18.     NEWS.EXE  - the executable file.
  19.     NEWS.PRM  - a setup file for the news reader.
  20.     NEWS.INI  - a list of the newsgroups subscribed to.
  21.  
  22. NEWS recognizes the existence of a novell network, and will
  23. act appropriately. Individual users will save their own NEWS.PRM and
  24. NEWS.INI in their mail directory.  This directory is SYS:MAIL\nnnn where
  25. nnnn is their unique user-id number.
  26.  
  27. The relevant information for setting up is in NEWS.PRM
  28.  
  29. An typical stand-alone setup follows.
  30.  
  31.     myip        = 131.217.35.100
  32.     user        = peter
  33.     netmask     = 255.255.0.0
  34.     mygateway   = 131.217.250.1
  35.     nntp-host   = 131.217.1.19
  36.     smtp-host   = 131.217.1.19
  37.     site        = psychnet.psychol.utas.edu.au
  38.     organization= Psychology Department, University of Tasmania
  39.     mss         = 512
  40.     fullname    = Peter R. Tattam
  41.     signame     = c:\news\my.sig
  42.  
  43. Parameters may be in any order.
  44.  
  45. The individual parameters are :
  46.   myip         - an ip address if 0.0.0.0, an RARP is performed.
  47.   netmask      - your ip local network mask
  48.   mygateway    - ip address of your gateway outside your local net
  49.   nntp-host    - ip address of the NNTP server.
  50.   smtp-host    - ip address of the SMTP server
  51.   mss          - maximum segment size that tcp can send. default 512
  52.  
  53.   site         - your e-mail site name
  54.   user         - your e-mail user name
  55.   organization - the name of your organization
  56.   fullname     - your full name
  57.   signame      - your signature file name
  58.  
  59.  
  60. Executing News
  61. --------------
  62.  
  63. NEWS takes the following parameters.
  64.  
  65.     news [ myip ] [ nntp-host ]  [-d]
  66.  
  67. The parameters 'myip' and 'nntp-host' can be overridden in this manner.  The
  68. option '-d' enables debugging.  This is only used for debugging the TCP/IP part
  69. of the program.
  70.  
  71. Novell users will have some parameters stored in their user parameter file.
  72. The only parameters saved (via Setup menu option) are 'fullname' and 'signame'.
  73. When running from a network, some parameters may change from machine to machine.
  74. One such parameter is the ip address 'myip'. One can use RARP to determine the
  75. IP address of a workstation.  A way of overriding the IP address is to provide
  76. this address as the first parameter when calling the program.
  77.  
  78. Using News
  79. ----------
  80.  
  81. When using NEWS, if all goes well, you should be connected to the NNTP server
  82. and then you will be able to read the news. You will be presented with a large
  83. window with 2 scrolling frames. The top frame is for locating a newsgroup, the
  84. bottom for scanning through a group.  A groups articles will not be displayed
  85. until the newsgroup is selected with <enter>. To jump between the frames, type
  86. <tab>. To move about, use the cursor keys.  You may also locate a group or
  87. subject by typing a sequence of characters which form part of the group name or
  88. article subject.  For example the sequence 'n','o','v','e' will located the
  89. group 'comp.sys.novell'.  This make it easy to locate a group or subject without
  90. typing too much.
  91.  
  92. Note: if NEWS.INI does not exist, trumpet will attempt to subscribe to all the
  93. newsgroups available.  This could take some time, and make you think that the
  94. computer has gone dead.  A ticker should count over showing you that trumpet
  95. is loading all the newsgroup info.  The same thing happens when you select the
  96. subscribe box.
  97.  
  98. To read an article, merely select the article in the lower window by pressing
  99. <enter>.
  100.  
  101. All in all, the program is probably "self-explanatory".
  102.  
  103. Some special commands.
  104.  
  105. In the news article window
  106.  
  107. F7/F8     - will jump to the prev/next group with articles to be read.
  108. [R]eadall  - will mark all the articles as having been read for the current
  109.             group and then scan to the next group with articles in it.
  110. [U]nread   - Unread 20 articles at a time
  111. [T]oggle   - will toggle the read status of an article.
  112. [S]kip     - will mark the article as having been read without reading it.
  113. [F]ollow   - do a follow up to the article
  114. [P]ost     - post a new article
  115. f[O]rward  - forward article to mail user (defaults to self)
  116.  
  117. In the news group window
  118.  
  119. Ins       - open a window of all the unsubscribed groups
  120.             (when open, <enter> will subscribe the newsgroup)
  121. Del       - unsubscibe from a news groups
  122. [Z]ap      - Unsubscribe from all news groups
  123.  
  124. In the article reader window
  125.  
  126. [H]eader   - toggle viewing of the header
  127. [W]ordwrap - toggle word wrapping
  128. [P]rint    - print an article (Can also save to a file this way)
  129. [S]ave     - save article to a file (if files exists, then it is appended)
  130. [M]ail     - mail a letter to author of the article.
  131. [R]eply    - mail a reply to the author of the article. (includes article)
  132. f[O]rward  - forward article to mail user (defaults to self)
  133.  
  134. The use of a mouse is supported via the standard mouse driver.  Load your
  135. mouse driver before use.
  136.  
  137. Notes for Novell Users  (non-supervisor)
  138. ----------------------------------------
  139. The suggested way to run trumpet is as follows.  The trumpet news.exe program
  140. should reside in a public directory.  e.g. SYS:PUBLIC or SYS:TRUMPET
  141.  
  142. Trumpet will only require the file NEWS.PRM in the public directory.  This file
  143. should contain all the trumpet parameters except for the username, fullname and
  144. .sig file location.
  145.  
  146. The users will automatically have a NEWS.INI and NEWS.PRM created in their mail
  147. directory.  When trumpet is started, the existence of a NEWS.INI is checked,
  148. and if one is not found, a list of news groups will be retrieved from the
  149. NNTP server.  This can take some time, so be patient.
  150.  
  151. The sequence of events for a novell user are :
  152.  
  153.    1) determination of mail directory
  154.    2) NEWS.PRM loaded from user mail directory. (if exists)
  155.    3)
  156.    4) NEWS.PRM loaded from NEWS.EXE directory.  This will override any attempt
  157.       to forge some of the global parameters.
  158.    5) username and fullname recovered from novell server.
  159.    6) NNTP session opened.
  160.    7-a) if NEWS.INI exists in user mail directory then load it
  161.    7-b) or if NEWS.INI exists in NEWS.EXE directory then load it
  162.    7-c) or subscribe to all newsgroups on the NNTP server.
  163.    ....
  164.    ....
  165.    [ optional
  166.      8) User changes Setup (limited to only .sig file name)
  167.      9) NEWS.PRM saved in mail directory
  168.    ]
  169.    ....
  170.    ....
  171.    10) User quits.
  172.    11) NEWS.INI saved in mail directory
  173.    12) NNTP session ended.
  174.    13) program ends.
  175.  
  176. Debug options
  177. -------------
  178. The command line parameter -debug enables certain debugging options.
  179.  
  180. the format is
  181.  
  182.     news -debug=xyz
  183.  
  184. where xyz is a string of the following characters
  185.  
  186.     e = ether header trace  (only if ip trace, arp trace or rarp trace is on)
  187.     a = arp trace
  188.     r = rarp trace
  189.     u = udp trace
  190.     i = ip trace
  191.     t = tcp trace
  192.  
  193. e.g.
  194.     news -debug=ate
  195.  
  196. will trace arp packets with ether headers, and trace the tcp
  197.  
  198. The -d option is equivalent to -debug=t
  199.  
  200. NEWS.INI format
  201. ---------------
  202.  
  203. You may modify your own news.ini file.  This can save space in trumpet.
  204.  
  205. The file is simply a list of lines, one per newsgroup.
  206.  
  207. Each line has the following format.
  208.  
  209. <name> <subscribed> <readto> <unread-list>
  210.  
  211. where <name>        ::= string
  212.       <subscribed>  ::= Y | N
  213.       <readto>      ::= integer
  214.       <unread-list> ::= { integer [ - integer ] }
  215.  
  216. e.g.
  217.  
  218. comp.sys.novell Y 2345
  219. sci.physics Y 1234 1021 1034-1041 1211
  220.  
  221.  
  222. -------------------------------------------------------------------------------
  223. Known bugs:
  224.  
  225.     The posting editor may still have problems. Please report any bugs to
  226.  
  227.         peter@psychnet.psychol.utas.edu.au
  228.  
  229.     You can trace bugs with posting by creating a file called POST.LOG in
  230.     the same directory as NEWS.INI.  All lines posted to the NNTP server will be
  231.     saved in this file.
  232.     you
  233.  
  234. Current wish list:
  235.  
  236.     Archiving of articles via a simple database.  (a bit further off)
  237.  
  238. Version 1.01 fixes the following bugs.
  239. --------------------------------------
  240.  
  241. Internal - NNTP result codes interpreted when exceptions occur.
  242.  
  243. TCP/IP - modified to recycle packets out of sequence
  244.  
  245. Unable to change IP address on command line.
  246.  
  247. Some posting editor bugs fixed.
  248.  
  249. Fixed RARP packets, timeout 10 seconds (was 5).
  250.  
  251. Enhancements in Version 1.01
  252. ----------------------------
  253. On initial startup (or NEWS.INI missing) the setup screen appears
  254. automatically.
  255.  
  256. Any error conditions will display a message on the screen for a couple of
  257. seconds.
  258.  
  259. U(nread command now unreads 20 articles at a time
  260.  
  261. Version 1.02 fixes the following bugs
  262. -------------------------------------
  263.  
  264. Check for low memory.  Displays a message, and limps on with reduced memory.
  265.  
  266. Article numbers > 65535 should work now.
  267.  
  268. Version 1.03 fixes the following bugs
  269. -------------------------------------
  270.  
  271. Some ARP code broken.
  272. TCP code improved for sending data.
  273. SMTP address not saved after setup screen.
  274. fixed bug when unread list contains old articles which have disappeared from
  275. NNTP host.
  276. Fixed bug in screen display when focussing a new group without loading.
  277. Fixed bug introduced by Memory low checking. If there were unread articles,
  278. the readto pointer was assigned to the last of them. Updated correctly now.
  279.  
  280. Version 1.03 Enhancements
  281. -------------------------
  282. Forwarding command in article and news item windows.  (defaults to self)
  283. Mail command sends new letter to author of article.
  284. Reply command replies to author of article.
  285. Indicator on start up about IP address shows netmask and default gateway.
  286. More dials on load/save of news.ini.
  287. Full name extracted from Novell bindery.
  288. BOOTP installed.
  289. More robust Novell usage.
  290. Command line entry of all parameters.
  291. Extended debug options.
  292.