home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / internet / rnfilters / ReadMe < prev    next >
Text File  |  1993-12-29  |  12KB  |  302 lines
  1. The contents of this archive allow ReadNews to be used to read and write ka9q
  2. mail and news.  Note that it requires that !ReadNews, !NewsDir, !Incorp *and*
  3. !Rucp to be seen by the filer, as well as !TCPIP and !MailDir (you no longer
  4. need !BM, but it is sometimes useful to have it around).  It works with all
  5. versions of ka9q at the time of writing, including 1.21 (all three variants),
  6. 1.22 and 1.23 (and should work with 1.24 when it appears).
  7.  
  8. These programs were primarily written to provide `proof of concept' so I
  9. could ask Julian Wright to support ka9q directly.  Julian has agreed to
  10. do this in a future release of ReadNews (which may be some time coming as
  11. the next release is going to have a lot of yummy new features).
  12.  
  13. Version 4, 29-Dec-1993.  Ka9q->rucp version 0.6, rucp->ka9q version 0.8.
  14.  
  15. This file and the BASIC programs ka9q->rucp and rucp->ka9q are © copyright
  16. Paul L. Allen, 1993, all rights reserved.
  17.  
  18.  
  19. Obtaining
  20. ==========
  21.  
  22. !ReadNews, !NewsDir and !Incorp are the component parts of a package known
  23. as ReadNews.  Both the ReadNews package and !Rucp are available for ftp from
  24. ftp.demon.co.uk in /pub/archimedes, or may be obtained from the Newcastle
  25. info-server.  You don't need *all* of !Rucp, just certain bits, but I'm not
  26. sure *which* bits are necessary and which aren't...
  27.  
  28.  
  29. Installation
  30. ============
  31.  
  32. Copy the basic programs to somewhere handy (the same folder as !TCPIP,
  33. !MailDir, and !Rucp is as good as any).
  34.  
  35. In the following discussion, we will use the following names as examples -
  36. adjust them as necessary:
  37.  
  38.     1) Your machine name is `bar'.
  39.  
  40.     2) Your preferred user name (the one which receives most email) is `foo'.
  41.  
  42.     3) The address of your service provider is `demon.co.uk'.
  43.  
  44.     4) Your site name is therefore bar.demon.co.uk and the full mail
  45.        address for your preferred user name is foo@bar.demon.co.uk.
  46.  
  47.     5) Your mail server (the machine you send mail to) is
  48.        post.demon.co.uk (previously gate.demon.co.uk was used for this
  49.        purpose, you should now be using post.demon.co.uk).
  50.  
  51.     6) Your news server is news.demon.co.uk.
  52.  
  53.     7) You want news to be kicked every 1800 seconds (30 mins).
  54.  
  55.     8) The news-prefix is `Dem', so that the list of newsgroups you
  56.        want to receive is in !TCPIP.DemGroup and news appears in file
  57.        !MailDir.DemNews.  Note that the news prefix must be no longer than
  58.        4 characters, but it may be anything you want (provided the result
  59.        is a valid filename).
  60.  
  61.  
  62. In your !TCPIP.Autoexec file, make sure you have the following entries:
  63.  
  64.    hostname bar.demon.co.uk
  65.  
  66.    domain suffix demon.co.uk
  67.  
  68.    nntp addserver news.demon.co.uk 1800 Dem
  69.  
  70.  
  71. In your !Rucp.SystemRC file, make sure you have the following entries:
  72.  
  73.    NewsDir=<Rucp$Dir>.uucp.news
  74.    MailServ=post
  75.  
  76. Actually, it doesn't really matter what you call the MailServ as long as
  77. it's a valid leafname and it is anything *other than* `news'.  You can quite
  78. happily use the default values supplied for all other entries.
  79.  
  80.  
  81. In your !Rucp.!Boot file, make sure you have the following entries:
  82.  
  83.     Set Rucp$Nodename bar
  84.  
  85.     Set Rucp$Domain bar.demon.co.uk
  86.  
  87.     Set Rucp$User foo
  88.  
  89.  
  90. In your !Rucp.Systems file, make sure you have the following entries:
  91.  
  92.     news Any Dir 2400 g "" AT OK ATDP24846 ogin:--ogin: nvmr sword: HiThere
  93.     post Any Dir 2400 g "" AT OK ATDP24846 ogin:--ogin: nvmr sword: HiThere
  94.  
  95. Actually, only the `news' and `post' part are critical - the rest can be
  96. anything acceptable to Rucp (but this is what you get if you modify the
  97. example given in the Systems file).
  98.  
  99.  
  100. In your !Rucp.UserHome folder, set up a folder for user foo containing
  101. the following files (modify the examples which come with !Rucp):
  102.  
  103.     Aliases    a list of commonly-used email addresses - these appear in
  104.                a menu when you click over an address field in ReadNews.
  105.  
  106.     Signature  The signature you want appended to your postings (ReadNews
  107.                ignores the alternate AltSig file - pity).
  108.  
  109.     RC         User configuration file.  Needs at least:
  110.  
  111.                    Mailbox=foo
  112.                    Name=Your Full Name
  113.                    Home=<Rucp$UserHome>.foo
  114.                    FileSent=Sent
  115.                    Signature=Signature
  116.                    Altsignature=AltSig
  117.                    Aliases=<Rucp$UserHome>.foo.Aliases
  118.  
  119.                With optional Organisation and Replyto entries.  Use the rest
  120.                of the defaults as given in the example.  Note that you can
  121.                setup other users (such as postmaster) in the same way but
  122.                sharing your default users alias file and/or signature and/or
  123.                whatever - you can do all sorts of fun things.
  124.  
  125.  
  126. For each user on your system whom you wish to receive mail (at least the
  127. user referred to by Rucp$User and `postmaster', create an entry in
  128. !Rucp.Passwd of the form
  129.  
  130.     <user>:*:::<descriptive name>
  131.  
  132. e.g.:
  133.  
  134.     foo:*:::test user
  135.  
  136. Mail for users not listed in the Passwd file will be sent to `postmaster'
  137. instead.
  138.  
  139.  
  140. This should basically be it (unless I've forgotten something).  I do recall
  141. that at some stage when I was getting all this working I had to create
  142. a folder manually in the !Rucp.uucp... area - can't quite remember what, and
  143. I'm not sure if it was just teething problems.  Please let me know if you
  144. have similar problems, or if there's something I've omitted.
  145.  
  146.  
  147. Usage
  148. =====
  149.  
  150. To transfer incoming news/mail from ka9q to rucp, double-click on ka9q->rucp.
  151. You can run ka9q->rucp whilst connected to Demon, and you can even run it
  152. whilst e-mail and/or news is coming in without losing anything (though you
  153. will get a warning message if ka9q has the relevant files locked - just run
  154. ka9q->rucp again).  After ka9q->rucp has completed, run !Incorp by clicking on
  155. the !Incorp icon on the icon bar - this will take the rucp-format mail and
  156. news and distribute them to the appropriate places in !NewsDir so !ReadNews
  157. can find them.  Note that the file listing newgroups will be deleted if it
  158. is empty.
  159.  
  160. To transfer outgoing news/mail from rucp to ka9q, double-click on rucp->ka9q.
  161. If ka9q is already running you will need to use the command `smtp kick' to
  162. tell it there is new mail waiting to be sent. 
  163.  
  164.  
  165. Notes
  166. =====
  167.  
  168. Ka9q->rucp now handles mail locking correctly.  You can run it whilst mail
  169. or news (or both) are coming in.  If run whilst ka9q is accessing mail/news
  170. files it will give a warning, otherwise it will process whatever mail/news has
  171. arrived and ka9q will continue happily downloading the rest.
  172.  
  173. Ka9q->rucp mail and news processing has been speeded up by a factor of ten
  174. using some assembler routines - it whizzes through at approximately
  175. 100KB/second.  The assembler routines also implement semi-intelligent double-
  176. buffering which results in greatly reduced disc activity.
  177.  
  178. Ka9q->rucp news processing works with news files from all versions of ka9q.
  179. Version 1.21 and below separated news with
  180.  
  181.     #! rnews
  182.  
  183. whilst version 1.22 and above use
  184.  
  185.     #! rnews 1234
  186.  
  187. where `1234' is the number of bytes in the article.  In order to handle both
  188. kinds it simply ignores the byte count and provides its own (it does this fast
  189. enough that there is no point checking for a byte count and doing a simple
  190. file append if present).  The old version of ka9q->rucp did some very odd
  191. things when confronted with version 1.22 news separators and should not be
  192. used with ka9q version 1.22 or above.
  193.  
  194. Ka9q->rucp will not correctly handle news files with certain pathological
  195. errors: #! rnews followed by #! rnews; #! rnews at end of file.  However,
  196. since these should never happen (and with ka9q version 1.22 and above they
  197. should never, never happen), this shouldn't be a problem.  I had meant to
  198. fix this before releasing the filters, but the appearance of ka9q 1.22 meant I
  199. had to get the new versions out fast.
  200.  
  201. Ka9q->rucp has been modified to work with old versions of ka9q (news placed
  202. in !MailDir) and new versions (news placed in !MaildDir.folder) without
  203. any user intervention.
  204.  
  205. Ka9q->rucp does *not* handle `dotted' usernames (introduced in ka9q version
  206. 1.22) - mail for username `fred' is handled, but mail for username fred.blogs
  207. is ignored - use the alias file (also introduced in ka9q version 1.22