Mercurial > noffle

diff docs/noffle.conf.5 @ 494:372f8b55506e noffle

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
[svn] Apply patch from Jan De Luyck. Add new option 'add-messageid-if-missing', which optionally postpones adding a message ID to the upstream server. If this is done, post-locally must be off. This is to deal with an upstream server troubling Jan. It usually (but not always) rejects posts with a Noffle message ID. I have changed Jan's original option of 'add-message-id-if-missing' for consistency with 'replace-messageid' and added the manual page entry. See SourceForge feature request 1513395.
author bears
date Wed, 12 Jul 2006 20:26:41 +0100
parents fb8cadeed4d4
children 614a3177b15c
line wrap: on
line diff
--- a/docs/noffle.conf.5	Sun Apr 16 07:20:58 2006 +0100
+++ b/docs/noffle.conf.5	Wed Jul 12 20:26:41 2006 +0100
@@ -1,5 +1,5 @@
 .TH noffle.conf 5
-.\" $Id: noffle.conf.5 619 2003-10-31 15:54:59Z godisch $
+.\" $Id: noffle.conf.5 645 2006-07-12 19:26:41Z bears $
 
 .SH NAME
 noffle.conf \- Configuration file for NOFFLE news server
@@ -235,18 +235,40 @@
 .TP
 .B replace\-messageid yes|no
 Always replace the Message-ID of a posted article with a Message-ID
-generated by NOFFLE. NOFFLE will always add a Message-ID if none is
-present, or replace a Message-ID that does not meet the basic
-formatting and content requirements for a Message-ID.  However, some
-news readers may generate Message-IDs that are not accepted by some
-servers (for example the server may insist the Message-ID domain is
-part of the server domain) or may not always be unique. In either of
-these cases you may prefer to have NOFFLE always replace the
-Message-ID.
+generated by NOFFLE. NOFFLE by default adds a Message-ID if none is
+present. However, some news readers may generate Message-IDs that are
+not accepted by some servers (for example the server may insist the
+Message-ID domain is part of the server domain) or may not always be
+unique. In either of these cases you may prefer to have NOFFLE always
+replace the Message-ID.
 .br
 Default: no
 
 .TP
+.B add\-messageid\-if-missing yes|no
+NOFFLE by default will always add a Message-ID a posted article if the
+article does not have a Message-ID. This is required if
+.B post\-locally
+is set. However, some news servers in the wild have been observed
+to prefer to assign their own Message-IDs, to the extent of often
+rejecting posts with perfectly legitimate Message-IDs. If you are
+unfortunate enough to be confronted by one of these beasts, you can
+change
+.B add\-messageid\-if-missing
+to
+.B no
+to leave adding a Message-ID to the upstream server. If you do this,
+you
+.B must
+also set
+.B post\-locally
+to
+.B no
+or posting an article without a Message-ID will generate an error.
+.br
+Default: yes
+
+.TP
 .B hostname <fully.qualified.domain.name>
 Specify right-hand side of Message-IDs generated by NOFFLE.
 If omitted, the fully qualified domain name of your system will be used.