noffle: docs/noffle.conf.5 annotate

annotate docs/noffle.conf.5 @ 150:1c7303c71f66 noffle

[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line starting with '\0' - according to the leafnode mailing list, this has been seen in the wild. * docs/inews.1,docs/noffle.1,docs/noffle.conf.5, packages/redhat/noffle.spec,src/configfile.h,src/configfile.c, src/noffle.c,src/post.h,src/post.c: Removed use of getopt_long, and added inews mode - the Noffle executable behaves as inews is invoked as inews. This includes adding From: and Organization: headers if necessary - add configs to override defaults for the From: domain and specify the organization. For all my fellow trn-heads out there, and users of any other ageing newsreader that expects inews. Updated RPM spec to create inews link to noffle on install.

author	bears
date	Thu, 26 Oct 2000 22:21:13 +0100
parents	7dfbb1c20a81
children	fed1334d766b

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
150 1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	2 .\" $Id: noffle.conf.5 227 2000-10-26 21:21:13Z 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
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	37 run 'noffle --query groups'
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
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	73 .B max-fetch <n>
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
150 1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	80 .B from-domain <domain>
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
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	92 .B organization <organization>
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	93 When invoked as
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	94 .BR inews (1)
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	95 .B NOFFLE
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	96 will, unless the -O flag is specified, add an Organization: line to
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	97 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	98 .B organization
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	99 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	100 .br
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	101 Default: <empty string>
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	102
1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	103 .TP
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	104 .B mail-to <address>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	105 Receiver of failed postings. If empty then failed postings are returned
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	106 to the sender (taking the address from the article's Sender, X-Sender or
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	107 From field, in this order).
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	108 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	109 Default: <empty string>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	110
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	111 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	112 .B auto-unsubscribe yes\|no
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	113 Automatically remove groups from fetch list if they have not been
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	114 accessed for a number days.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	115 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	116 Default: no
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	117
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	118 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	119 .B auto-unsubscribe-days <n>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	120 Number of days used for auto-unsubscribe option.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	121 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	122 Default: 30
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	123
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	124 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	125 .B thread-follow-time <n>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	126 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	127 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	128 <n> days.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	129 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	130 Default: 7
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	131
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	132 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	133 .B connect-timeout <n>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	134 Timeout for connecting to remote server in seconds.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	135 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	136 Default: 30
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	137
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	138 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	139 .B auto-subscribe yes\|no
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	140 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	141 <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	142 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	143 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	144 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	145 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	146 Default: no
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	147
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	148 .TP
107 2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	149 .B auto-subscribe-mode <group pattern> full\|thread\|over
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	150 Mode for auto-subscribe option for groups that match the given
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	151 pattern.
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	152 .br
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	153 Default: none
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	154
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	155 .TP
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	156 .B default-auto-subscribe-mode full\|thread\|over
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	157 Default mode for auto-subscribe option. Used for all groups that do
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	158 not match a pattern specified with
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	159 .B auto-subscribe-mode
2869baa02f3c [svn] Auto subscribe mode by group bears parents: 88 diff changeset	160 entries (if any).
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	161 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	162 Default: over
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	163
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	164 .TP
82 1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	165 .B info-always-unread yes\|no
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	166 An information article is presented for all unsubscribed
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	167 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	168 someone reading the article but forgetting the instructions therein
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	169 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	170 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	171 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	172 article number of the information article every time it is read.
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	173 .br
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	174 Default: yes
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	175
1eb0cdd17c76 [svn] info-always-unread config/doc/implementation bears parents: 45 diff changeset	176 .TP
88 1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	177 .B post-locally yes\|no
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	178 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	179 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	180 duplicate postings of this option is enabled. Also, if for some reason
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	181 the post to the remote server fails, the article still exist in the local
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	182 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	183 .br
1fcdced0246e [svn] Move posting code to post.c, add command line posting bears parents: 85 diff changeset	184 Default: no
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	185
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	186 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	187 .B replace-messageid yes\|no
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	188 Replace Message-ID of posted articles by a Message-ID generated by
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	189 NOFFLE. Some news readers generate Message-IDs that are not accepted by
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	190 some servers. For generating Message-IDs, the domain name of your system should
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	191 be a valid domain name. If you are in a local domain, set it to your
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	192 provider's domain name.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	193 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	194 Default: yes
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	195
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	196 .TP
111 6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	197 .B path-header <path header content>
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	198 Articles posted without a Path: header have one added by NOFFLE.
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	199 When
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	200 .B path-header
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	201 has its default value (empty) the header content
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	202 is "<hostname>!not-for-mail".
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	203 Use the
150 1c7303c71f66 [svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line bears parents: 134 diff changeset	204 .B path-header
111 6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	205 setting to provide alternate content for the Path: header.
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	206 This will very rarely be necessary.
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	207 .br
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	208 Default: <empty string>
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	209
6f681d41734c [svn] path-header added. bears parents: 107 diff changeset	210 .TP
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	211 .B default-expire <n>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	212 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	213 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	214 Default: 14
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	215
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	216 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	217 .B expire <group pattern> <n>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	218 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	219 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	220 .B expire
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	221 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	222 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	223 .I /etc/noffle.conf
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	224 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	225 .B default expiry period
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	226 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	227 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	228 Default: no
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	229
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	230 .TP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	231 .B filter <filter specification>
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	232 Add the specified filter to the list of filters to be applied to incoming
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	233 articles. Filters are applied in the order in which they appear in
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	234 .I /etc/noffle.conf
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	235 and are further described in the section
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	236 .B FILTERS
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	237 below.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	238 .br
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	239 Default: No filters
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	240
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	241 .SH "GROUP NAME WILDCARDS"
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	242
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	243 .B NOFFLE
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	244 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	245 \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	246 .I alt.binaries
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	247 hierarchy. A full description of the fomat (known as
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	248 .B wildmat
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	249 patterns) is as follows.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	250
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	251 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	252 .BI \e x
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	253 Turns off the special meaning of
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	254 .I x
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	255 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	256 asterisk, and is not special inside square brackets.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	257 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	258 .B ?
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	259 Matches any single character.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	260 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	261 .B *
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	262 Matches any sequence of zero or more characters.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	263 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	264 .BI [ x...y ]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	265 Matches any single character specified by the set
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	266 .IR x...y .
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	267 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	268 That is,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	269 .I [0\-5abc]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	270 is a shorthand for
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	271 .IR [012345abc] .
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	272 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	273 .I [0-9a-zA-Z._]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	274 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	275 The close bracket,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	276 .IR ] ,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	277 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	278 The minus sign,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	279 .IR \- ,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	280 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	281 .TP
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	282 .BI [^ x...y ]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	283 This matches any character
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	284 .I not
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	285 in the set
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	286 .IR x...y ,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	287 which is interpreted as described above.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	288 For example,
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	289 .I [^]\-]
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	290 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	291
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	292 .SH FILTERS
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	293
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	294 .B NOFFLE
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	295 supports basic filtering on incoming articles. Articles to be downloaded
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	296 can be matched against one or more criteria and matching articles are
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	297 marked for download using one of the group subscribe modes
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	298 .BR full ,
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	299 .B over
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	300 or
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	301 .BR thread .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	302 Alternatively the filter may specify that the article mode is
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	303 .B discard
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	304 in which case neither the article nor the article overview will
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	305 be downloaded.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	306
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	307 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	308 A
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	309 .B filter
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	310 configuration line consist of one or more filter specifications
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	311 following the
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	312 .B filter
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	313 keyword on the line. The available specifications are:
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	314
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	315 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	316 .B action
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	317 =
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	318 .IR "full\|over\|thread\|discard" .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	319 Specifies the action to be taken if the filter matches. If not specified,
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	320 the default action is as specified by the group's default subscription mode.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	321 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	322 .B group
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	323 =
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	324 .IR "<group pattern>" .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	325 Matches if any group in which the article appears matches the
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	326 specified group pattern.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	327 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	328 .B subject
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	329 =
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	330 .IR "<regular expression>" .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	331 Matches if the article subject matches the given regular expression.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	332 See the section on regular expressions below.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	333 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	334 .B from
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	335 =
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	336 .IR "<regular expression>" .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	337 Matches if the article subject matches the given regular expression.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	338 See the section on regular expressions below.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	339 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	340 .B msgid
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	341 =
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	342 .IR "<regular expression>" .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	343 Matches if the article message ID matches the given regular expression.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	344 See the section on regular expressions below.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	345 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	346 .B bytes
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	347 < or = or >
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	348 .IR <number> .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	349 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	350 greater than the given number.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	351 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	352 .B lines
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	353 < or = or >
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	354 .IR <number> .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	355 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	356 greater than the given number.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	357 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	358 .B refs
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	359 < or = or >
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	360 .IR <number> .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	361 Matches if the number of articles referenced by the article is less
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	362 than, equal to, or greater than the given number.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	363 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	364 .B xposts
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	365 < or = or >
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	366 .IR <number> .
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	367 Matches if the number of groups the article is posted to is less
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	368 than, equal to, or greater than the given number.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	369
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	370 .PP
134 7dfbb1c20a81 [svn] k and m suffices on filter numbers bears parents: 128 diff changeset	371 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	372 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	373 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	374
7dfbb1c20a81 [svn] k and m suffices on filter numbers bears parents: 128 diff changeset	375 .PP
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	376 For example, the following filters download all articles in groups
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	377 in the alt.binaries tree in full if they are < 10k in size, otherwise
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	378 downloads overviews.
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	379 .PP
134 7dfbb1c20a81 [svn] k and m suffices on filter numbers bears parents: 128 diff changeset	380 .I filter group=alt.binaries.* bytes < 10k action=full
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	381 .br
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	382 .I filter group=alt.binaries.* action=over
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	383 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	384 This filter discards all articles with a subject resembling
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	385 the infamous "$$$ Make Money Now! $$$".
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	386 .PP
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	387 \fIfilter subject="\\$.Make.[M\|m]oney.\\$" action=discard\fR
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	388
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	389 .SH REGULAR EXPRESSIONS
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	390
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	391 .B NOFFLE
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	392 uses extended POSIX-style regular expressions in its filters. Regular
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	393 expressions are a powerful means of describing patterns that match
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	394 text. A full description is to be found in
8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	395 .BR regex (7).
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	396
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	397 .SH SEE ALSO
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	398
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	399 .BR noffle (1)
128 8897b7e3b108 [svn] Add article filtering bears parents: 111 diff changeset	400 .BR regex (7)
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	401
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	402 .SH AUTHORS
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	403
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	404 Markus Enzenberger <markus.enzenberger@t-online.de>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	405 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	406 Volker Wysk <volker.wysk@student.uni-tuebingen.de>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	407 .br
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	408 Jim Hague <jim.hague@acm.org>
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	409 .br
45 32ba1198c6fa [svn] * Makefile.in, configure, configure.in, docs/Makefile.in, src/Makefile.in: uh1763 parents: 42 diff changeset	410 Uwe Hermann <uh1763@bingo-ev.de>
32ba1198c6fa [svn] * Makefile.in, configure, configure.in, docs/Makefile.in, src/Makefile.in: uh1763 parents: 42 diff changeset	411
42 2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	412 1998-2000.
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	413
2467ff423c15 [svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html, uh1763 parents: diff changeset	414

Mercurial > noffle

annotate docs/noffle.conf.5 @ 150:1c7303c71f66 noffle