annotate docs/noffle.conf.5 @ 500:614a3177b15c noffle tip

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