Merge from emacs--rel--22
[bpt/emacs.git] / doc / lispref / README
1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
2 Free Software Foundation, Inc.
3 See the end of the file for license conditions.
4
5
6 README for Edition 2.9 of the Emacs Lisp Reference Manual.
7
8 * This directory contains the texinfo source files for the Reference
9 Manual, make-permuted-index, and the latest version of texinfo.tex,
10 which handles forms that cannot be handled by the older versions of
11 texinfo.tex.
12
13 * Report Lisp Manual bugs to bug-lisp-manual@gnu.org. We don't read
14 these bug reports until it's time for a new edition. To report other
15 Emacs bugs, use bug-gnu-emacs@gnu.org. To ask questions, use the
16 newsgroup gnu.emacs.help.
17
18 * The Emacs Lisp Reference Manual is quite large. It totals around
19 1100 pages in smallbook format; the info files total over
20 2.5 megabytes.
21
22 * You can format this manual either for Info or for printing hardcopy
23 using TeX.
24
25 * You can buy nicely printed copies from the Free Software Foundation.
26 For info, send mail to gnu@gnu.org or phone 617-542-5942. Buying a
27 manual from the Free Software Foundation helps support our GNU
28 development work.
29
30 ** This distribution contains a Makefile that you can use with GNU Make.
31 Otherwise, here are detailed instructions:
32
33 ** HARDCOPY: A copy of the version of `texinfo.tex' that formats this
34 manual is included in this distribution.
35
36 The master file for formatting this manual for Tex is called
37 `elisp.texi'. It contains @include commands to include all the
38 chapters that make up the manual. In addition, `elisp.texi' has
39 the title page in a new format designed by Karl Berry, using the
40 @titlespec command.
41
42 To create a DVI file with a sorted index, execute the following
43 commands in the shell:
44
45 % ./configure
46 % make index.texi
47 % make elisp.dvi
48
49 *** To create a DVI file with a permuted index, you may experiment
50 with `make-permuted-index'.
51
52 ** To make an Info file, you need to install Texinfo, then run
53 `./configure' and `make info'. To install the Info files, run
54 `make install'.
55
56 \f
57 This file is part of GNU Emacs.
58
59 GNU Emacs is free software; you can redistribute it and/or modify
60 it under the terms of the GNU General Public License as published by
61 the Free Software Foundation; either version 3, or (at your option)
62 any later version.
63
64 GNU Emacs is distributed in the hope that it will be useful,
65 but WITHOUT ANY WARRANTY; without even the implied warranty of
66 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
67 GNU General Public License for more details.
68
69 You should have received a copy of the GNU General Public License
70 along with GNU Emacs; see the file COPYING. If not, write to the
71 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
72 Boston, MA 02110-1301, USA.