INN commit: trunk/doc/pod (ctlinnd.pod newslog.pod)

[INN Commit]

    Date: Saturday, September 15, 2007 @ 14:18:50
  Author: iulius
Revision: 7673

  * Clarify the cancellation of articles before they arrive.
  * Add a reference to innd logging in newslog(5).

Modified:
  trunk/doc/pod/ctlinnd.pod
  trunk/doc/pod/newslog.pod

-------------+
 ctlinnd.pod |    9 ++++++++-
 newslog.pod |    3 +++
 2 files changed, 11 insertions(+), 1 deletion(-)

Modified: ctlinnd.pod
===================================================================
--- ctlinnd.pod	2007-09-15 07:24:06 UTC (rev 7672)
+++ ctlinnd.pod	2007-09-15 21:18:50 UTC (rev 7673)
@@ -94,8 +94,15 @@
 Remove the article with the specified message ID from the local system.
 This does not generate a cancel control message; it only affects the local
 system.  The angle brackets around the message ID are optional.  It should
-normally be protected from the shell with single quotes.
+normally be protected from the shell with single quotes (and not double
+quotes).  For instance:
 
+    ctlinnd cancel 'test at foo.bar'
+
+Note that the history database is updated with the specified message ID
+so if an article with the same message ID is afterwards received, it will
+be rejected; it is useful for rejecting spam before it arrives.
+
 If the server is throttled manually, this command causes it to briefly
 open the history database.  If the server is paused or throttled for any
 other reason, this command is rejected.

Modified: newslog.pod
===================================================================
--- newslog.pod	2007-09-15 07:24:06 UTC (rev 7672)
+++ newslog.pod	2007-09-15 21:18:50 UTC (rev 7673)
@@ -133,6 +133,9 @@
 because it is posted to a poison newsgroup (a Perl or a Python filter
 located in I<pathfilter> must have brought that reject along).
 
+See the "LOGGING" section of the innd(8) man page for more information about
+the format of this log file.
+
 B<innreport> summarizes the rejected articles reported in this file
 and B<scanlogs> rotates it.