home *** CD-ROM | disk | FTP | other *** search
/ Amiga Elysian Archive / AmigaElysianArchive.iso / comm / uucp1.lha / NewsSetup.DOC next >
Text File  |  1991-09-08  |  7KB  |  158 lines
  1.  
  2.                   NEWSSETUP.DOC
  3.  
  4.     AS OF UUCP VERSION 1.07, NEWS WORKS DIFFERENTLY.  There is no longer a
  5.     'NewsFeed' configuration entry.  Instead, there is a new file called
  6.     UULIB:SYS which contains a list of upstream and downstream news sites.
  7.     ANEWS IS NOW COMPLETELT OBSOLETE, HENCE THE BINARY IS NOT IN UUCP:C,
  8.     YOU MUST USE DNEWS.
  9.  
  10.     To maintain compatibility with older UUCP's, if the NewsFeed
  11.     configuration entry still exists and UULIB:Sys does *not* exist, then
  12.     postnews will create a UULIB:Sys file containing an entry for the
  13.     NewsFeed.  Additionally, if the NewsFeed configuration entry still
  14.     exists, postnews will automatically run batchnews after queueing the
  15.     news.
  16.  
  17.     To use the new news system with one or more upstream or downstream
  18.     sites (upstream sites feed you, you feed downstream sites), you should
  19.     create a UULIB:Sys file (refer to the 'Sys' manual page) containing the
  20.     site or sites in question and DELETE the 'NewsFeed' CONFIG ENTRY.  The
  21.     direct translation of the old 'NewsFeed' config entry is a line in
  22.     the UULIB:Sys file that reads:
  23.  
  24.     newsfeed:*        <- note, only the machine name, not a full
  25.                    domain name.
  26.  
  27.     Now you have a choice.  You can either have BATCHNEWS run automatically
  28.     whenever you post news, or you can run BATCHNEWS as an option to UUCico,
  29.     or you can run BATCHNEWS from your CRONTAB, or you can run BATCHNEWS
  30.     manually.
  31.  
  32.     (1) If you have only a single upstream newsfeed and do not post all
  33.         that much news, then you can have BatchNews run automatically
  34.         by PostNews by adding a config entry to UULIB:Config :
  35.  
  36.         AutoBatch    autobatch
  37.  
  38.     (2) If you have only a single upstream newsfeed and post a lot of
  39.         news AND you call out to your news (verses it calling you)
  40.         most of the time, the easiest thing to do is to specify the
  41.         -b option to UUCico when calling out.  This forces all queued
  42.         articles to be batched before UUCico makes its telephone call.
  43.  
  44.         Do NOT use the AutoBatch config entry
  45.  
  46.         Do NOT use the -b option for UUCico's run from PASSWD (i.e.
  47.         receiving a call)
  48.  
  49.     (3) If you have a single upstream newsfeed and post a lot of news
  50.         and the feed site calls you most of the time, then you do NOT
  51.         want to specify -b in the uucico in the Passwd file because
  52.         it may take a while to compress your news and this can shoot
  53.         your telephone bill up... the remote site may even hang up.
  54.  
  55.         Instead, I suggest adding a DCron CRONTAB entry to
  56.         automatically batch your news at regular intervals (or, if you
  57.         know when the system is to call you, half an hour or so before
  58.         they call you).  Then when the system calls, the news will
  59.         already be pre-batched and waiting in spool for immediate
  60.         transfer.
  61.  
  62.         Do NOT use the AutoBatch config entry
  63.  
  64.         Do NOT use the -b option for UUCico's run from PASSWD (i.e.
  65.         receiving a call)
  66.  
  67.     (4) If you have an upstream feed and also feed news to multiple
  68.         downstream sites then you want to, again, use a DCron CRONTAB
  69.         entry to automatically batch all pending news at regular
  70.         intervals, since the assumption is that you are both calling
  71.         out and other machines are calling you.  You do NOT want to
  72.         specify the -b option to UUCico for the same reasons as (3)...
  73.         in this case the results might even be worse!
  74.  
  75.         Do NOT use the AutoBatch config entry
  76.  
  77.         Do NOT use the -b option for UUCico's run from PASSWD (i.e.
  78.         receiving a call)
  79.  
  80.     NOTE:   If the old NewsFeed config entry exists and the Sys file does
  81.         not exist, PostNews will automatically send a warning to
  82.         the postmaster (i.e. you if you set up your UULIB:Aliases
  83.         correctly) and create a Sys file.  If the old NewsFeed config
  84.         entry exists and a sys file exists PostNews will ignore the
  85.         old Newsfeed config entry but will silently enable AutoBatch
  86.         so dummies who do not set up their system correctly can still
  87.         post news.    Do not rely on this silent AutoBatch enable, please
  88.         use the new AutoBatch config entry if you wish AutoBatching.
  89.  
  90.     NOTE:   BATCHNEWS does not take much cpu when no news needs to be batched
  91.         and can safely be run in small intervals.
  92.  
  93.     The program 'DNews', may be used to read news.  Before 1.06D the
  94.     program was ANews.    ANews source is included in 1.07 but is no longer
  95.     usable to post news and so the binary is not included.   News is placed
  96.     in separate directories in the UUNEWS: directory.
  97.  
  98.     As I said, really aweful documentation eh?
  99.  
  100.                 ---
  101.              WHERE DOES NEWS GO?
  102.  
  103.     News goes into UUNEWS: unless you overide it with a Config entry
  104.     like this:
  105.  
  106.     UUNews    barf:somedirectory
  107.  
  108.     If you leave it at UUNEWS: then you must make sure UUNEWS: is
  109.     Assign'd to the appropriate directory.  The Assign is normally
  110.     done from your startup-sequence.
  111.  
  112.     Before 1.07 you needed to specify a feed site via the NewsFeed
  113.     configuration entry.  This is NO LONGER USED, though some compatibility
  114.     is maintained for those who do not read this document.  Note that the
  115.     configuration entry will be completely phased out in 1.08.    The new
  116.     place for the news feed configuration is in the UULIB:Sys file
  117.  
  118.                 ---
  119.             WHAT NEWSGROUPS DO I GET
  120.  
  121.     You get the newsgroups your feed sends you (you have to tell them what
  122.     you want), and you must also list the groups in the file
  123.     UULIB:NewsGroups .    Any newsgroups you receive that are not in
  124.     UULIB:NewsGroups is placed into the UUNEWS:Junk directory.
  125.  
  126.     If you intend to propogate news to other sites and have their news
  127.     propogated back through you, any news not listed in UULIB:NewsGroups
  128.     will be placed in UUNEWS:Junk, BUT STILL PROPOGATED.  This allows
  129.     downstream sites to post news to groups you do not normally receive and
  130.     vise-versa.  If you wish to prevent news propogation of newsgroups not
  131.     listed in UULIB:NewsGroups, you can clear out the Junk directory before
  132.     running BatchNews, or perhaps use the TrimNews program to radically
  133.     lower the amount of time messages in Junk stick around.
  134.  
  135.                 ---
  136.             HOW IS NEWS TRANSFERED
  137.  
  138.     News is transfered by UUCP.  Your feed site will send you the news
  139.     compressed.  It will be run through the RNews program which
  140.     automatically uncompresses it and splits it up into separate articles,
  141.     creating any necessary directories, and placing said articles in those
  142.     directories according to the newsgroups each article is destined for.
  143.  
  144.     When you post news (via DNews), your UULIB:Sys file determines which
  145.     sites are to receive the news.  No site that the news has already
  146.     propogated through will ever receive the news.  The article is queued
  147.     by appending the file path to the article to the appropriate
  148.     file UUSPOOL:BATCH/<system>.  Then, when BATCHNEWS is run all files
  149.     in UUSPOOL:BATCH are scanned, the articles extracted, compressed, and
  150.     queued to UUSPOOL: for UUCP transfer.
  151.  
  152.                    ---
  153.               READING NEWS WITH DNEWS
  154.                    POSTING NEWS
  155.  
  156.     REFER TO man/DNews
  157.  
  158.