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