summaryrefslogtreecommitdiff
path: root/README
blob: 5bced3803f2bdfab2e0d026523dc73b5b7d21e5b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
* INTRODUCTION

This is the documentation for MH-E, a GNU Emacs interface to the MH
mail system.

Emacs comes prepackaged with MH-E; the files in this package may be
more recent however. To ascertain the version of MH-E in your version
of Emacs and to determine whether it is necessary to install these
files, run the command "C-h i m mh-e RET" within Emacs. This should
bring you to the top of the MH-E documentation which shows the version
of the documentation which is the same as the version of the software
for which it was written. Use the command "M-x mh-version" within
Emacs to see which version of the software you are running. If this
package contains a more recent version of the MH-E documentation which
is compatible with the version of the software that you're running,
read on.

The Bazaar MH-E manual is built into Bazaar Emacs, so if you use
Bazaar Emacs, then you have no need of this release. You are already
have the latest version of the manual.

This version of the MH-E documentation will appear in GNU Emacs 24.4.



* INSTALL

** Extract the tarball.

If you don't have GNU tar, use gzip to uncompress the tarball and drop
the `z' option.

	tar xzf mh-e-doc-8.5.tgz

** Build the desired documentation.

The Texinfo source can produce documentation in Emacs' info format,
HTML format for viewing via a browser, and PDF formats for printing.

First, go into the mh-e-doc-8.5 directory and then follow the
appropriate directions below.

*** info

Run `make info'. This creates a sub-directory called `info', builds
the info version of the documentation, and deposits it in that
directory. You need the program `makeinfo' to do this.

To view the Info node `mh-e', Find out where your existing info files
are located. Assuming your existing info files are in
`/usr/share/info', set the INFOPATH environment variable to:

	/path/to/mh-e-doc-8.5/info:/usr/share/info

Then run "C-h i g (mh-e) RET" (in Emacs).

*** HTML

Run `make html'. This creates a sub-directory called `html', builds
the HTML version of the documentation, and deposits it in that
directory. You need the programs `makeinfo' to do this.

Use a browser and point it at "/path/to/mh-e-doc-8.5/html/index.html"
to view the documentation.

*** PDF

Run `make pdf'. This builds the PDF version of the documentation, and
names it `mh-e.pdf'. You need the program `texi2pdf', `makeinfo', and
`pdftex' or `pdfetex' to do this.

You can then either view the documentation with a tool such as `gv',
`gpdf', `ggv', `xpdf', or print it. The file is
"/path/to/mh-e-doc-8.5/pdf/mh-e.pdf".

*** Everything

Run `make all' or just `make'.



* BAZAAR MH-E MANUAL INSTALL

After checking out the doc module, follow any of the steps that apply
to you in INSTALL above. In each case, running `make' will try to
create a symbolic link from `doc' to the Emacs source in your MH-E
source tree, specifically `../src/emacs/trunk'. If your Emacs source
is located in another directory, add `EMACS_SRC=/path/to/emacs/trunk'
to your make command line.



* ADDITIONAL INFORMATION

** This documentation is also available in the following forms:

*** HTML & PDF

An online version of the documentation is available here:

	http://mh-e.sourceforge.net/manual/

*** Source

The source for the documentation can be obtained here:

	https://sourceforge.net/project/showfiles.php?group_id=13357

** Mailing Lists, Bug Reports and other Support

Please see http://mh-e.sourceforge.net/.


Local variables:
mode: outline
paragraph-separate: "[ 	]*$"
end: