home *** CD-ROM | disk | FTP | other *** search
/ Gold Fish 2 / goldfish_vol2_cd1.bin / files / comm / net / inetutils-amitcp / man / nntpxfer.man < prev    next >
Text File  |  1994-02-20  |  4KB  |  96 lines
  1. NNTPXfer                                   NNTPXfer
  2.  
  3. NAME
  4.  
  5.     NNTPXfer - transfer articles from NNTP server host to local storage
  6.  
  7.     newgroup - define newsgroups to be transferred from NNTP server
  8.  
  9.  
  10. SYNOPSIS
  11.  
  12.     NNTPXfer nntpserver activefile [paranoid]
  13.  
  14.     newgroup activefile newsgroup
  15.  
  16.  
  17. DESCRIPTION
  18.  
  19.     NNTPxfer transfers articles from the NNTP server host to local
  20.     storage (the UUNews: directory). This may be done for a variety
  21.     of reasons, first and foremost that local access to articles is
  22.     significantly faster than remote, regardless of how high-speed
  23.     the communications link is.
  24.  
  25.     NNTPxfer comes with a small utility program named "newgroup"
  26.     which creates and maintains an active file listing the desired
  27.     newsgroups to be transferred.
  28.  
  29.     NNTPxfer is driven by an ACTIVE file, which lists all the newsgroups
  30.     which are to be transferred from the server and stored locally. The
  31.     ACTIVE file contains one line per newsgroup in the following format:
  32.  
  33.         newsgroup hi lo y/n/m
  34.  
  35.     this will look very familiar to some of you.  :)
  36.  
  37.     The 'hi' and 'lo' are the highest and lowest articles present in the
  38.     newsgroup. You can only trust the 'hi' figure. This file is rewritten
  39.     by NNTPxfer, so you should not put ANYTHING else in the file. 'lo'
  40.     should be maintained by whatever program is responsible for doing
  41.     newsgroup article deletion on your system.
  42.  
  43.     You choose whatever you want the ACTIVE file name to be. Recommended:
  44.  
  45.         UULib:News/Active
  46.  
  47.     to be consistent with the naming of other network tools on the Amiga.
  48.  
  49.     If PARANOID is set when you start NNTPxfer, the active file will be
  50.     updated after every newsgroup is complete.
  51.  
  52.     You *must* do a newgroup on every newsgroup you wish to be
  53.     transferred, prior to running NNTPXfer. Otherwise, NNTPXfer will
  54.     not know to transfer the articles.
  55.  
  56.     You *must* have UUNews: assigned to a partition prior to running
  57.     "newgroup". It is *highly recommended* that if you have been using
  58.     AmigaUUCP, that you place you place UUNews in a DIFFERENT directory
  59.     than the one which AmigaUUCP was using. NNTPxfer will transfer
  60.     articles using the same article numbers as your NNTP server has,
  61.     which would confuse AmigaUUCP and most newsreaders to no end.
  62.  
  63.     If you are running GRn, you need to delete (rename) your existing
  64.     GRnrc file, and create a new one, as the article numbers will not
  65.     match. DNews (or any other newsreader/utility that requires .next
  66.     files) will not work when you use NNTPxfer. Others, such as Tin
  67.     and Arn, which maintain their own active file, will need to be set
  68.     up to use the new directory, and rebuild their index files.
  69.  
  70.     NNTPxfer supports an environment variable named NNTPRNEWS. When
  71.     defined, NNTPxfer will call that program, with each incoming news
  72.     article on standard input, and allow it to file that article. This
  73.     allows the input to be filed along with UUCP news, and vice versus.
  74.  
  75.     For example, to be used with the AmigaUUCP RNEWS, the definition
  76.     would be:
  77.  
  78.         SetEnv NNTPRNews uucp:c/rnews -p
  79.  
  80.     with the -p indicating that this is a "postnews" call. Note that for
  81.     maximum speed and efficiency, RNEWS should be a resident program.
  82.  
  83.     When used with UUCP, the article numbers in the ACTIVE file will
  84.     continue to map to those of the NNTP server, *not* the local article
  85.     numbers. This is the way it is supposed to work.
  86.  
  87.  
  88. BUGS/TODO
  89.  
  90.     No bugs known.
  91.  
  92.     It was unfortunate that UULib: and UUNews: were chosen at the
  93.     outset. It implies that these programs are part of, and work with,
  94.     AmigaUUCP, which is not true. Therefore, these may change in the
  95.     future.
  96.