noffle: docs/noffle.conf.5 annotate

annotate docs/noffle.conf.5 @ 128:8897b7e3b108 noffle

[svn] Add article filtering

author	bears
date	Wed, 09 Aug 2000 22:19:17 +0100
parents	6f681d41734c
children	7dfbb1c20a81

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

Mercurial > noffle

annotate docs/noffle.conf.5 @ 128:8897b7e3b108 noffle