annotate noffle.conf.example @ 496:a5a37849dc04 noffle

Fix man page ugliness. Debian bug Bug#432392.
author Jim Hague <jim.hague@acm.org>
date Tue, 10 Jul 2007 18:25:21 +0100
parents b0ee77fa24d4
children 614a3177b15c
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
1 ###############################################################################
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
2 #
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
3 # NOFFLE news server config file
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
4 #
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
5 ###############################################################################
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
6
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
7 # Remote news server. Format: <hostname>[:<port>] [<user> <pass>]
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
8 # (<user> and <pass> only for servers with authentication,
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
9 # the password may not contain white-spaces)
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
10
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
11 server news
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
12
89
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
13 # Don't get *.binaries.* from server 'news'
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
14 #omitgroups *.binaries.*
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
15
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
16 # Second server
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
17 # server bins
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
18 #
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
19 # Only get binaries groups from server 'bins'
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
20 # getgroups *.binaries.*
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
21
24
cb6cab9fbdf9 [svn] Typo in comment
enz
parents: 0
diff changeset
22 # Mail address for failed postings
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
23
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
24 #mail-to root
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
25
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
26
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
27 # Never get more than <max-fetch> articles. Discard oldest, if there are more
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
28
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
29 max-fetch 300
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
30
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
31
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
32 # Automatically remove groups from fetch list if they have not been
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
33 # accessed for <n> days.
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
34
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
35 auto-unsubscribe no
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
36 #auto-unsubscribe-days 30
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
37
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
38
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
39 # Parameter for thread mode. Retrieve articles, if they are referencing an
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
40 # article that has been read within the last <n> days
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
41
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
42 thread-follow-time 7
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
43
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
44
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
45 # Timeout for connecting to remote server in seconds.
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
46
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
47 connect-timeout 30
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
48
185
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents: 134
diff changeset
49 # Log all protocol traffic
fed1334d766b [svn] * src/client.c: Change variable only used on constant to 'const'.
bears
parents: 134
diff changeset
50 #log-debug protocol
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
51
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
52 # Automatically put groups on fetchlist, if someone accesses them.
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
53 # Mode can be: full, thread, over
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
54
107
2869baa02f3c [svn] Auto subscribe mode by group
bears
parents: 89
diff changeset
55 auto-subscribe yes
2869baa02f3c [svn] Auto subscribe mode by group
bears
parents: 89
diff changeset
56 default-auto-subscribe-mode full
2869baa02f3c [svn] Auto subscribe mode by group
bears
parents: 89
diff changeset
57 #auto-subscribe-mode *.binaries.* over
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
58
195
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents: 185
diff changeset
59 # Replace Message-ID in posted articles. If you are in a local domain,
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents: 185
diff changeset
60 # ask your news provider for a domain name for generating Message-IDs.
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents: 185
diff changeset
61 # If the hostname option is unused, it is replaced by the fully qualified
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents: 185
diff changeset
62 # domain name of your system.
0
04124a4423d4 [svn] Initial revision
enz
parents:
diff changeset
63
222
bf290632d29e [svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents: 195
diff changeset
64 replace-messageid no
195
76460d98b2fb [svn] * noffle.conf.example,docs/noffle.conf.5,src/configfile.h,src/configfile.c,
bears
parents: 185
diff changeset
65 #hostname UserId-XXXXX_newsserver
249
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
66 #hostname %user@domain.tld
38
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
67
357
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5,
bears
parents: 249
diff changeset
68 # Append a "Reply-To" header with the address mentioned in the "From" header.
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5,
bears
parents: 249
diff changeset
69 # gererally a good idea
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5,
bears
parents: 249
diff changeset
70 append-reply-to yes
b0ee77fa24d4 [svn] * src/post.c,src/configfile.c,src/configfile.h,docs/noffle.conf.5,
bears
parents: 249
diff changeset
71
89
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
72 # Post articles to remote groups into the local database immediately
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
73 # on receipt of article.
222
bf290632d29e [svn] * src/post.c: Always replace message ID in posted message if existing
bears
parents: 195
diff changeset
74 #post-locally no
89
f17eb481c126 [svn] Added post-locally, updated posting code
bears
parents: 38
diff changeset
75
38
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
76 # Set the default expire period in days
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
77 default-expire 14
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
78
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
79 # Expire all alt.* groups after 2 days, except for alt.oxford.*
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
80 # expire after 4 days and alt.oxford.talk never expire.
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
81 #expire alt.oxford.talk 0
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
82 #expire alt.oxford.* 4
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
83 #expire alt.* 2
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
84
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
85 # Appearing here, this is equivalent to 'default-expire 20' above. If it
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
86 # appeared before the other expire lines, all groups would be
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
87 # expired at 20 days, as it would be the first custom match
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
88 # for every group.
8e972daaeab9 [svn] Applied patch from Jim Hague:
enz
parents: 24
diff changeset
89 #expire * 20
131
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
90
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
91 # Sample article filtering.
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
92 # 1. Silently dump without fetching any article with a title
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
93 # looking like '$$$ Make Money Now $$$'.
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
94 # 2. Fetch articles cross-posted to more than 3 groups where one of the
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
95 # groups is alt.flame in overview mode only.
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
96 # 3. Fetch all articles > 20k in size in overview mode only.
249
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
97 # 4. Fetch all articles older than 9.5 weeks in overview mode only.
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
98 # 5. Fetch all articles referencing your or other NOFFLE users'
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
99 # articles in full mode. Works only with 'replace-messageid yes'.
131
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
100
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
101 #filter subject="\$+.*Make.*Money.*Now.*\$\$\$" action=discard
3598fc9581c1 [svn] Added filtering
bears
parents: 107
diff changeset
102 #filter xposts>3 group=alt.flame action=over
134
7dfbb1c20a81 [svn] k and m suffices on filter numbers
bears
parents: 131
diff changeset
103 #filter bytes>20k action=over
249
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
104 #filter date<lastupdate-66.5 action=over
0340b9c17edc [svn] *** empty log message ***
mirkol
parents: 222
diff changeset
105 #filter reference="NOFFLE" action=full