slrnpull(1)							   User Manuals 						       slrnpull(1)

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 ques-
       tion 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>

Unix								  September 2004						       slrnpull(1)