chiark - git - mdw - fastforward/blob - newinclude.1

   1 .TH newinclude 1
   2 .SH NAME
   3 newinclude \- create a binary mailing list from an :include: file
   4 .SH SYNOPSIS
   5 .B newinclude
   6 .I list
   7 .SH DESCRIPTION
   8 .B newinclude
   9 reads a
  10 sendmail-style
  11 .B :include:
  12 file,
  13 .IR list ,
  14 and converts it into a binary format in
  15 .I list\fB.bin
  16 for use by
  17 .BR fastforward .
  18
  19 .B newinclude
  20 first writes the mailing list to
  21 .IR list\fB.tmp ,
  22 and then moves it to
  23 .IR list\fB.bin .
  24 If there is any problem creating
  25 .IR list\fB.tmp ,
  26 .B newinclude
  27 leaves
  28 .I list\fB.bin
  29 alone.
  30
  31 .B newinclude
  32 always creates
  33 .I list\fB.bin
  34 world-readable.
  35
  36 .B COMPATIBILITY WARNING:
  37 sendmail
  38 reads
  39 .I list
  40 directly;
  41 .B fastforward
  42 needs
  43 .IR list\fB.bin .
  44 sendmail's strategy is a disaster if you save
  45 .I list
  46 to disk at the same moment that
  47 sendmail
  48 reads it;
  49 the list will be truncated at a random spot,
  50 perhaps in the middle of an address.
  51 Furthermore, if the system crashes while you are writing
  52 .IR list ,
  53 .I list
  54 could be filled with all sorts of garbage.
  55 .SH "LIST FORMAT"
  56 .I list
  57 may contain any number of lines;
  58 each line may contain any number of addresses
  59 or further
  60 .B :include:
  61 files.
  62 See
  63 .BR newaliases (1)
  64 for details on the address format.
  65 Any line in
  66 .I file
  67 beginning with # is ignored.
  68
  69 .B COMPATIBILITY WARNING:
  70 .B newinclude
  71 does not support file or program deliveries in
  72 .B :include:
  73 files.
  74 You can use the secure delivery mechanisms described in
  75 .B dot-qmail(5)
  76 instead.
  77
  78 .B COMPATIBILITY WARNING:
  79 Versions of
  80 sendmail
  81 before V8 did not allow comments in
  82 .B :include:
  83 files.
  84 .SH "SEE ALSO"
  85 fastforward(1),
  86 newaliases(1),
  87 setmaillist(1),
  88 dot-qmail(5)