home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / r / rusn-09.zip / RUSNEWS.DOC < prev    next >
Text File  |  1992-11-03  |  7KB  |  201 lines
  1. [ note: trademarks may be used in this document.  use of trademarks does not
  2.   indicate any endorsement of products or corporations, any disprespect for
  3.   trademark law, any contesting of the validity of the trademarks, etc. etc. ]
  4.  
  5.  
  6. Rusnews:
  7. threaded newsreader with killfiles and crosspost filtering for ms-dos waffle.
  8.  
  9.  
  10. Author
  11. ------
  12.  
  13. Russell Schulz - russell@alpha3.ersys.edmonton.ab.ca (921103)
  14.  
  15.  
  16. Credits
  17. -------
  18.  
  19. Kim Storm - author of `nn' - a much more powerful Unix newsreader
  20.  
  21.  
  22. Version for This Document
  23. -------------------------
  24.  
  25. 0.9 (this information can be found in the start of rusnews.pas)
  26.  
  27.  
  28. Companion Software
  29. ------------------
  30.  
  31. trived.exe - trivial editor.  vi-like, somewhat minimal updating, can be
  32.   used on the console without ANSI.SYS present, takes about 50k (so runs
  33.   underneath rusnews0, the smaller-memory version (included))
  34.  
  35. if anyone else has an editor which does these things
  36.   - small memory requirements
  37.   - runs on console (without ANSI.SYS) and through a fossil driver
  38.   - secure - no yanking in of unallowed files
  39.  
  40. please let me know.
  41.  
  42.  
  43. Limitations
  44. -----------
  45.  
  46. quite a few - listed in start of rusnews.pas
  47.  
  48. the one that will seem to concern most users will be lack of posting
  49. capability.  I send out far more email than postings, and I don't miss
  50. it much yet.  I personally believe this tends to keep the quality of
  51. net postings higher, since flamage is confined to the one person to
  52. whom you're sending mail, as opposed to being broadcast to the world.
  53.  
  54.  
  55. Intended Users
  56. --------------
  57.  
  58. people who run ms-dos waffle at the console (not through a dialup line)
  59. who have total control to the computer anyway.  rusnews allows editing of
  60. postings in place, modification of headers, and shelling to the command
  61. line (through an editor).
  62.  
  63. with v0.9 rusnews can be run over the phone lines.  when run over the
  64. phone lines, it defaults to a non-trusted mode (which can be overridden
  65. by the command line (using different extern entries)) which does not
  66. allow users to edit articles or change their From: lines.
  67.  
  68. source code (compilable with Borland's Turbo Pascal 4) should have been
  69. included, since that's the way I sent it out.
  70.  
  71.  
  72. How To Set It Up
  73. ----------------
  74.  
  75. possibly, you may not have to do a thing.  if you want, you can set NET_NAME
  76. to be the user name, or just pass it in on the command line.  if your editor
  77. is not c:\usr\bin\vi.exe, set EDITOR.
  78.  
  79. example: waffle id john, editor is emacs:
  80.  
  81. set NET_NAME=John
  82. set EDITOR=c:\tools\emacs.exe
  83.  
  84. for waffle 1.65 users, set FULLNAME and WAFVERSION.
  85.  
  86. example: full name is John Doe, waffle version is 1.65:
  87.  
  88. set FULLNAME=John Doe
  89. set WAFVERSION=1.65
  90.  
  91. NET_NAME, EDITOR, and FULLNAME can be passed in as command-line paramaters.
  92.  
  93.  
  94. Minimal Instructions on How To Read News With It (Console)
  95. ----------------------------------------------------------
  96.  
  97. run it.
  98.  
  99. C:\>rusnews <-'
  100.  
  101. if you haven't set NET_NAME, it will need a command-line parameter - your
  102. waffle user id
  103.  
  104. C:\>rusnews -u john <-'     or     C:\>rusnews --user john <-'
  105.  
  106. it will then back up your join file (to join.bak) and kill file (to kill.bak)
  107. if they exist.  then for each group in your join file it will find the
  108. postings you have not yet read and sort them by threads.  for each group
  109. with unread postings, a listing of From: and Subject: line data will be
  110. displayed.  hit ? for help at this point.  usually, you just hit unshifted
  111. letter keys to select articles, and space to go to the next selection screen.
  112. after the last selection screen, each selected article is brought up for
  113. browsing.  hit ? for help at this point, too - different functions are
  114. available.
  115.  
  116. while it is reading in unread postings, it will continually list the article
  117. numbers followed by a space.  (if an article is killed, or is malformed,
  118. the article number will be followed by a `k'; if was `seen' or seeable from
  119. a group located before this one in your join file, the article number will
  120. be followed by an `s').  while this is going on, you can hit `Q' to quit
  121. immediately, `N' to start on the next group immediately, or `O' to read
  122. only the articles which have already been scanned.
  123.  
  124.  
  125. Where You Can Hit Control-Break Safely
  126. --------------------------------------
  127.  
  128. - while it is reading in unread articles, where it will be roughly equivalent
  129.   to hitting `Q' - an immediate quit, with all join file information preserved.
  130. - while reading news, where it will quit without updating the join file for
  131.   this group, which is roughly equivalent to quitting and getting the data from
  132.   the join.bak file for that group.
  133.  
  134.  
  135. Command-Line Options
  136. --------------------
  137.  
  138. -u --user      set the username                 -u john
  139.   if not present, it will use NET_NAME
  140.  
  141. -n --newsgroup jump directly to a newsgroup     -n comp.bbs.waffle
  142.   if not present, or invalid, it will just go through the join file
  143.  
  144. -p --port      specify a fossil port            -p 0 (0=com1, 1=com2)
  145.   if not present, will use the console
  146.  
  147. -f --fullname  set the full name                -f John_Doe
  148.   underscores will be changed to spaces; not necessary for waffle v1.64
  149.  
  150. -e --editor    set the editor                   -e d:/path/editor.exe
  151.   if not present, will use EDITOR; if neither present, c:\usr\bin\vi.exe
  152.  
  153. -o --options   editor options                   -o !_w:\user\%A
  154.   underscores will change to spaces; do not include filename
  155.  
  156. -s --forumset  specify the forum set            -s usenet
  157.   if not present, will use `usenet' if found in forums static entry.
  158.   if not present and `usenet' not in forums static entry, will use first found.
  159.  
  160. -t --trusted   allow a remote user to edit articles, change From: lines
  161.   a console user will be allowed to do anything.  a dialin user will only be
  162.   allowed to do everything if this parameter is given.  this option must be
  163.   given after -p/--port to take effect.
  164.  
  165.  
  166. Phone In Usage
  167. --------------
  168.  
  169. - requires a fossil driver, and use of the smaller-limits version (commonly
  170.   called rusnews0.exe) to fit under waffle (if you use shroom, this may be
  171.   unnecessary - I haven't tried)
  172. - set up extern entries
  173.  
  174. for com1:
  175.  
  176. waffle/extern/rusnews: (split for ease of reading - all one line)
  177.   /program="w:/waffle/bin/rusnews0 -u %A -e w:/waffle/bin/trived.exe -o !"
  178.  
  179. for com2:
  180.  
  181. waffle/extern/rusnews: (split for ease of reading - all one line)
  182.   /program="w:/waffle/bin/rusnews0 -p 1 -u %A -e w:/waffle/bin/trived.exe -o !"
  183.  
  184. for trusted users:
  185.  
  186. waffle/extern/trustedn: (split for ease of reading - all one line)
  187.   /access=9 /program="w:/waffle/bin/rusnews0 -t -u %A
  188.   -e w:/waffle/bin/trived.exe -o !"
  189.  
  190.  
  191. Redeeming Features
  192. ------------------
  193.  
  194. - compatible with waffle - no separate database or maintenance required
  195. - hit `k' while reading to kill that subject or author, either in that
  196.   group or in all groups
  197. - automatic filtering of crossposts - any article which is crossposted
  198.   will only be shown if the group you're reading is the first one in your
  199.   join file to which it was posted.
  200. - can be used over a phone line
  201.