annotate doc/lispref/README @ 95941:63cd1c7b5b2a

Remove bug-lisp-manual@gnu.org, just use M-x report-emacs-bug. Refer to http://shop.fsf.org for printed copies.
author Glenn Morris <rgm@gnu.org>
date Sun, 15 Jun 2008 02:37:20 +0000
parents fde6f792a832
children bb2d47c31e26
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
87649
107ccd98fa12 Merge from emacs--rel--22
Miles Bader <miles@gnu.org>
parents: 84045
diff changeset
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
84045
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
2 Free Software Foundation, Inc.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
3 See the end of the file for license conditions.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
4
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
5
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
6 README for Edition 2.9 of the Emacs Lisp Reference Manual.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
7
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
8 * This directory contains the texinfo source files for the Reference
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
9 Manual, make-permuted-index, and the latest version of texinfo.tex,
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
10 which handles forms that cannot be handled by the older versions of
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
11 texinfo.tex.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
12
95941
63cd1c7b5b2a Remove bug-lisp-manual@gnu.org, just use M-x report-emacs-bug.
Glenn Morris <rgm@gnu.org>
parents: 95035
diff changeset
13 * Report bugs in the Lisp Manual or in Emacs using M-x report-emacs-bug.
63cd1c7b5b2a Remove bug-lisp-manual@gnu.org, just use M-x report-emacs-bug.
Glenn Morris <rgm@gnu.org>
parents: 95035
diff changeset
14 To ask questions, use the newsgroup gnu.emacs.help.
84045
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
15
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
16 * The Emacs Lisp Reference Manual is quite large. It totals around
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
17 1100 pages in smallbook format; the info files total over
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
18 2.5 megabytes.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
19
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
20 * You can format this manual either for Info or for printing hardcopy
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
21 using TeX.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
22
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
23 * You can buy nicely printed copies from the Free Software Foundation.
95941
63cd1c7b5b2a Remove bug-lisp-manual@gnu.org, just use M-x report-emacs-bug.
Glenn Morris <rgm@gnu.org>
parents: 95035
diff changeset
24 Buying a manual from the Free Software Foundation helps support our GNU
63cd1c7b5b2a Remove bug-lisp-manual@gnu.org, just use M-x report-emacs-bug.
Glenn Morris <rgm@gnu.org>
parents: 95035
diff changeset
25 development work. See <http://shop.fsf.org/>.
84045
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
26
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
27 ** This distribution contains a Makefile that you can use with GNU Make.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
28 Otherwise, here are detailed instructions:
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
29
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
30 ** HARDCOPY: A copy of the version of `texinfo.tex' that formats this
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
31 manual is included in this distribution.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
32
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
33 The master file for formatting this manual for Tex is called
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
34 `elisp.texi'. It contains @include commands to include all the
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
35 chapters that make up the manual. In addition, `elisp.texi' has
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
36 the title page in a new format designed by Karl Berry, using the
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
37 @titlespec command.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
38
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
39 To create a DVI file with a sorted index, execute the following
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
40 commands in the shell:
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
41
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
42 % ./configure
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
43 % make index.texi
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
44 % make elisp.dvi
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
45
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
46 *** To create a DVI file with a permuted index, you may experiment
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
47 with `make-permuted-index'.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
48
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
49 ** To make an Info file, you need to install Texinfo, then run
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
50 `./configure' and `make info'. To install the Info files, run
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
51 `make install'.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
52
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
53
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
54 This file is part of GNU Emacs.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
55
95035
fde6f792a832 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
56 GNU Emacs is free software: you can redistribute it and/or modify
84045
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
57 it under the terms of the GNU General Public License as published by
95035
fde6f792a832 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
58 the Free Software Foundation, either version 3 of the License, or
fde6f792a832 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
59 (at your option) any later version.
84045
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
60
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
61 GNU Emacs is distributed in the hope that it will be useful,
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
62 but WITHOUT ANY WARRANTY; without even the implied warranty of
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
63 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
64 GNU General Public License for more details.
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
65
bea529b2b197 Move here from ../../lispref
Glenn Morris <rgm@gnu.org>
parents:
diff changeset
66 You should have received a copy of the GNU General Public License
95035
fde6f792a832 Switch to recommended form of GPLv3 permissions notice.
Glenn Morris <rgm@gnu.org>
parents: 87649
diff changeset
67 along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.