NAME

       slrnpull - Pull a small newsfeed for offline reading.

SYNOPSIS

       slrnpull  [-d spooldir]  [-h server]  [--debug file] [--expire] [--fetch-score n] [--help]
       [--kill-log file]  [--kill-score  n]  [--logfile file]  [--marked-bodies]   [--new-groups]
       [--no-post] [--post] [--post-only] [--rebuild] [--version]

DESCRIPTION

       slrnpull  pulls  a  small newsfeed from an NNTP server.  It puts the articles into a spool
       directory from which slrn can later read them, even if the server is unreachable  at  that
       time.  Typically, this is useful if you do not have a permanent network connection.

OPTIONS

       The following options can be used when calling slrnpull from the command line.

       -d spooldir
              Set   slrnpull's   root   directory  for  this  run  to  spooldir,  overriding  the
              $SLRNPULL_ROOT environment variable.

       -h host[:port]
              Connect to  the  NNTP  server  on  host,  overriding  the  $NNTPSERVER  environment
              variable.  If no port is given, the default NNTP port (119) will be used.

       --debug file
              Write dialogue with the server and some additional debugging output to file.

       --expire
              Expire (remove) old messages from the spool, but do not fetch news.

       --fetch-score n
              Fetch  article  bodies  with  a  score of at least n automatically (in true offline
              mode, the default is to fetch only bodies that were explicitly marked by the user).

       --help Show help for command line switches.

       --kill-log file
              Keep a log of all articles that were killed by the scorefile in file.  By  default,
              no such logfile is created.

       --kill-score n
              Kill all articles with a score below n.  The default value for this is 0.

       --logfile file
              Log  the  messages  and  errors  that  slrnpull  prints  to the screen to file.  By
              default, they get written to the file log in slrnpull's root directory.

       --marked-bodies
              Only fetch bodies that were marked for download within slrn.

       --new-groups
              Check for new groups, appending them to the file new.groups in the data directory.

       --no-post
              Do not post any articles to the server.

       --post Obsolete version of --post-only.

       --post-only
              Post outgoing articles, but do not fetch news.

       --rebuild
              Like --expire, but also rebuild the overview information.   To  be  used  when  the
              overview information is damaged.

       --version
              Print the version number.

ENVIRONMENT

       slrnpull  reads  the following environment variables.  Note that they can be overridden by
       command line switches.

       NNTPSERVER
              You can use this variable to tell slrnpull which NNTP server to connect to.  It can
              be overridden by the command line option -h.

       SLRNPULL_ROOT
              Defines  the  directory  where  slrnpull  will look for its configuration files and
              spool the articles.  An absolute filename is needed here.  This can be overriden by
              the option -d.

FILES

       $SLRNPULL_ROOT/authinfo
              If  the  server  requires  authentication,  this  file  needs  to  contain the data
              (username in the first line, password in the second).  Be careful not to make  this
              file world-readable!

       $SLRNPULL_ROOT/log
              The default file to log status and error messages to.

       $SLRNPULL_ROOT/score
              If  you  want slrnpull to apply scoring rules to decide which articles to download,
              put them into this file.

       $SLRNPULL_ROOT/slrnpull.conf
              The main configuration file.  It tells slrnpull how many articles to get from which
              groups and when to expire them.

SEE ALSO

       The  documentation  that comes with slrnpull, especially README and SETUP. The FAQ of slrn
       also answers some questions about slrnpull.

       You might also want to look at slrn's official home page, http://slrn.sourceforge.net/  or
       post   to   news.software.readers   if  you  have  a  question  not  covered  by  existing
       documentation.

       The  latest  version  of  slrnpull  is  part  of   the   slrn   package   available   from
       http://prdownloads.sourceforge.net/slrn/

AUTHOR

       John E. Davis <davis@space.mit.edu>

       Please send any bug reports to the current maintainer, Thomas Schultz <tststs@gmx.de>