noffle: noffle.1 annotate

annotate noffle.1 @ 32:45ddd5e72164 noffle

[svn] Added comment about seemingly unnessecary code.

author	enz
date	Sun, 30 Apr 2000 20:07:54 +0100
parents	526a4c34ee2e
children	8e972daaeab9

rev	line source
0 04124a4423d4 [svn] Initial revision enz parents: diff changeset	1 .TH noffle 1
26 526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	2 .\" $Id: noffle.1 32 2000-04-29 14:45:56Z enz $
0 04124a4423d4 [svn] Initial revision enz parents: diff changeset	3 .SH NAME
04124a4423d4 [svn] Initial revision enz parents: diff changeset	4 noffle \- Usenet package optimized for dialup connections.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	5
04124a4423d4 [svn] Initial revision enz parents: diff changeset	6 .SH SYNOPSIS
04124a4423d4 [svn] Initial revision enz parents: diff changeset	7
04124a4423d4 [svn] Initial revision enz parents: diff changeset	8 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	9 \-a \| \-\-article <message id>\|all
04124a4423d4 [svn] Initial revision enz parents: diff changeset	10 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	11 .B noffle
26 526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	12 \-c \| \-\-cancel <message id>
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	13 .br
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	14 .B noffle
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	15 \-C \| \-\-create <local newsgroup name>
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	16 .br
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	17 .B noffle
0 04124a4423d4 [svn] Initial revision enz parents: diff changeset	18 \-d \| \-\-database
04124a4423d4 [svn] Initial revision enz parents: diff changeset	19 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	20 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	21 \-e \| \-\-expire <days>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	22 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	23 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	24 \-f \| \-\-fetch
04124a4423d4 [svn] Initial revision enz parents: diff changeset	25 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	26 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	27 \-g \| \-\-groups
04124a4423d4 [svn] Initial revision enz parents: diff changeset	28 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	29 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	30 \-h \| \-\-help
04124a4423d4 [svn] Initial revision enz parents: diff changeset	31 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	32 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	33 \-l \| \-\-list
04124a4423d4 [svn] Initial revision enz parents: diff changeset	34 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	35 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	36 \-n \| \-\-online
04124a4423d4 [svn] Initial revision enz parents: diff changeset	37 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	38 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	39 \-o \| \-\-offline
04124a4423d4 [svn] Initial revision enz parents: diff changeset	40 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	41 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	42 \-q \| \-\-query groups\|desc\|times
04124a4423d4 [svn] Initial revision enz parents: diff changeset	43 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	44 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	45 \-R \| \-\-requested
04124a4423d4 [svn] Initial revision enz parents: diff changeset	46 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	47 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	48 \-r \| \-\-server
04124a4423d4 [svn] Initial revision enz parents: diff changeset	49 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	50 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	51 \-s \| \-\-subscribe-over <group>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	52 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	53 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	54 \-S \| \-\-subscribe-full <group>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	55 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	56 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	57 \-t \| \-\-subscribe-thread <group>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	58 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	59 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	60 \-u \| \-\-unsubscribe <group>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	61
04124a4423d4 [svn] Initial revision enz parents: diff changeset	62 .SH DESCRIPTION
04124a4423d4 [svn] Initial revision enz parents: diff changeset	63
04124a4423d4 [svn] Initial revision enz parents: diff changeset	64 .B NOFFLE
04124a4423d4 [svn] Initial revision enz parents: diff changeset	65 is an Usenet package optimized for low speed dialup Internet connections
04124a4423d4 [svn] Initial revision enz parents: diff changeset	66 and few users.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	67 The
04124a4423d4 [svn] Initial revision enz parents: diff changeset	68 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	69 program is used for running and steering of the proxy news server,
04124a4423d4 [svn] Initial revision enz parents: diff changeset	70 for retrieving new articles from the remote server and for
04124a4423d4 [svn] Initial revision enz parents: diff changeset	71 expiring old articles from the database.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	72 .B NOFFLE
04124a4423d4 [svn] Initial revision enz parents: diff changeset	73 can fetch newsgroups in one of the following modes:
04124a4423d4 [svn] Initial revision enz parents: diff changeset	74 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	75 .B full
04124a4423d4 [svn] Initial revision enz parents: diff changeset	76 fetch full articles,
04124a4423d4 [svn] Initial revision enz parents: diff changeset	77 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	78 .B over
04124a4423d4 [svn] Initial revision enz parents: diff changeset	79 fetch only article overviews by default. Opening an article marks it
04124a4423d4 [svn] Initial revision enz parents: diff changeset	80 for download next time online,
04124a4423d4 [svn] Initial revision enz parents: diff changeset	81 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	82 .B thread
04124a4423d4 [svn] Initial revision enz parents: diff changeset	83 like
04124a4423d4 [svn] Initial revision enz parents: diff changeset	84 .B over,
04124a4423d4 [svn] Initial revision enz parents: diff changeset	85 but download articles full if an article of the same thread already has
04124a4423d4 [svn] Initial revision enz parents: diff changeset	86 been downloaded.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	87
26 526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	88 .PP
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	89 .B NOFFLE
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	90 also offers limited support for local news groups. Articles
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	91 posted to these appear in full in the database for the local group(s)
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	92 immediately. They are expired in the usual way.
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	93 .PP
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	94 If an article is cross-posted to a local group and a remote group, it
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	95 appears in the local group immediately and in the remote group after
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	96 the next fetch from the remove server.
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	97 .PP
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	98 Note that
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	99 .B NOFFLE
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	100 cannot exchange the contents of local groups with other news servers.
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	101
0 04124a4423d4 [svn] Initial revision enz parents: diff changeset	102 .SH OPTIONS
04124a4423d4 [svn] Initial revision enz parents: diff changeset	103
04124a4423d4 [svn] Initial revision enz parents: diff changeset	104 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	105 .B \-a, \-\-article <message id>\|all
04124a4423d4 [svn] Initial revision enz parents: diff changeset	106 Write article <message id> to standard output. Message Id must contain
23 84bfdb5600b2 [svn] Wrong spool dir and some typos corrected enz parents: 3 diff changeset	107 the leading '<' and trailing '>' (quote the argument with single quotes to
84bfdb5600b2 [svn] Wrong spool dir and some typos corrected enz parents: 3 diff changeset	108 avoid shell interpretation of characters like '<' and '>' and '$').
0 04124a4423d4 [svn] Initial revision enz parents: diff changeset	109 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	110 If "all" is given as message Id, all articles are shown.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	111
04124a4423d4 [svn] Initial revision enz parents: diff changeset	112 .TP
26 526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	113 .B \-c, \-\-cancel <message id>
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	114 Cancel the article from the database and remove it from the queue of
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	115 outbound messages if it has not already been sent. Message Id must
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	116 contain the leading '<' and trailing '>' (quote the argument to avoid
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	117 shell interpretation of '<' and '>').
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	118
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	119 .TP
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	120 .B \-C, \-\-create <local newsgroup name>
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	121 Create a new local newsgroup with the given name. The name should
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	122 conform to the usual newsgroup naming rules to avoid confusing
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	123 newsreaders.
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	124
526a4c34ee2e [svn] Applied patch from Jim Hague: support for local groups / new command enz parents: 23 diff changeset	125 .TP
0 04124a4423d4 [svn] Initial revision enz parents: diff changeset	126 .B \-d, \-\-database
04124a4423d4 [svn] Initial revision enz parents: diff changeset	127 Write the complete content of the article database to standard output.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	128
04124a4423d4 [svn] Initial revision enz parents: diff changeset	129 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	130 .B \-e, \-\-expire <days>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	131 Delete all articles older than <days> days from the database.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	132 Should be run regularily from
04124a4423d4 [svn] Initial revision enz parents: diff changeset	133 .BR crond (8).
04124a4423d4 [svn] Initial revision enz parents: diff changeset	134
04124a4423d4 [svn] Initial revision enz parents: diff changeset	135 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	136 .B \-f, \-\-fetch
04124a4423d4 [svn] Initial revision enz parents: diff changeset	137 Get new newsfeed from the remote server.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	138 Updates the list of the existing newsgroups,
04124a4423d4 [svn] Initial revision enz parents: diff changeset	139 fetches new articles overviews or full articles from subscribed
04124a4423d4 [svn] Initial revision enz parents: diff changeset	140 groups (see
04124a4423d4 [svn] Initial revision enz parents: diff changeset	141 .B fetchlist
04124a4423d4 [svn] Initial revision enz parents: diff changeset	142 ),
04124a4423d4 [svn] Initial revision enz parents: diff changeset	143 delivers all posted articles to the remote server,
04124a4423d4 [svn] Initial revision enz parents: diff changeset	144 and retrieves all articles marked for download.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	145 .B noffle --fetch
04124a4423d4 [svn] Initial revision enz parents: diff changeset	146 should be run in the
04124a4423d4 [svn] Initial revision enz parents: diff changeset	147 .B ip-up
04124a4423d4 [svn] Initial revision enz parents: diff changeset	148 script of
04124a4423d4 [svn] Initial revision enz parents: diff changeset	149 .BR pppd (8).
04124a4423d4 [svn] Initial revision enz parents: diff changeset	150
04124a4423d4 [svn] Initial revision enz parents: diff changeset	151 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	152 .B \-g, \-\-groups
04124a4423d4 [svn] Initial revision enz parents: diff changeset	153 List all groups available at remote server.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	154 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	155 Format (fields separated by tabs):
04124a4423d4 [svn] Initial revision enz parents: diff changeset	156 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	157 <name> <server> <first> <last> <remote next> <created> <last access> <desc>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	158
04124a4423d4 [svn] Initial revision enz parents: diff changeset	159 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	160 .B \-h, \-\-help
04124a4423d4 [svn] Initial revision enz parents: diff changeset	161 Print a list of all options.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	162
04124a4423d4 [svn] Initial revision enz parents: diff changeset	163 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	164 .B \-l, \-\-list
04124a4423d4 [svn] Initial revision enz parents: diff changeset	165 List all groups that are presently to be fetched and their fetch mode.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	166 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	167 Format: <groupname> <server> full\|thread\|over
04124a4423d4 [svn] Initial revision enz parents: diff changeset	168
04124a4423d4 [svn] Initial revision enz parents: diff changeset	169 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	170 .B \-n, \-\-online
04124a4423d4 [svn] Initial revision enz parents: diff changeset	171 Put
04124a4423d4 [svn] Initial revision enz parents: diff changeset	172 .B NOFFLE
04124a4423d4 [svn] Initial revision enz parents: diff changeset	173 to online status. Requested articles or overviews of selected
04124a4423d4 [svn] Initial revision enz parents: diff changeset	174 groups are immediately fetched from the remote server.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	175 Should be run in the
04124a4423d4 [svn] Initial revision enz parents: diff changeset	176 .B ip-up
04124a4423d4 [svn] Initial revision enz parents: diff changeset	177 script of
04124a4423d4 [svn] Initial revision enz parents: diff changeset	178 .BR pppd (8).
04124a4423d4 [svn] Initial revision enz parents: diff changeset	179
04124a4423d4 [svn] Initial revision enz parents: diff changeset	180 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	181 .B \-o, \-\-offline
04124a4423d4 [svn] Initial revision enz parents: diff changeset	182 Put
04124a4423d4 [svn] Initial revision enz parents: diff changeset	183 .B NOFFLE
04124a4423d4 [svn] Initial revision enz parents: diff changeset	184 to offline status. Requested articles not already in the
04124a4423d4 [svn] Initial revision enz parents: diff changeset	185 database are marked for download.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	186 Should be run in the
04124a4423d4 [svn] Initial revision enz parents: diff changeset	187 .B ip-down
04124a4423d4 [svn] Initial revision enz parents: diff changeset	188 script of
04124a4423d4 [svn] Initial revision enz parents: diff changeset	189 .BR pppd (8).
04124a4423d4 [svn] Initial revision enz parents: diff changeset	190
04124a4423d4 [svn] Initial revision enz parents: diff changeset	191 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	192 .B \-q, \-\-query groups\|desc\|times
04124a4423d4 [svn] Initial revision enz parents: diff changeset	193 Query information about all groups from the remote server and merge it to
04124a4423d4 [svn] Initial revision enz parents: diff changeset	194 the
04124a4423d4 [svn] Initial revision enz parents: diff changeset	195 .B groupinfo
04124a4423d4 [svn] Initial revision enz parents: diff changeset	196 file. This must be run after installing
04124a4423d4 [svn] Initial revision enz parents: diff changeset	197 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	198 or sometimes after a change of the remote news server or corruption
04124a4423d4 [svn] Initial revision enz parents: diff changeset	199 of the file. It can take some time on slow connections.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	200 .B groups
04124a4423d4 [svn] Initial revision enz parents: diff changeset	201 retrieves the list of the existing newsgroups
04124a4423d4 [svn] Initial revision enz parents: diff changeset	202 (resets all local article counters),
04124a4423d4 [svn] Initial revision enz parents: diff changeset	203 .B desc
04124a4423d4 [svn] Initial revision enz parents: diff changeset	204 retrieves all newsgroup descriptions,
04124a4423d4 [svn] Initial revision enz parents: diff changeset	205 .B times
04124a4423d4 [svn] Initial revision enz parents: diff changeset	206 retrieves the creation times of the newsgroups.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	207
04124a4423d4 [svn] Initial revision enz parents: diff changeset	208 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	209 .B \-r, \-\-server
04124a4423d4 [svn] Initial revision enz parents: diff changeset	210 Run as NNTP server on standard input and standard output. This is
04124a4423d4 [svn] Initial revision enz parents: diff changeset	211 intended to be called by
04124a4423d4 [svn] Initial revision enz parents: diff changeset	212 .BR inetd (8)
04124a4423d4 [svn] Initial revision enz parents: diff changeset	213 and should be registered in
04124a4423d4 [svn] Initial revision enz parents: diff changeset	214 .B /etc/inetd.conf.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	215 Error and logging messages are put to the
04124a4423d4 [svn] Initial revision enz parents: diff changeset	216 .BR syslogd (8)
04124a4423d4 [svn] Initial revision enz parents: diff changeset	217 daemon which is usually configured to write them to
04124a4423d4 [svn] Initial revision enz parents: diff changeset	218 .B /var/log/news.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	219 A list of the NNTP commands that are understood by
04124a4423d4 [svn] Initial revision enz parents: diff changeset	220 .B noffle
04124a4423d4 [svn] Initial revision enz parents: diff changeset	221 can be retrieved by running the server and typing
04124a4423d4 [svn] Initial revision enz parents: diff changeset	222 .B HELP.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	223
04124a4423d4 [svn] Initial revision enz parents: diff changeset	224 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	225 .B \-R, \-\-requested
04124a4423d4 [svn] Initial revision enz parents: diff changeset	226 List articles that are marked for download.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	227
04124a4423d4 [svn] Initial revision enz parents: diff changeset	228 Format: <message-id> <server>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	229
04124a4423d4 [svn] Initial revision enz parents: diff changeset	230 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	231 .B \-s, \-\-subscribe-over <group>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	232 Add group with name <group> to list of groups that are presently to be fetched
04124a4423d4 [svn] Initial revision enz parents: diff changeset	233 (in over mode).
04124a4423d4 [svn] Initial revision enz parents: diff changeset	234
04124a4423d4 [svn] Initial revision enz parents: diff changeset	235 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	236 .B \-S, \-\-subscribe-full <group>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	237 Add group with name <group> to list of groups that are presently to be fetched
04124a4423d4 [svn] Initial revision enz parents: diff changeset	238 (in full mode).
04124a4423d4 [svn] Initial revision enz parents: diff changeset	239
04124a4423d4 [svn] Initial revision enz parents: diff changeset	240 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	241 .B \-t, \-\-subscribe-thread <group>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	242 Add group with name <group> to list of groups that are presently to be fetched
04124a4423d4 [svn] Initial revision enz parents: diff changeset	243 (in thread mode).
04124a4423d4 [svn] Initial revision enz parents: diff changeset	244
04124a4423d4 [svn] Initial revision enz parents: diff changeset	245 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	246 .B \-u, \-\-unsubscribe <group>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	247 Remove group with name <group> from list of groups that are presently to
04124a4423d4 [svn] Initial revision enz parents: diff changeset	248 be fetched.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	249
04124a4423d4 [svn] Initial revision enz parents: diff changeset	250 .SH FILES
04124a4423d4 [svn] Initial revision enz parents: diff changeset	251
04124a4423d4 [svn] Initial revision enz parents: diff changeset	252 There exists a spool directory (default
23 84bfdb5600b2 [svn] Wrong spool dir and some typos corrected enz parents: 3 diff changeset	253 .I /var/spool/noffle),
0 04124a4423d4 [svn] Initial revision enz parents: diff changeset	254 and a config file (default
04124a4423d4 [svn] Initial revision enz parents: diff changeset	255 .I /etc/noffle.conf).
04124a4423d4 [svn] Initial revision enz parents: diff changeset	256
04124a4423d4 [svn] Initial revision enz parents: diff changeset	257 .PP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	258
04124a4423d4 [svn] Initial revision enz parents: diff changeset	259 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	260 .B <config file>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	261 Configuration file. Comment lines begin with
04124a4423d4 [svn] Initial revision enz parents: diff changeset	262 .I #.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	263 Definition lines may contain:
04124a4423d4 [svn] Initial revision enz parents: diff changeset	264 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	265 .B server <hostname>[:<port>] [<user> <pass>]
23 84bfdb5600b2 [svn] Wrong spool dir and some typos corrected enz parents: 3 diff changeset	266 Name of the remote server. If no port is given, port 119 is used.
0 04124a4423d4 [svn] Initial revision enz parents: diff changeset	267 Username and password for servers that need authentication
04124a4423d4 [svn] Initial revision enz parents: diff changeset	268 (Original AUTHINFO). The password may not contain white-spaces.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	269 If there are multiple server entries in the config file, all of them are
04124a4423d4 [svn] Initial revision enz parents: diff changeset	270 used for getting groups. In this case the first server should be
04124a4423d4 [svn] Initial revision enz parents: diff changeset	271 the one of your main provider. Note that you must always run
04124a4423d4 [svn] Initial revision enz parents: diff changeset	272 "noffle --query groups" after making changes to the server entries.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	273 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	274 .B max-fetch <n>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	275 Never get more than <n> articles. If there are more, the oldest ones
04124a4423d4 [svn] Initial revision enz parents: diff changeset	276 are discarded.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	277 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	278 Default: 300
04124a4423d4 [svn] Initial revision enz parents: diff changeset	279 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	280 .B mail-to <address>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	281 Receiver of failed postings. If empty then failed postings are returned
04124a4423d4 [svn] Initial revision enz parents: diff changeset	282 to the sender (taking the address from the article's Sender, X-Sender or
04124a4423d4 [svn] Initial revision enz parents: diff changeset	283 From field, in this order).
04124a4423d4 [svn] Initial revision enz parents: diff changeset	284 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	285 Default: <empty string>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	286 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	287 .B auto-unsubscribe yes\|no
04124a4423d4 [svn] Initial revision enz parents: diff changeset	288 Automatically remove groups from fetch list if they have not been
23 84bfdb5600b2 [svn] Wrong spool dir and some typos corrected enz parents: 3 diff changeset	289 accessed for a number of days.
0 04124a4423d4 [svn] Initial revision enz parents: diff changeset	290 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	291 Default: no
04124a4423d4 [svn] Initial revision enz parents: diff changeset	292 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	293 .B auto-unsubscribe-days <n>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	294 Number of days used for auto-unsubscribe option.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	295 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	296 Default: 30
04124a4423d4 [svn] Initial revision enz parents: diff changeset	297 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	298 .B thread-follow-time <n>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	299 Automatically mark articles for download in thread mode, if they
04124a4423d4 [svn] Initial revision enz parents: diff changeset	300 are referencing an article that has been opened by a reader within the last
04124a4423d4 [svn] Initial revision enz parents: diff changeset	301 <n> days.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	302 .br
3 0838ae9606b2 [svn] Documented default value for thread-follow-time option. enz parents: 0 diff changeset	303 Default: 7
0838ae9606b2 [svn] Documented default value for thread-follow-time option. enz parents: 0 diff changeset	304 .br
0 04124a4423d4 [svn] Initial revision enz parents: diff changeset	305 .B connect-timeout <n>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	306 Timeout for connecting to remote server in seconds.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	307 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	308 Default: 30
04124a4423d4 [svn] Initial revision enz parents: diff changeset	309 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	310 .B auto-subscribe yes\|no
04124a4423d4 [svn] Initial revision enz parents: diff changeset	311 Automatically put groups on fetch list if someone reads them.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	312 <mode> can be full, over, thread (depending on the fetch mode) or
04124a4423d4 [svn] Initial revision enz parents: diff changeset	313 off (do not subscribe automatically). Condition for putting a group
04124a4423d4 [svn] Initial revision enz parents: diff changeset	314 on the list is that an article is opened. For this reason there is
04124a4423d4 [svn] Initial revision enz parents: diff changeset	315 always a pseudo article visible in groups that are not on the fetch list.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	316 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	317 Default: no
04124a4423d4 [svn] Initial revision enz parents: diff changeset	318 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	319 .B auto-subscribe-mode full\|thread\|over
04124a4423d4 [svn] Initial revision enz parents: diff changeset	320 Mode for auto-subscribe option.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	321 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	322 Default: over
04124a4423d4 [svn] Initial revision enz parents: diff changeset	323 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	324 .B remove-messageid yes\|no
04124a4423d4 [svn] Initial revision enz parents: diff changeset	325 Remove Message-ID from posted articles. Some remote servers can generate
04124a4423d4 [svn] Initial revision enz parents: diff changeset	326 Message-IDs.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	327 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	328 Default: no
04124a4423d4 [svn] Initial revision enz parents: diff changeset	329 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	330 .B replace-messageid yes\|no
04124a4423d4 [svn] Initial revision enz parents: diff changeset	331 Replace Message-ID of posted articles by a Message-ID generated by
04124a4423d4 [svn] Initial revision enz parents: diff changeset	332 NOFFLE. Some news readers generate Message-IDs that are not accepted by
04124a4423d4 [svn] Initial revision enz parents: diff changeset	333 some servers. For generating Message-IDs, the domain name of your system should
04124a4423d4 [svn] Initial revision enz parents: diff changeset	334 be a valid domain name. If you are in a local domain, set it to your
04124a4423d4 [svn] Initial revision enz parents: diff changeset	335 provider's domain name.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	336 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	337 Default: yes
04124a4423d4 [svn] Initial revision enz parents: diff changeset	338 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	339
04124a4423d4 [svn] Initial revision enz parents: diff changeset	340 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	341 .B <spool dir>/fetchlist
04124a4423d4 [svn] Initial revision enz parents: diff changeset	342 List of newsgroups that are presently to be fetched.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	343 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	344
04124a4423d4 [svn] Initial revision enz parents: diff changeset	345 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	346 .B <spool dir>/data/groupinfo.gdbm
04124a4423d4 [svn] Initial revision enz parents: diff changeset	347 Database with groups in
04124a4423d4 [svn] Initial revision enz parents: diff changeset	348 .BR gdbm(3)
04124a4423d4 [svn] Initial revision enz parents: diff changeset	349 format.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	350
04124a4423d4 [svn] Initial revision enz parents: diff changeset	351 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	352 .B <spool dir>/data/articles.gdbm
04124a4423d4 [svn] Initial revision enz parents: diff changeset	353 Database with articles in
04124a4423d4 [svn] Initial revision enz parents: diff changeset	354 .BR gdbm(3)
04124a4423d4 [svn] Initial revision enz parents: diff changeset	355 format.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	356
04124a4423d4 [svn] Initial revision enz parents: diff changeset	357 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	358 .B <spool dir>/lock/
04124a4423d4 [svn] Initial revision enz parents: diff changeset	359 Lock files and files indicating online/offline status.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	360
04124a4423d4 [svn] Initial revision enz parents: diff changeset	361 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	362 .B <spool dir>/outgoing/
04124a4423d4 [svn] Initial revision enz parents: diff changeset	363 Posted articles to be delivered to the remote server.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	364
04124a4423d4 [svn] Initial revision enz parents: diff changeset	365 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	366 .B <spool dir>/overview/
04124a4423d4 [svn] Initial revision enz parents: diff changeset	367 Text file per group with article overviews.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	368
04124a4423d4 [svn] Initial revision enz parents: diff changeset	369 .TP
04124a4423d4 [svn] Initial revision enz parents: diff changeset	370 .B <spool dir>/requested/
04124a4423d4 [svn] Initial revision enz parents: diff changeset	371 Message IDs of articles marked for download.
04124a4423d4 [svn] Initial revision enz parents: diff changeset	372
04124a4423d4 [svn] Initial revision enz parents: diff changeset	373
04124a4423d4 [svn] Initial revision enz parents: diff changeset	374 .SH SEE ALSO
04124a4423d4 [svn] Initial revision enz parents: diff changeset	375
04124a4423d4 [svn] Initial revision enz parents: diff changeset	376 .BR crond (8)
04124a4423d4 [svn] Initial revision enz parents: diff changeset	377 .BR inetd (8),
04124a4423d4 [svn] Initial revision enz parents: diff changeset	378 .BR pppd (8),
04124a4423d4 [svn] Initial revision enz parents: diff changeset	379 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	380 .B RFC 977,
04124a4423d4 [svn] Initial revision enz parents: diff changeset	381 .B RFC 1036,
04124a4423d4 [svn] Initial revision enz parents: diff changeset	382 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	383 .B IETF drafts on common NNTP extensions:
04124a4423d4 [svn] Initial revision enz parents: diff changeset	384 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	385 .B http://www.karlsruhe.org/
04124a4423d4 [svn] Initial revision enz parents: diff changeset	386 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	387 .B NOFFLE home page:
04124a4423d4 [svn] Initial revision enz parents: diff changeset	388 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	389 .B http://home.t-online.de/home/markus.enzenberger/noffle.html
04124a4423d4 [svn] Initial revision enz parents: diff changeset	390
04124a4423d4 [svn] Initial revision enz parents: diff changeset	391 .SH AUTHORS
04124a4423d4 [svn] Initial revision enz parents: diff changeset	392
04124a4423d4 [svn] Initial revision enz parents: diff changeset	393 Markus Enzenberger <markus.enzenberger@t-online.de>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	394 .br
04124a4423d4 [svn] Initial revision enz parents: diff changeset	395 Volker Wysk <volker.wysk@student.uni-tuebingen.de>
04124a4423d4 [svn] Initial revision enz parents: diff changeset	396
04124a4423d4 [svn] Initial revision enz parents: diff changeset	397 1998-1999.

Mercurial > noffle

annotate noffle.1 @ 32:45ddd5e72164 noffle