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