lispref/README

   1 README for Edition 2.0.1 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 * The Emacs Lisp Reference Manual is turning out bigger than we
   9 expected.  It totals over 750 pages when printed on 8.5 by 11 inch
  10 paper and the info files total almost two megabytes.
  11
  12 * You can format this manual either for Info or for printing hardcopy
  13 using TeX.
  14
  15 ** This distribution contains a Makefile that you can use with GNU Make.
  16 Otherwise, here are detailed instructions:
  17
  18 ** HARDCOPY: A copy of the version of `texinfo.tex' that formats this
  19 manual is included in this distribution.
  20
  21 The master file for formatting this manual for Tex is called
  22 `elisp.texi'.  It contains @include commands to include all the
  23 chapters that make up the manual.  In addition, `elisp.texi' has
  24 the title page in a new format designed by Karl Berry, using the
  25 @titlespec command.
  26
  27 To create a DVI file with a sorted index, execute the following
  28 commands in the shell:
  29
  30 % make index.texi
  31 % make elisp.dvi
  32
  33 *** To create a DVI file with a permuted index, you may experiment
  34 with `make-permuted-index'.
  35
  36 ** INFO: A copy of makeinfo.c that will format this manual for Info is
  37 included in this distribution.  This program is written in C and can
  38 be used separately from Emacs.  `makeinfo' produces much better error
  39 messages than the old `texinfo-format-buffer'.  You can run `makeinfo'
  40 it on the `elisp.texi' file.