Proposed samples cleanup

Russ Allbery rra at
Wed Oct 27 09:32:58 UTC 1999

Okay, time to tackle this, since it should really be done before a 2.3
release.  :)

I propose the following breakup/reorganization of the samples directory,
so that make update will update things that probably have not been locally
modified ("INN-maintained" things).  The following files stay in samples:   
buffindexed.conf           nnrpd.track  incoming.conf      nntpsend.ctl
control.ctl        overview.fmt
cycbuff.conf       innfeed.conf   storage.conf  passwd.nntp
distrib.pats    readers.conf   moderators

All of the various control message parsing scripts are still there pending
Greg's controlchan rewrite that will hopefully make them all obsolete (so
it's probably not worth bothering moving them).  All of the configuration
files are obviously still there, as are all the filter scripts.  This is
stuff we really do expect people to change, plus the control message
handling mess.

The following would move into backends:

This is anything INN would be running as a feed, or anything invoked by
something INN is running as a feed, or anything that is used in sending
news to remote sites. is here because actsync is in
backends as well.

The following would move into doc:


The following would move into expire:

The following would move into frontends:

Things that feed articles into INN, or that are used (like sm) to retrieve
from or search through the news spool, plus which is used
to prepare control messages for injection.

The following are obsolete and can be removed (I'll do that right away):  nnrp.access  storage.ctl

Finally, I propose creating a new directory named scripts whose contents
would also be installed as part of make update, containing: 

This is the stuff I didn't have any better place for.

I can do this in the CVS repository if people think it's a good idea and
agree with my placement of things.  I can either copy the RCS files
directly inside the CVS repository, then cvs remove them from their old
location on the tip and cvs remove them from their new location on the
STABLE branch (which creates some repository clutter, but means that the
full change history is available with cvs log) or just cvs add them in
their new location and cvs remove them in their old location (cleaner and
cuts down on repository bloat, but means that you have to go back to
samples and do a cvs log there to get older revision history), whichever
is considered best.

At the same time, as part of this, I'd like to add a new directory called
support, which eventually will get all the various libtool and configure
cruft currently at the top level migrated into it, and stick the following
script ( in it.  Then we can modify all shell and Perl
scripts that require no configure substitution beyond the path to
innshellvars and the path to the interpretor to have the inclusion of
innshellvars on the second line of the script and then use this script
rather than configure to do the substitution (which will be *way* faster
and can be done at build time).


#! @_PATH_SH@

##  $Id$
##  Fix interpretor paths and INN variable load paths.
##  Scripts shipped with INN always have the invocation path for the
##  interpretor on the first line and the command to load INN variable
##  settings into the script on the second line.  For example, for a Bourne
##  shell script:
##      #!/bin/sh
##      . /var/news/lib/innshellvars
##  This script takes as input such a script and outputs the same script
##  with the first two lines replaced to have the correct path to the
##  interpretor and to the INN variable library, as determined by configure.


if [ -z "$input" ] ; then
    echo "No input file specified" >&2
    exit 1

if [ -z "$output" ] ; then
    output=`echo "$input" | sed 's/\.in$//'`
if [ x"$input" = x"$output" ] ; then
    echo "No output file specified and input file doesn't end in .in" >&2
    exit 1

interpretor=`head -1 "$input"`
case "$interpretor" in
    lib=". $LIBDIR/innshellvars"
    lib="require '$LIBDIR/';"
    echo "Unknown interpretor $interpretor" >&2
    exit 1

echo "#! $path"   >  "$output"
echo "$lib"       >> "$output"
sed 1,2d "$input" >> "$output"
chmod 755 "$output"

Russ Allbery (rra at         <URL:>

More information about the inn-workers mailing list