lispref/README

   1 README for Edition 2.3 of the Emacs Lisp Reference Manual.
   2
   3 * This directory contains the texinfo source files for the Reference
   4 Manual, make-permuted-index, and the latest version of texinfo.tex,
   5 which handles forms that cannot be handled by the older versions of
   6 texinfo.tex.  Also, it contains makeinfo.c.
   7
   8 * Report Lisp Manual bugs to bug-lisp-manual@prep.ai.mit.edu.  We
   9 don't read these bug reports until it's time for a new edition.  To
  10 report other Emacs bugs, use bug-gnu-emacs@prep.ai.mit.edu.
  11 To ask questions, use the newsgroup gnu.emacs.help.
  12
  13 * The Emacs Lisp Reference Manual is quite large.  It totals around
  14 700 pages in smallbook format; the info files total almost two
  15 megabytes.
  16
  17 * You can format this manual either for Info or for printing hardcopy
  18 using TeX.
  19
  20 * You can buy nicely printed copies from the Free Software Foundation.
  21 For info, send mail to gnu@prep.ai.mit.edu or phone 617-876-3296.
  22 Buying a manual from the Free Software Foundation helps support our
  23 GNU development work.
  24
  25 ** This distribution contains a Makefile that you can use with GNU Make.
  26 Otherwise, here are detailed instructions:
  27
  28 ** HARDCOPY: A copy of the version of `texinfo.tex' that formats this
  29 manual is included in this distribution.
  30
  31 The master file for formatting this manual for Tex is called
  32 `elisp.texi'.  It contains @include commands to include all the
  33 chapters that make up the manual.  In addition, `elisp.texi' has
  34 the title page in a new format designed by Karl Berry, using the
  35 @titlespec command.
  36
  37 To create a DVI file with a sorted index, execute the following
  38 commands in the shell:
  39
  40 % make index.texi
  41 % make elisp.dvi
  42
  43 *** To create a DVI file with a permuted index, you may experiment
  44 with `make-permuted-index'.
  45
  46 ** INFO: A copy of makeinfo.c that will format this manual for Info is
  47 included in this distribution.  This program is written in C and can
  48 be used separately from Emacs.  `makeinfo' produces much better error
  49 messages than the old `texinfo-format-buffer'.  You can run `makeinfo'
  50 it on the `elisp.texi' file.