noffle: docs/noffle.conf.5 annotate

annotate docs/noffle.conf.5 @ 494:372f8b55506e noffle

[svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', which optionally postpones adding a message ID to the upstream server. If this is done, post-locally must be off. This is to deal with an upstream server troubling Jan. It usually (but not always) rejects posts with a Noffle message ID. I have changed Jan's original option of 'add-message-id-if-missing' for consistency with 'replace-messageid' and added the manual page entry. See SourceForge feature request 1513395.

author	bears
date	Wed, 12 Jul 2006 20:26:41 +0100
parents	fb8cadeed4d4
children	614a3177b15c

rev	line source
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	1 .TH noffle.conf 5
494 372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	2 .\" $Id: noffle.conf.5 645 2006-07-12 19:26:41Z bears $
85 dfcb28566d36 [svn] Merged in changes from release-1-0 up to release-1-0-merge-1. enz parents: 84 diff changeset	3
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	4 .SH NAME
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	5 noffle.conf \- Configuration file for NOFFLE news server
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	6
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	7 .SH DESCRIPTION
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	8
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	9 The
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	10 .B NOFFLE
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	11 news server - see
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	12 .BR noffle (1)
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	13 - takes its configuration from a configuration file.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	14 By default this file is \fI/etc/noffle.conf\fP.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	15
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	16 .PP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	17 .B noffle.conf
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	18 is a normal text file containing
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	19 .B NOFFLE
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	20 settings, one per line.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	21
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	22 .PP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	23 Leading whitespace on a line is ignored, as is any comment
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	24 text. Comment text begins with a '#' character and continues to the
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	25 end of the line. Blank lines are permitted.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	26
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	27 .SH SETTINGS
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	28
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	29 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	30 .B server <hostname>[:<port>] [<user> <pass>]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	31 Name of the remote server. If no port given, port 119 is used.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	32 Username and password for servers that need authentication
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	33 (Original AUTHINFO). The password may not contain white-spaces.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	34 If there are multiple server entries in the config file, all of them are
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	35 used for getting groups. In this case the first server should be
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	36 the one of your main provider. Note that you must always
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	37 run 'noffle \-\-query groups'
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	38 after making changes to the server entries.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	39
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	40 .TP
88 1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	41 .B getgroups <group pattern> [, <group pattern> ...]
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	42 Only retrieve from the most recently specified server newsgroups that match
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	43 the specified patterns. The patterns can contain \fIwildcards\fP, and
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	44 there can be multiple
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	45 .B getgroups
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	46 lines. For further details on
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	47 .B getgroups
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	48 processing in tandem with \fBomitgroups\fP, see the section on
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	49 .B omitgroups
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	50 following.
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	51 .br
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	52 Default: All groups
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	53
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	54 .TP
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	55 .B omitgroups <group pattern> [, <group pattern> ...]
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	56 Don't retrieve from the most recently specified server newsgroups that match
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	57 the specified patterns. The patterns can contain \fIwildcards\fP, and
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	58 there can be multiple
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	59 .B omitgroups
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	60 lines. When processing a new newsgroup name, it is checked first to see
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	61 if it appears on the
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	62 .B getgroups
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	63 list (if any). If not, the group is rejected.
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	64 Then the group is checked to see if it appears on the
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	65 .B omitgroups
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	66 list. If it does not, the group is accepted as a group
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	67 .B NOFFLE
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	68 will list and collect as required.
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	69 .br
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	70 Default: No groups
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	71
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	72 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	73 .B max\-fetch <n>
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	74 Never get more than <n> articles. If there are more, the oldest ones
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	75 are discarded.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	76 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	77 Default: 300
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	78
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	79 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	80 .B from\-domain <domain>
150 1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	81 When invoked as
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	82 .BR inews (1)
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	83 .B NOFFLE
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	84 will add a From: line to posts that lack one. The address given
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	85 uses the userid of the user who invoked
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	86 .B inews
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	87 and the specified domain.
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	88 .br
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	89 Default: The system domain
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	90
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	91 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	92 .B log\-debug <log category> [<log category ...]
185 fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	93 Log debugging information from the specified log category
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	94 or categories. Logging is via the system logging daemon
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	95 .BR syslogd (8)
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	96 (to the debug facility) and additionally to stderr when running
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	97 interactively. The available categories for logging are
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	98 .BR all ,
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	99 .BR none ,
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	100 .BR config ,
288 c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	101 .BR auth ,
185 fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	102 .BR control ,
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	103 .BR expire ,
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	104 .BR fetch ,
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	105 .BR filter ,
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	106 .BR newsbase ,
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	107 .BR noffle ,
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	108 .BR post ,
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	109 .BR protocol ,
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	110 .BR requests
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	111 and
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	112 .BR server.
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	113 The
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	114 .B noffle
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	115 category is automatically selected whenever any other category is
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	116 selected. These messages are in addition to messages logged to the
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	117 system logging daemon error, information and notification facilities.
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	118 .br
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	119 Default: none
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	120
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'. bears parents: 150 diff changeset	121 .TP
150 1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	122 .B organization <organization>
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	123 When invoked as
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	124 .BR inews (1)
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	125 .B NOFFLE
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	126 will, unless the \-O flag is specified, add an Organization: line to
150 1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	127 posts that lack one. If no
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	128 .B organization
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	129 is specified, the line is not added.
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	130 .br
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	131 Default: <empty string>
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	132
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	133 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	134 .B mail\-to <address>
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	135 Receiver of failed postings. If empty then failed postings are returned
290 f35a7d45efd5 [svn] * docs/noffle.1,docs/noffle.conf.5: Correct footer date, add new RFCs, bears parents: 288 diff changeset	136 to the sender (taking the address from the article's Reply-To, Sender,
f35a7d45efd5 [svn] * docs/noffle.1,docs/noffle.conf.5: Correct footer date, add new RFCs, bears parents: 288 diff changeset	137 X-Sender or From field, in this order).
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	138 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	139 Default: <empty string>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	140
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	141 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	142 .B auto\-unsubscribe yes\|no
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	143 Automatically remove groups from fetch list if they have not been
194 a4e9a20e50e5 [svn] * docs/noffle.conf.5,src/configfile.c,src/filter.h,src/filter.c: bears parents: 192 diff changeset	144 accessed for a number of days. Groups are only unsubscribed if there
192 b9ef99708d1c [svn] * docs/noffle.conf.5,src/noffle.c: Duh! Do unsubscribing the simple way. bears parents: 185 diff changeset	145 are fresh articles arriving and remaining unread.
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	146 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	147 Default: no
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	148
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	149 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	150 .B auto\-unsubscribe\-days <n>
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	151 Number of days used for auto-unsubscribe option.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	152 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	153 Default: 30
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	154
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	155 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	156 .B thread\-follow\-time <n>
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	157 Automatically mark articles for download in thread mode, if they
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	158 are referencing an article that has been opened by a reader within the last
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	159 <n> days.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	160 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	161 Default: 7
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	162
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	163 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	164 .B connect\-timeout <n>
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	165 Timeout for connecting to remote server in seconds.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	166 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	167 Default: 30
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	168
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	169 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	170 .B auto\-subscribe yes\|no
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	171 Automatically put groups on fetch list if someone reads them.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	172 <mode> can be full, over, thread (depending on the fetch mode) or
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	173 off (do not subscribe automatically). Condition for putting a group
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	174 on the list is that an article is opened. For this reason there is
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	175 always a pseudo article visible in groups that are not on the fetch list.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	176 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	177 Default: no
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	178
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	179 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	180 .B auto\-subscribe\-mode <group pattern> full\|thread\|over
107 2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	181 Mode for auto-subscribe option for groups that match the given
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	182 pattern.
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	183 .br
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	184 Default: none
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	185
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	186 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	187 .B default\-auto\-subscribe\-mode full\|thread\|over
107 2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	188 Default mode for auto-subscribe option. Used for all groups that do
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	189 not match a pattern specified with
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	190 .B auto\-subscribe\-mode
107 2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	191 entries (if any).
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	192 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	193 Default: over
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	194
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	195 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	196 .B info\-always\-unread yes\|no
82 1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	197 An information article is presented for all unsubscribed
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	198 newsgroups. If auto-subscribe mode is off, there is a possibility of
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	199 someone reading the article but forgetting the instructions therein
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	200 and not knowing how to return to a read article. This option causes
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	201 the information article always to be present as an unread article in a
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	202 group when auto-subscribe if off. It does this by incrementing the
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	203 article number of the information article every time it is read.
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	204 .br
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	205 Default: yes
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	206
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	207 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	208 .B authenticate\-client yes\|no
288 c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	209 Insist that clients authenticate themselves using the NNTP
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	210 AUTHINFO USER/AUTHINFO PASS transaction before any news is served.
290 f35a7d45efd5 [svn] * docs/noffle.1,docs/noffle.conf.5: Correct footer date, add new RFCs, bears parents: 288 diff changeset	211 This option is recognised only when NOFFLE has been built with
f35a7d45efd5 [svn] * docs/noffle.1,docs/noffle.conf.5: Correct footer date, add new RFCs, bears parents: 288 diff changeset	212 authentication enabled.
288 c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	213 The form of the authentication is determined at compile time; either
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	214 PAM is used (with a service name "noffle"), or the userlist
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	215 file is scanned. This file, by default \fI/etc/noffle.users\fP,
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	216 is a text file. Spaces, comments starting with '#' and blank lines are
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	217 ignored. Other lines must contain space-separated 'username password'
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	218 pairs. For security reasons the userlist file must be a regular file,
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	219 not a link, and must be owner readable only. Finally, note that the
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	220 NNTP AUTHINFO USER/AUTHINFO PASS transaction is not encrypted in any
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	221 way, and so must itself be considered insecure.
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	222 .br
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	223 Default: no
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	224
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	225 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	226 .B post\-locally yes\|no
88 1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	227 Place articles posted to external servers in the local aticle database
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	228 immediately. Some servers may rewrite Message-IDs, which will cause
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	229 duplicate postings of this option is enabled. Also, if for some reason
222 bf290632d29e [svn] * src/post.c: Always replace message ID in posted message if existing bears parents: 212 diff changeset	230 the post to the remote server fails, the article still exists in the local
88 1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	231 database, which may be a source of some confusion.
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	232 .br
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	233 Default: no
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	234
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	235 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	236 .B replace\-messageid yes\|no
222 bf290632d29e [svn] * src/post.c: Always replace message ID in posted message if existing bears parents: 212 diff changeset	237 Always replace the Message-ID of a posted article with a Message-ID
494 372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	238 generated by NOFFLE. NOFFLE by default adds a Message-ID if none is
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	239 present. However, some news readers may generate Message-IDs that are
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	240 not accepted by some servers (for example the server may insist the
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	241 Message-ID domain is part of the server domain) or may not always be
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	242 unique. In either of these cases you may prefer to have NOFFLE always
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	243 replace the Message-ID.
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	244 .br
222 bf290632d29e [svn] * src/post.c: Always replace message ID in posted message if existing bears parents: 212 diff changeset	245 Default: no
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	246
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	247 .TP
494 372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	248 .B add\-messageid\-if-missing yes\|no
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	249 NOFFLE by default will always add a Message-ID a posted article if the
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	250 article does not have a Message-ID. This is required if
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	251 .B post\-locally
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	252 is set. However, some news servers in the wild have been observed
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	253 to prefer to assign their own Message-IDs, to the extent of often
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	254 rejecting posts with perfectly legitimate Message-IDs. If you are
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	255 unfortunate enough to be confronted by one of these beasts, you can
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	256 change
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	257 .B add\-messageid\-if-missing
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	258 to
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	259 .B no
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	260 to leave adding a Message-ID to the upstream server. If you do this,
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	261 you
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	262 .B must
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	263 also set
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	264 .B post\-locally
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	265 to
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	266 .B no
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	267 or posting an article without a Message-ID will generate an error.
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	268 .br
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	269 Default: yes
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	270
372f8b55506e [svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', bears parents: 472 diff changeset	271 .TP
195 76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c, bears parents: 194 diff changeset	272 .B hostname <fully.qualified.domain.name>
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c, bears parents: 194 diff changeset	273 Specify right-hand side of Message-IDs generated by NOFFLE.
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c, bears parents: 194 diff changeset	274 If omitted, the fully qualified domain name of your system will be used.
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c, bears parents: 194 diff changeset	275 If you do not have a fully qualified domain name, your upstream
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c, bears parents: 194 diff changeset	276 newsserver or someone else might allow you to use a subdomain name.
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c, bears parents: 194 diff changeset	277 .br
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c, bears parents: 194 diff changeset	278 Default: <the fully qualified domain name of your system>
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c, bears parents: 194 diff changeset	279
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c, bears parents: 194 diff changeset	280 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	281 .B append\-reply\-to yes\|no
357 b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5, bears parents: 290 diff changeset	282 Append a 'Reply-To:' header to messages posted without it.
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5, bears parents: 290 diff changeset	283 The address from the 'From:' header is used. Though this might seem
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5, bears parents: 290 diff changeset	284 pretty useless at first glance it may be desireable as some providers were
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5, bears parents: 290 diff changeset	285 known to overwrite the 'From:' header.
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5, bears parents: 290 diff changeset	286 .br
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5, bears parents: 290 diff changeset	287 Default: yes
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5, bears parents: 290 diff changeset	288
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5, bears parents: 290 diff changeset	289 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	290 .B path\-header <path header content>
111 6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	291 Articles posted without a Path: header have one added by NOFFLE.
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	292 When
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	293 .B path\-header
111 6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	294 has its default value (empty) the header content
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	295 is "<hostname>!not-for-mail".
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	296 Use the
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	297 .B path\-header
111 6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	298 setting to provide alternate content for the Path: header.
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	299 This will very rarely be necessary.
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	300 .br
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	301 Default: <empty string>
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	302
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	303 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	304 .B default\-expire <n>
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	305 The default expiry period, in days. An expiry period of 0 means "never".
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	306 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	307 Default: 14
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	308
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	309 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	310 .B noffle\-user <n>
288 c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	311 The username under which NOFFLE normally runs. If NOFFLE is invoked by
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	312 root, it will drop its real and effective UID to this user as soon as
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	313 possible.
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	314 .br
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	315 Default: news
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	316
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	317 .TP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	318 .B noffle\-group <n>
288 c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	319 The group under which NOFFLE normally runs. NOFFLE will change to this
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	320 real and effective GID as soon as possible.
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	321 .br
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	322 Default: news
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	323
c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	324 .TP
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	325 .B expire <group pattern> <n>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	326 The expiry period for a newsgroup or set of newsgroups, in days. The
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	327 expiry pattern can contain \fIwildcards\fP, and there can be multiple
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	328 .B expire
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	329 lines. When checking the expiry period for a group, the expiry
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	330 patterns are checked in the order in which they appear in
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	331 .I /etc/noffle.conf
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	332 until the first match occurs. If no pattern matches the group name, the
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	333 .B default expiry period
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	334 is used. An expiry period of 0 means "never".
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	335 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	336 Default: no
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	337
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	338 .TP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	339 .B filter <filter specification>
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	340 Add the specified filter to the list of filters to be applied to incoming
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	341 articles. Filters are applied in the order in which they appear in
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	342 .I /etc/noffle.conf
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	343 and are further described in the section
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	344 .B FILTERS
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	345 below.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	346 .br
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	347 Default: No filters
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	348
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	349 .SH "GROUP NAME WILDCARDS"
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	350
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	351 .B NOFFLE
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	352 uses a wildcard format that closely matches filename-style wildcards.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	353 \fIalt.binaries.*\fP, for example, matches all newsgroups under the
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	354 .I alt.binaries
288 c02c4eb95f95 [svn] * src/configfile.h,src/configfile.c,docs/noffle.conf.5: Add noffle-user bears parents: 249 diff changeset	355 hierarchy. A full description of the format (known as
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	356 .B wildmat
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	357 patterns) is as follows.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	358
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	359 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	360 .BI \e x
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	361 Turns off the special meaning of
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	362 .I x
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	363 and matches it directly; this is used mostly before a question mark or
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	364 asterisk, and is not special inside square brackets.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	365 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	366 .B ?
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	367 Matches any single character.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	368 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	369 .B *
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	370 Matches any sequence of zero or more characters.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	371 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	372 .BI [ x...y ]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	373 Matches any single character specified by the set
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	374 .IR x...y .
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	375 A minus sign may be used to indicate a range of characters.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	376 That is,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	377 .I [0\-5abc]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	378 is a shorthand for
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	379 .IR [012345abc] .
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	380 More than one range may appear inside a character set;
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	381 .I [0-9a-zA-Z._]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	382 matches almost all of the legal characters for a host name.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	383 The close bracket,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	384 .IR ] ,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	385 may be used if it is the first character in the set.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	386 The minus sign,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	387 .IR \- ,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	388 may be used if it is either the first or last character in the set.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	389 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	390 .BI [^ x...y ]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	391 This matches any character
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	392 .I not
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	393 in the set
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	394 .IR x...y ,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	395 which is interpreted as described above.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	396 For example,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	397 .I [^]\-]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	398 matches any character other than a close bracket or minus sign.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	399
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	400 .SH FILTERS
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	401
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	402 .B NOFFLE
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	403 supports basic filtering on incoming articles. Articles to be downloaded
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	404 can be matched against one or more criteria and matching articles are
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	405 marked for download using one of the group subscribe modes
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	406 .BR full ,
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	407 .B over
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	408 or
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	409 .BR thread .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	410 Alternatively the filter may specify that the article mode is
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	411 .B discard
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	412 in which case neither the article nor the article overview will
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	413 be downloaded.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	414
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	415 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	416 A
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	417 .B filter
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	418 configuration line consist of one or more filter specifications
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	419 following the
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	420 .B filter
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	421 keyword on the line. The available specifications are:
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	422
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	423 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	424 .B action
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	425 =
194 a4e9a20e50e5 [svn] * docs/noffle.conf.5,src/configfile.c,src/filter.h,src/filter.c: bears parents: 192 diff changeset	426 .IR "full\|over\|thread\|discard\|default" .
a4e9a20e50e5 [svn] * docs/noffle.conf.5,src/configfile.c,src/filter.h,src/filter.c: bears parents: 192 diff changeset	427 Specifies the action to be taken if the filter matches. If not specified
a4e9a20e50e5 [svn] * docs/noffle.conf.5,src/configfile.c,src/filter.h,src/filter.c: bears parents: 192 diff changeset	428 or specified as
a4e9a20e50e5 [svn] * docs/noffle.conf.5,src/configfile.c,src/filter.h,src/filter.c: bears parents: 192 diff changeset	429 .BR default ,
a4e9a20e50e5 [svn] * docs/noffle.conf.5,src/configfile.c,src/filter.h,src/filter.c: bears parents: 192 diff changeset	430 the action is as specified by the group's subscription mode.
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	431 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	432 .B group
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	433 =
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	434 .IR "<group pattern>" .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	435 Matches if any group in which the article appears matches the
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	436 specified group pattern.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	437 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	438 .B subject
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	439 =
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	440 .IR "<regular expression>" .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	441 Matches if the article subject matches the given regular expression.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	442 See the section on regular expressions below.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	443 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	444 .B from
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	445 =
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	446 .IR "<regular expression>" .
234 a16ee4b00b66 [svn] * docs/noffle.conf.5: Correct typo in From: filter description. bears parents: 222 diff changeset	447 Matches if the article From: address matches the given regular expression.
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	448 See the section on regular expressions below.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	449 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	450 .B msgid
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	451 =
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	452 .IR "<regular expression>" .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	453 Matches if the article message ID matches the given regular expression.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	454 See the section on regular expressions below.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	455 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	456 .B bytes
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	457 < or = or >
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	458 .IR <number> .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	459 Matches if the number of bytes in the article is less than, equal to, or
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	460 greater than the given number.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	461 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	462 .B lines
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	463 < or = or >
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	464 .IR <number> .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	465 Matches if the number of lines in the article is less than, equal to, or
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	466 greater than the given number.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	467 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	468 .B refs
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	469 < or = or >
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	470 .IR <number> .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	471 Matches if the number of articles referenced by the article is less
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	472 than, equal to, or greater than the given number.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	473 .PP
249 0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	474 .B reference
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	475 =
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	476 .IR "<regular expression>" .
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	477 Matches if one of the message IDs in the reference line matches the
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	478 given regular expression. See the section on regular expressions below.
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	479 .PP
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	480 .B xposts
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	481 < or = or >
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	482 .IR <number> .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	483 Matches if the number of groups the article is posted to is less
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	484 than, equal to, or greater than the given number.
212 21200ce10e68 [svn] filter post-status=mod\|yes\|no. mirkol parents: 195 diff changeset	485 .PP
249 0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	486 .B date
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	487 < or = or >
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	488 .IR "<date expression>" .
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	489 Matches if the article is older, from the same day or newer than the
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	490 given date expression. See the section on date expressions below.
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	491 .PP
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	492 .B older
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	493 =
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	494 .IR "<date expression>" .
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	495 Equals
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	496 .B date <
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	497 .
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	498 .PP
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	499 .B newer
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	500 =
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	501 .IR "<date expression>" .
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	502 Equals
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	503 .B date >
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	504 .
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	505 .PP
212 21200ce10e68 [svn] filter post-status=mod\|yes\|no. mirkol parents: 195 diff changeset	506 .B post-status
21200ce10e68 [svn] filter post-status=mod\|yes\|no. mirkol parents: 195 diff changeset	507 =
21200ce10e68 [svn] filter post-status=mod\|yes\|no. mirkol parents: 195 diff changeset	508 .IR "mod\|yes\|no" .
21200ce10e68 [svn] filter post-status=mod\|yes\|no. mirkol parents: 195 diff changeset	509 Matches if the current newsgroup is moderated, not moderated or closed.
21200ce10e68 [svn] filter post-status=mod\|yes\|no. mirkol parents: 195 diff changeset	510 Unlike the
21200ce10e68 [svn] filter post-status=mod\|yes\|no. mirkol parents: 195 diff changeset	511 .B group
21200ce10e68 [svn] filter post-status=mod\|yes\|no. mirkol parents: 195 diff changeset	512 filter, only the current newsgroup is checked.
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	513
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	514 .PP
134 7dfbb1c20a81 [svn] k and m suffices on filter numbers bears parents: 128 diff changeset	515 Numbers may have a suffix of 'k' or 'm'. As you might expect, 'k'
7dfbb1c20a81 [svn] k and m suffices on filter numbers bears parents: 128 diff changeset	516 indicates the number is to be multiplied by 1024 and 'm' indicates
7dfbb1c20a81 [svn] k and m suffices on filter numbers bears parents: 128 diff changeset	517 it is to be multiplied by 1024*1024. Thus 10k is 10240 and 1m is 1048576.
7dfbb1c20a81 [svn] k and m suffices on filter numbers bears parents: 128 diff changeset	518
7dfbb1c20a81 [svn] k and m suffices on filter numbers bears parents: 128 diff changeset	519 .PP
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	520 For example, the following filters download all articles in groups
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	521 in the alt.binaries tree in full if they are < 10k in size, otherwise
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	522 downloads overviews.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	523 .PP
134 7dfbb1c20a81 [svn] k and m suffices on filter numbers bears parents: 128 diff changeset	524 .I filter group=alt.binaries.* bytes < 10k action=full
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	525 .br
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	526 .I filter group=alt.binaries.* action=over
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	527 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	528 This filter discards all articles with a subject resembling
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	529 the infamous "$$$ Make Money Now! $$$".
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	530 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	531 \fIfilter subject="\\$.Make.[M\|m]oney.\\$" action=discard\fR
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	532
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	533 .SH REGULAR EXPRESSIONS
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	534
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	535 .B NOFFLE
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	536 uses extended POSIX-style regular expressions in its filters. Regular
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	537 expressions are a powerful means of describing patterns that match
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	538 text. A full description is to be found in
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	539 .BR regex (7).
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	540
249 0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	541 .SH DATE EXPRESSIONS
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	542
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	543 .B NOFFLE
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	544 uses very simple date expressions. You can use fixed dates in rfc-2822 style
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	545 or variable dates:
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	546 .PP
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	547 .I date="14 May 2002 18:32:50 +0200"
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	548 matches any article sent up to 24 hours before or after the above fixed date.
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	549 Please don't forget the timezone specification.
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	550 .PP
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	551 .I date>"now+1.5"
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	552 matches any article newer than 36 hours from the current date.
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	553 .PP
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	554 .I date="lastupdate\-14"
249 0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	555 matches any article older than 14 days since the date of the last
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	556 .B noffle \-\-fetch
249 0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	557 or
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	558 .B noffle \-\-query groups
249 0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	559 from the current newsserver.
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	560 .PP
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	561 .I date="invalid"
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	562 matches any article with an invalid date header.
0340b9c17edc [svn] * empty log message * mirkol parents: 234 diff changeset	563 .PP
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	564 .SH SEE ALSO
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	565
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	566 .BR noffle (1)
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	567 .BR regex (7)
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	568
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	569 .SH AUTHORS
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	570
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	571 Markus Enzenberger <me@markus\-enzenberger.de>
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	572 .br
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	573 Volker Wysk <volker.wysk@student.uni\-tuebingen.de>
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	574 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	575 Jim Hague <jim.hague@acm.org>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	576 .br
472 fb8cadeed4d4 [svn] fixed manual dashes, see Debian #218448 godisch parents: 357 diff changeset	577 Uwe Hermann <uh1763@bingo\-ev.de>
290 f35a7d45efd5 [svn] * docs/noffle.1,docs/noffle.conf.5: Correct footer date, add new RFCs, bears parents: 288 diff changeset	578 .br
f35a7d45efd5 [svn] * docs/noffle.1,docs/noffle.conf.5: Correct footer date, add new RFCs, bears parents: 288 diff changeset	579 Mirko Liss <mirko.liss@web.de>
45 32ba1198c6fa [svn] * Makefile.in, configure, configure.in, docs/Makefile.in, src/Makefile.in: uh1763 parents: 42 diff changeset	580
290 f35a7d45efd5 [svn] * docs/noffle.1,docs/noffle.conf.5: Correct footer date, add new RFCs, bears parents: 288 diff changeset	581 1998-2003.
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	582
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	583

Mercurial > noffle

annotate docs/noffle.conf.5 @ 494:372f8b55506e noffle