INN commit: trunk (5 files)
INN Commit
Russ_Allbery at isc.org
Sat Jun 7 12:44:18 UTC 2008
Date: Saturday, June 7, 2008 @ 05:44:17
Author: iulius
Revision: 7859
Fix the use of "ctlinnd reload something 'reason'" in documentation.
Modified:
trunk/doc/pod/cycbuff.conf.pod
trunk/doc/pod/hook-perl.pod
trunk/doc/pod/hook-python.pod
trunk/innd/python.c
trunk/samples/filter_innd.pl
--------------------------+
doc/pod/cycbuff.conf.pod | 2 +-
doc/pod/hook-perl.pod | 6 +++---
doc/pod/hook-python.pod | 6 +++---
innd/python.c | 2 +-
samples/filter_innd.pl | 7 ++++---
5 files changed, 12 insertions(+), 11 deletions(-)
Modified: doc/pod/cycbuff.conf.pod
===================================================================
--- doc/pod/cycbuff.conf.pod 2008-06-05 18:51:20 UTC (rev 7858)
+++ doc/pod/cycbuff.conf.pod 2008-06-07 12:44:17 UTC (rev 7859)
@@ -99,7 +99,7 @@
B<innd> only reads F<cycbuff.conf> on startup, so if you change anything
in this file and want B<innd> to pick up the changes, you have to use
-C<ctlinnd xexec innd>; C<ctlinnd reload ''> is not sufficient.
+C<ctlinnd xexec innd>; C<ctlinnd reload all ''> is not sufficient.
When articles are stored, the cycbuff into which they're stored is saved
as part of the article token. In order for INN to retrieve articles from
Modified: doc/pod/hook-perl.pod
===================================================================
--- doc/pod/hook-perl.pod 2008-06-05 18:51:20 UTC (rev 7858)
+++ doc/pod/hook-perl.pod 2008-06-07 12:44:17 UTC (rev 7859)
@@ -43,7 +43,7 @@
to be reloaded.
F<filter_innd.pl>, on the other hand, can be reloaded on command (with
-C<ctlinnd reload filter.perl>). Whenever F<filter_innd.pl> is loaded,
+C<ctlinnd reload filter.perl 'reason'>). Whenever F<filter_innd.pl> is loaded,
including the first time at innd startup, the Perl function
filter_before_reload() is called before it's reloaded and the function
filter_after_reload() is called after it's reloaded (if the functions
@@ -61,8 +61,8 @@
was preserved on disk across a stop and restart of innd (perhaps using
filter_mode() S<-- see> below).
-As mentioned above, C<ctlinnd reload filter.perl> (or C<ctlinnd reload
-all>) will cause F<filter_innd.pl> to be reloaded. If the function
+As mentioned above, C<ctlinnd reload filter.perl 'reason'> (or C<ctlinnd reload
+all 'reason'>) will cause F<filter_innd.pl> to be reloaded. If the function
filter_art() is defined after the file has been reloaded, filtering is
turned on. Otherwise, filtering is turned off. (Note that due to the way
Perl stores functions, once you've defined filter_art(), you can't
Modified: doc/pod/hook-python.pod
===================================================================
--- doc/pod/hook-python.pod 2008-06-05 18:51:20 UTC (rev 7858)
+++ doc/pod/hook-python.pod 2008-06-07 12:44:17 UTC (rev 7859)
@@ -30,7 +30,7 @@
See the ctlinnd(8) manual page to learn how to enable, disable and reload
Python filters on a running server (C<ctlinnd mode>, C<ctlinnd python
-y|n>, C<ctlinnd reload filter.python>).
+y|n>, C<ctlinnd reload filter.python 'reason'>).
Also, see the example F<filter_innd.py> script in your filters directory
for a demonstration of how to get all this working.
@@ -56,8 +56,8 @@
=item filter_before_reload(self)
-This will execute any time a C<ctlinnd reload all> or C<ctlinnd reload
-filter.python> command is issued. You can use it to save statistics or
+This will execute any time a C<ctlinnd reload all 'reason'> or C<ctlinnd reload
+filter.python 'reason'> command is issued. You can use it to save statistics or
reports for use after reloading.
=item filter_close(self)
Modified: innd/python.c
===================================================================
--- innd/python.c 2008-06-05 18:51:20 UTC (rev 7858)
+++ innd/python.c 2008-06-07 12:44:17 UTC (rev 7859)
@@ -582,7 +582,7 @@
/*
-** Used by `ctlinnd reload filter.python'
+** Used by "ctlinnd reload filter.python 'reason'".
*/
int
PYreadfilter(void)
Modified: samples/filter_innd.pl
===================================================================
--- samples/filter_innd.pl 2008-06-05 18:51:20 UTC (rev 7858)
+++ samples/filter_innd.pl 2008-06-07 12:44:17 UTC (rev 7859)
@@ -4,8 +4,9 @@
# Sample Perl filtering file for the innd hooks.
#
-# This file gets loaded at innd process startup, and everytime a 'reload
-# perl xxx' or a 'reload all xxx' is done.
+# This file gets loaded at innd process startup, and everytime a
+# "ctlinnd reload filter.perl 'reason'" or a
+# "ctlinnd reload all 'reason'" is done.
#
# Before this file is loaded, the perl routine `filter_before_reload' is
# called, and after it's finished loading, the perl routine
@@ -71,7 +72,7 @@
my $rval = "" ; # Assume we'll accept. Cannot be `0'
### Remove two leading '##' from the following section (and then
-### 'ctlinnd reload filter.perl' and the filter will reject articles that
+### "ctlinnd reload filter.perl 'reason'" and the filter will reject articles that
### have "make money" in the subject, or are posted to more than 10
### newsgroups.
More information about the inn-committers
mailing list