Mercurial > noffle
annotate docs/noffle.conf.5 @ 254:4c0f54d51591 noffle
[svn] * configure,configure.in: Add -DDEBUG to build lines when configured
with enable-debug.
author | bears |
---|---|
date | Wed, 26 Jun 2002 14:14:56 +0100 |
parents | 0340b9c17edc |
children | c02c4eb95f95 |
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 |
249 | 2 .\" $Id: noffle.conf.5 381 2002-05-14 14:25:45Z mirkol $ |
85
dfcb28566d36
[svn] Merged in changes from release-1-0 up to release-1-0-merge-1.
enz
parents:
84
diff
changeset
|
3 |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
4 .SH NAME |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
5 noffle.conf \- Configuration file for NOFFLE news server |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
6 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
7 .SH DESCRIPTION |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
8 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
9 The |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
10 .B NOFFLE |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
11 news server - see |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
12 .BR noffle (1) |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
13 - takes its configuration from a configuration file. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
14 By default this file is \fI/etc/noffle.conf\fP. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
15 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
16 .PP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
17 .B noffle.conf |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
18 is a normal text file containing |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
19 .B NOFFLE |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
20 settings, one per line. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
21 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
22 .PP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
23 Leading whitespace on a line is ignored, as is any comment |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
24 text. Comment text begins with a '#' character and continues to the |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
25 end of the line. Blank lines are permitted. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
26 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
27 .SH SETTINGS |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
28 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
29 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
30 .B server <hostname>[:<port>] [<user> <pass>] |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
31 Name of the remote server. If no port given, port 119 is used. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
32 Username and password for servers that need authentication |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
33 (Original AUTHINFO). The password may not contain white-spaces. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
34 If there are multiple server entries in the config file, all of them are |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
35 used for getting groups. In this case the first server should be |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
36 the one of your main provider. Note that you must always |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
37 run 'noffle --query groups' |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
38 after making changes to the server entries. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
39 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
40 .TP |
88
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
41 .B getgroups <group pattern> [, <group pattern> ...] |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
42 Only retrieve from the most recently specified server newsgroups that match |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
43 the specified patterns. The patterns can contain \fIwildcards\fP, and |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
44 there can be multiple |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
45 .B getgroups |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
46 lines. For further details on |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
47 .B getgroups |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
48 processing in tandem with \fBomitgroups\fP, see the section on |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
49 .B omitgroups |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
50 following. |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
51 .br |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
52 Default: All groups |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
53 |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
54 .TP |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
55 .B omitgroups <group pattern> [, <group pattern> ...] |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
56 Don't retrieve from the most recently specified server newsgroups that match |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
57 the specified patterns. The patterns can contain \fIwildcards\fP, and |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
58 there can be multiple |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
59 .B omitgroups |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
60 lines. When processing a new newsgroup name, it is checked first to see |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
61 if it appears on the |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
62 .B getgroups |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
63 list (if any). If not, the group is rejected. |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
64 Then the group is checked to see if it appears on the |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
65 .B omitgroups |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
66 list. If it does not, the group is accepted as a group |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
67 .B NOFFLE |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
68 will list and collect as required. |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
69 .br |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
70 Default: No groups |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
71 |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
72 .TP |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
73 .B max-fetch <n> |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
74 Never get more than <n> articles. If there are more, the oldest ones |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
75 are discarded. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
76 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
77 Default: 300 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
78 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
79 .TP |
150
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
80 .B from-domain <domain> |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
81 When invoked as |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
82 .BR inews (1) |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
83 .B NOFFLE |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
84 will add a From: line to posts that lack one. The address given |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
85 uses the userid of the user who invoked |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
86 .B inews |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
87 and the specified domain. |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
88 .br |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
89 Default: The system domain |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
90 |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
91 .TP |
185
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
92 .B log-debug <log category> [<log category ...] |
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 , |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
101 .BR control , |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
102 .BR expire , |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
103 .BR fetch , |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
104 .BR filter , |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
105 .BR newsbase , |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
106 .BR noffle , |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
107 .BR post , |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
108 .BR protocol , |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
109 .BR requests |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
110 and |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
111 .BR server. |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
112 The |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
113 .B noffle |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
114 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
|
115 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
|
116 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
|
117 .br |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
118 Default: none |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
119 |
fed1334d766b
[svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents:
150
diff
changeset
|
120 .TP |
150
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
121 .B organization <organization> |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
122 When invoked as |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
123 .BR inews (1) |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
124 .B NOFFLE |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
125 will, unless the -O flag is specified, add an Organization: line to |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
126 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
|
127 .B organization |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
128 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
|
129 .br |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
130 Default: <empty string> |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
131 |
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
132 .TP |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
133 .B mail-to <address> |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
134 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
|
135 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
|
136 From field, in this order). |
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: <empty string> |
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 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
141 .B auto-unsubscribe yes|no |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
142 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
|
143 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
|
144 are fresh articles arriving and remaining unread. |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
145 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
146 Default: no |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
147 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
148 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
149 .B auto-unsubscribe-days <n> |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
150 Number of days used for auto-unsubscribe option. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
151 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
152 Default: 30 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
153 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
154 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
155 .B thread-follow-time <n> |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
156 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
|
157 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
|
158 <n> days. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
159 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
160 Default: 7 |
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 connect-timeout <n> |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
164 Timeout for connecting to remote server in seconds. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
165 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
166 Default: 30 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
167 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
168 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
169 .B auto-subscribe yes|no |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
170 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
|
171 <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
|
172 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
|
173 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
|
174 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
|
175 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
176 Default: no |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
177 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
178 .TP |
107 | 179 .B auto-subscribe-mode <group pattern> full|thread|over |
180 Mode for auto-subscribe option for groups that match the given | |
181 pattern. | |
182 .br | |
183 Default: none | |
184 | |
185 .TP | |
186 .B default-auto-subscribe-mode full|thread|over | |
187 Default mode for auto-subscribe option. Used for all groups that do | |
188 not match a pattern specified with | |
189 .B auto-subscribe-mode | |
190 entries (if any). | |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
191 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
192 Default: over |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
193 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
194 .TP |
82 | 195 .B info-always-unread yes|no |
196 An information article is presented for all unsubscribed | |
197 newsgroups. If auto-subscribe mode is off, there is a possibility of | |
198 someone reading the article but forgetting the instructions therein | |
199 and not knowing how to return to a read article. This option causes | |
200 the information article always to be present as an unread article in a | |
201 group when auto-subscribe if off. It does this by incrementing the | |
202 article number of the information article every time it is read. | |
203 .br | |
204 Default: yes | |
205 | |
206 .TP | |
88
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
207 .B post-locally yes|no |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
208 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
|
209 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
|
210 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
|
211 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
|
212 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
|
213 .br |
1fcdced0246e
[svn] Move posting code to post.c, add command line posting
bears
parents:
85
diff
changeset
|
214 Default: no |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
215 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
216 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
217 .B replace-messageid yes|no |
222
bf290632d29e
[svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents:
212
diff
changeset
|
218 Always replace the Message-ID of a posted article with a Message-ID |
bf290632d29e
[svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents:
212
diff
changeset
|
219 generated by NOFFLE. NOFFLE will always add a Message-ID if none is |
bf290632d29e
[svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents:
212
diff
changeset
|
220 present, or replace a Message-ID that does not meet the basic |
bf290632d29e
[svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents:
212
diff
changeset
|
221 formatting and content requirements for a Message-ID. However, some |
bf290632d29e
[svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents:
212
diff
changeset
|
222 news readers may generate Message-IDs that are not accepted by some |
bf290632d29e
[svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents:
212
diff
changeset
|
223 servers (for example the server may insist the Message-ID domain is |
bf290632d29e
[svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents:
212
diff
changeset
|
224 part of the server domain) or may not always be unique. In either of |
bf290632d29e
[svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents:
212
diff
changeset
|
225 these cases you may prefer to have NOFFLE always replace the |
bf290632d29e
[svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents:
212
diff
changeset
|
226 Message-ID. |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
227 .br |
222
bf290632d29e
[svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents:
212
diff
changeset
|
228 Default: no |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
229 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
230 .TP |
195
76460d98b2fb
[svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents:
194
diff
changeset
|
231 .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
|
232 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
|
233 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
|
234 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
|
235 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
|
236 .br |
76460d98b2fb
[svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents:
194
diff
changeset
|
237 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
|
238 |
76460d98b2fb
[svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents:
194
diff
changeset
|
239 .TP |
111 | 240 .B path-header <path header content> |
241 Articles posted without a Path: header have one added by NOFFLE. | |
242 When | |
243 .B path-header | |
244 has its default value (empty) the header content | |
245 is "<hostname>!not-for-mail". | |
246 Use the | |
150
1c7303c71f66
[svn] * src/protocol.c: Fix bug in Prt_getLn if we should read a line
bears
parents:
134
diff
changeset
|
247 .B path-header |
111 | 248 setting to provide alternate content for the Path: header. |
249 This will very rarely be necessary. | |
250 .br | |
251 Default: <empty string> | |
252 | |
253 .TP | |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
254 .B default-expire <n> |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
255 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
|
256 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
257 Default: 14 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
258 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
259 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
260 .B expire <group pattern> <n> |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
261 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
|
262 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
|
263 .B expire |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
264 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
|
265 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
|
266 .I /etc/noffle.conf |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
267 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
|
268 .B default expiry period |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
269 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
|
270 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
271 Default: no |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
272 |
128 | 273 .TP |
274 .B filter <filter specification> | |
275 Add the specified filter to the list of filters to be applied to incoming | |
276 articles. Filters are applied in the order in which they appear in | |
277 .I /etc/noffle.conf | |
278 and are further described in the section | |
279 .B FILTERS | |
280 below. | |
281 .br | |
282 Default: No filters | |
283 | |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
284 .SH "GROUP NAME WILDCARDS" |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
285 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
286 .B NOFFLE |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
287 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
|
288 \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
|
289 .I alt.binaries |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
290 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
|
291 .B wildmat |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
292 patterns) is as follows. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
293 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
294 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
295 .BI \e x |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
296 Turns off the special meaning of |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
297 .I x |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
298 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
|
299 asterisk, and is not special inside square brackets. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
300 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
301 .B ? |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
302 Matches any single character. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
303 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
304 .B * |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
305 Matches any sequence of zero or more characters. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
306 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
307 .BI [ x...y ] |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
308 Matches any single character specified by the set |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
309 .IR x...y . |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
310 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
|
311 That is, |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
312 .I [0\-5abc] |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
313 is a shorthand for |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
314 .IR [012345abc] . |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
315 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
|
316 .I [0-9a-zA-Z._] |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
317 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
|
318 The close bracket, |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
319 .IR ] , |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
320 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
|
321 The minus sign, |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
322 .IR \- , |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
323 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
|
324 .TP |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
325 .BI [^ x...y ] |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
326 This matches any character |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
327 .I not |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
328 in the set |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
329 .IR x...y , |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
330 which is interpreted as described above. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
331 For example, |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
332 .I [^]\-] |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
333 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
|
334 |
128 | 335 .SH FILTERS |
336 | |
337 .B NOFFLE | |
338 supports basic filtering on incoming articles. Articles to be downloaded | |
339 can be matched against one or more criteria and matching articles are | |
340 marked for download using one of the group subscribe modes | |
341 .BR full , | |
342 .B over | |
343 or | |
344 .BR thread . | |
345 Alternatively the filter may specify that the article mode is | |
346 .B discard | |
347 in which case neither the article nor the article overview will | |
348 be downloaded. | |
349 | |
350 .PP | |
351 A | |
352 .B filter | |
353 configuration line consist of one or more filter specifications | |
354 following the | |
355 .B filter | |
356 keyword on the line. The available specifications are: | |
357 | |
358 .PP | |
359 .B action | |
360 = | |
194
a4e9a20e50e5
[svn] * docs/noffle.conf.5,src/configfile.c,src/filter.h,src/filter.c:
bears
parents:
192
diff
changeset
|
361 .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
|
362 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
|
363 or specified as |
a4e9a20e50e5
[svn] * docs/noffle.conf.5,src/configfile.c,src/filter.h,src/filter.c:
bears
parents:
192
diff
changeset
|
364 .BR default , |
a4e9a20e50e5
[svn] * docs/noffle.conf.5,src/configfile.c,src/filter.h,src/filter.c:
bears
parents:
192
diff
changeset
|
365 the action is as specified by the group's subscription mode. |
128 | 366 .PP |
367 .B group | |
368 = | |
369 .IR "<group pattern>" . | |
370 Matches if any group in which the article appears matches the | |
371 specified group pattern. | |
372 .PP | |
373 .B subject | |
374 = | |
375 .IR "<regular expression>" . | |
376 Matches if the article subject matches the given regular expression. | |
377 See the section on regular expressions below. | |
378 .PP | |
379 .B from | |
380 = | |
381 .IR "<regular expression>" . | |
234
a16ee4b00b66
[svn] * docs/noffle.conf.5: Correct typo in From: filter description.
bears
parents:
222
diff
changeset
|
382 Matches if the article From: address matches the given regular expression. |
128 | 383 See the section on regular expressions below. |
384 .PP | |
385 .B msgid | |
386 = | |
387 .IR "<regular expression>" . | |
388 Matches if the article message ID matches the given regular expression. | |
389 See the section on regular expressions below. | |
390 .PP | |
391 .B bytes | |
392 < or = or > | |
393 .IR <number> . | |
394 Matches if the number of bytes in the article is less than, equal to, or | |
395 greater than the given number. | |
396 .PP | |
397 .B lines | |
398 < or = or > | |
399 .IR <number> . | |
400 Matches if the number of lines in the article is less than, equal to, or | |
401 greater than the given number. | |
402 .PP | |
403 .B refs | |
404 < or = or > | |
405 .IR <number> . | |
406 Matches if the number of articles referenced by the article is less | |
407 than, equal to, or greater than the given number. | |
408 .PP | |
249 | 409 .B reference |
410 = | |
411 .IR "<regular expression>" . | |
412 Matches if one of the message IDs in the reference line matches the | |
413 given regular expression. See the section on regular expressions below. | |
414 .PP | |
128 | 415 .B xposts |
416 < or = or > | |
417 .IR <number> . | |
418 Matches if the number of groups the article is posted to is less | |
419 than, equal to, or greater than the given number. | |
212 | 420 .PP |
249 | 421 .B date |
422 < or = or > | |
423 .IR "<date expression>" . | |
424 Matches if the article is older, from the same day or newer than the | |
425 given date expression. See the section on date expressions below. | |
426 .PP | |
427 .B older | |
428 = | |
429 .IR "<date expression>" . | |
430 Equals | |
431 .B date < | |
432 . | |
433 .PP | |
434 .B newer | |
435 = | |
436 .IR "<date expression>" . | |
437 Equals | |
438 .B date > | |
439 . | |
440 .PP | |
212 | 441 .B post-status |
442 = | |
443 .IR "mod|yes|no" . | |
444 Matches if the current newsgroup is moderated, not moderated or closed. | |
445 Unlike the | |
446 .B group | |
447 filter, only the current newsgroup is checked. | |
128 | 448 |
449 .PP | |
134 | 450 Numbers may have a suffix of 'k' or 'm'. As you might expect, 'k' |
451 indicates the number is to be multiplied by 1024 and 'm' indicates | |
452 it is to be multiplied by 1024*1024. Thus 10k is 10240 and 1m is 1048576. | |
453 | |
454 .PP | |
128 | 455 For example, the following filters download all articles in groups |
456 in the alt.binaries tree in full if they are < 10k in size, otherwise | |
457 downloads overviews. | |
458 .PP | |
134 | 459 .I filter group=alt.binaries.* bytes < 10k action=full |
128 | 460 .br |
461 .I filter group=alt.binaries.* action=over | |
462 .PP | |
463 This filter discards all articles with a subject resembling | |
464 the infamous "$$$ Make Money Now! $$$". | |
465 .PP | |
466 \fIfilter subject="\\$*.*Make.*[M|m]oney.*\\$" action=discard\fR | |
467 | |
468 .SH REGULAR EXPRESSIONS | |
469 | |
470 .B NOFFLE | |
471 uses extended POSIX-style regular expressions in its filters. Regular | |
472 expressions are a powerful means of describing patterns that match | |
473 text. A full description is to be found in | |
474 .BR regex (7). | |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
475 |
249 | 476 .SH DATE EXPRESSIONS |
477 | |
478 .B NOFFLE | |
479 uses very simple date expressions. You can use fixed dates in rfc-2822 style | |
480 or variable dates: | |
481 .PP | |
482 .I date="14 May 2002 18:32:50 +0200" | |
483 matches any article sent up to 24 hours before or after the above fixed date. | |
484 Please don't forget the timezone specification. | |
485 .PP | |
486 .I date>"now+1.5" | |
487 matches any article newer than 36 hours from the current date. | |
488 .PP | |
489 .I date="lastupdate-14" | |
490 matches any article older than 14 days since the date of the last | |
491 .B noffle --fetch | |
492 or | |
493 .B noffle --query groups | |
494 from the current newsserver. | |
495 .PP | |
496 .I date="invalid" | |
497 matches any article with an invalid date header. | |
498 .PP | |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
499 .SH SEE ALSO |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
500 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
501 .BR noffle (1) |
128 | 502 .BR regex (7) |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
503 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
504 .SH AUTHORS |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
505 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
506 Markus Enzenberger <markus.enzenberger@t-online.de> |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
507 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
508 Volker Wysk <volker.wysk@student.uni-tuebingen.de> |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
509 .br |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
510 Jim Hague <jim.hague@acm.org> |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
511 .br |
45
32ba1198c6fa
[svn] * Makefile.in, configure, configure.in, docs/Makefile.in, src/Makefile.in:
uh1763
parents:
42
diff
changeset
|
512 Uwe Hermann <uh1763@bingo-ev.de> |
32ba1198c6fa
[svn] * Makefile.in, configure, configure.in, docs/Makefile.in, src/Makefile.in:
uh1763
parents:
42
diff
changeset
|
513 |
42
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
514 1998-2000. |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
515 |
2467ff423c15
[svn] * AUTHORS.html, CHANGELOG.html, COPYING.html, README.html, FAQ.html,
uh1763
parents:
diff
changeset
|
516 |