git.marmaro.de Git - mmh/blob - docs/historical/README

   1 The most recent versions of the documents in this directory were
   2 downloaded from ftp://ftp.vim.org/pub/mail/mh/doc/
   3
   4 These older versions:
   5   ADMIN-19910201.txt
   6   MH-19910201.txt
   7   MH-19921214.pdf
   8   MH-19921214.txt
   9 were downloaded from ftp://munnari.oz.au/pub/mh/doc/
  10
  11 designOfMH.pdf was downloaded from
  12 http://www.dtic.mil/cgi-bin/GetTRDoc?AD=ADA257836
  13
  14 The README below is retained in its original form for posterity.  All
  15 of the txt (.doc and .tty) files have been renamed to .txt.  All of
  16 the postscript (.ps) files have been converted to pdf using ps2pdf.
  17
  18 D. Levine  28 Feb 2012
  19
  20 ------------------------------------------------------------------------
  21 ------------------------------------------------------------------------
  22
  23 mh/doc/README
  24
  25 These are formatted versions of the major MH documents (written
  26 using the troff "-ms" and "-me" macro packages).  The ".doc" files
  27 are formatted for 66 lines/page:
  28
  29   ADMIN.doc     - The MH Administrator's Manual - how to configure MH
  30   MH.doc        - The MH User's Manual
  31   changes.doc   - Changes from MH 6.6 to MH 6.8
  32   mh-gen.doc    - The "READ-ME" file - how to generate MH (aka mh-gen(8))
  33
  34 Postscript versions are also available:
  35
  36   ADMIN.ps      - The MH Administrator's Manual - how to configure MH
  37   MH.ps         - The MH User's Manual
  38   changes.ps    - Changes from MH 6.6 to MH 6.8
  39   mh-gen.ps     - The "READ-ME" file - how to generate MH (aka mh-gen(8))
  40
  41 ------------------------------------------------------------------------
  42
  43 These are postscript conversions of the MH papers which were written
  44 using the TeX typesetting language:
  45
  46   bboards.ps            - The UCI BBoards Facility
  47   beginners.ps          - UCI MH for Beginners
  48   mh4mm.ps              - MH for MM users
  49   mh6.ps                - Changes from MH 6.0 to MH 6.5 for 4.3BSD
  50   multifarious.ps       - MH: A Multifarious User Agen
  51   mznet.ps              - MZnet - Mail Service for Personal Micro Comp. Sys.
  52   realwork.ps           - MH.5 - How to process 200 messages...
  53   trusted.ps            - Design of the TTI Prototype Trusted Mail Agent
  54   tutorial.ps           - The MH Tutorial
  55
  56 These conversions have been provided because they may be of use to some
  57 sites who retrieved MH using FTP, and who do not have TeX to typeset
  58 the papers themselves.  Of course, all recipients of an MH distribution
  59 tape receive a complete set of laser-printed manuals.
  60
  61 These conversions were generated with the "dvips" program.  I have
  62 printed them on an Imagen 5320 w/ Turboscript, and the output is
  63 identical to the original "dvi" versions of these papers.
  64
  65 As yet, I have had no success downloading the postscript files to a Mac-
  66 intosh, and printing them on a Laserwriter.  If you are able to generate
  67 copies of these papers which will print (identically to the originals or
  68 otherwise) on a Laserwriter, please contact "Bug-MH@ICS.UCI.EDU".
  69
  70 ------------------------------------------------------------------------
  71
  72 These files are tty-readable conversions of the MH papers which were
  73 written using the TeX typesetting language:
  74
  75   bboards.tty           - The UCI BBoards Facility
  76   beginners.tty         - UCI MH for Beginners
  77   mh4mm.tty             - MH for MM users
  78   mh6.tty               - Changes from MH 6.0 to MH 6.5 for 4.3BSD
  79   multifarious.tty      - MH: A Multifarious User Agen
  80   mznet.tty             - MZnet - Mail Service for Personal Micro Comp. Sys.
  81   realwork.tty          - MH.5 - How to process 200 messages...
  82   trusted.tty           - Design of the TTI Prototype Trusted Mail Agent
  83   tutorial.tty          - The MH Tutorial
  84
  85 These conversions have been provided because they may be of use to some
  86 sites who retrieved MH using FTP, and who do not have TeX or a laser
  87 printer on which to print the papers.  If you have a Postscript
  88 printer, you may want to retrieve the Postscript conversion of these
  89 papers, available in a different tar archive.
  90
  91 Of course, all recipients of an MH distribution tape receive a complete
  92 set of laser-printed manuals, and these conversions are not a
  93 substitute for properly-formatted copies of the originals.
  94
  95 The conversion was generated by the "dvi2tty" program.  As full use of
  96 TeX's rich typesetting environment was used in writing many of these
  97 papers, and since the output is intended for a line printer, it is
  98 necessarily quite primitive.
  99
 100 Font changes and special character representations are lost entirely.
 101 White-space between words may be deleted or expanded, especially near
 102 punctuation characters.  Blank lines may be added or deleted.
 103
 104 Since typeset lines are typically longer than 80 tty characters, the
 105 output has been generated for 132-colunm output devices.  A typical
 106 page has about 76 lines.  Pages are separated by a formfeed character.
 107
 108 /JLR