stump/local/man/man1/pmcanon.1

   1 .TH PMCANON 1 "PGP Moose"
   2 .\"@(#)pmcanon.1        1.3 (PGPMoose) 95/10/21
   3 .SH NAME
   4 pmcanon \- put a news article in canonical format
   5 for signature checking
   6 .SH SYNOPSIS
   7 .BI pmcanon [file]
   8 .SH DESCRIPTION
   9 .I Pmcanon
  10 accepts an article from the named
  11 .I file
  12 (or standard input if not specified), selects
  13 certain of the header fields,
  14 and performs certain transformations intended to
  15 defeat unintentional mangling by news transport
  16 programs. The resulting article is written to
  17 standard output, and is suitable to have a PGP
  18 signature generated or checked for it.
  19 .LP
  20 The output produced consists (in order) of a sorted list,
  21 one per line, of newsgroups; the From:, Subject:,
  22 and Message-ID: lines, and the body of the
  23 article (everything after the first empty line).
  24 Other header lines are discarded.
  25 .LP
  26 The body is further processed by deleting all
  27 blank lines, deleting trailing whitespace on
  28 lines, prefixing lines beginning with "--",
  29 "From", "Subject", and a single "." with "-\ ",
  30 ">", ">" and ".", respectively. These
  31 modifications are safe, in that an article which
  32 has already had such modifications will fail to
  33 meet the criterion to have them happen again.
  34 Thus what was used as input when a signature was
  35 generated should still be the same when checked
  36 for validity, even if some of these changes have
  37 happened along the delivery path.
  38 .\".SH FILES
  39 .SH SEE ALSO
  40 .IR pmapp (1),
  41 .IR pmcheck (1),
  42 PGP manual.
  43 .SH AUTHOR
  44 Greg Rose, RoSecure Software.