doc/pod/distrib.pats.pod

   1 =head1 NAME
   2
   3 distrib.pats - Default values for the Distribution header
   4
   5 =head1 DESCRIPTION
   6
   7 The file I<pathetc>/distrib.pats is used by B<nnrpd> to determine the
   8 default value of the Distribution header.  Blank lines and lines beginning
   9 with a number sign (C<#>) are ignored.  All other lines consist of three
  10 fields separated by a colon:
  11
  12     <weight>:<pattern>:<value>
  13
  14 The first field is the weight to assign to this match.  If a newsgroup
  15 matches multiple lines, the line with the highest weight is used.  This
  16 should be an arbitrary integer greater than zero.  The order of lines in
  17 the file is only important if groups have equal weight (in which case, the
  18 first matching line will be used).
  19
  20 The second field is either the name of a newsgroup or a uwildmat(3)-style
  21 pattern to specify a set of newsgroups.
  22
  23 The third field is the value that should be used for the Distribution
  24 header of a posted article, if this line was picked as the best match and
  25 no Distribution header was supplied by the user.  It can be an empty
  26 string, specifying that no Distribution header should be added.
  27
  28 When a post is received by B<nnrpd> that does not already contain a
  29 Distribution header, each newsgroup to which an article is posted will be
  30 checked against this file in turn, and the matching line with the highest
  31 weight will be used as the value of the Distribution header.  If no lines
  32 match, or if the matching line has an empty string for its third field, no
  33 header will be added.
  34
  35 =head1 HISTORY
  36
  37 Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  Converted to
  38 POD by Russ Allbery <rra@stanford.edu>.
  39
  40 $Id: distrib.pats.pod 6282 2003-04-06 21:50:07Z rra $
  41
  42 =head1 SEE ALSO
  43
  44 inn.conf(5), nnrpd(8), uwildmat(3)
  45
  46 =cut