lispref/README

   1 Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007
   2   Free Software Foundation, Inc.
   3 Copying and distribution of this file, with or without modification,
   4 are permitted provided the copyright notice and this notice are preserved.
   5
   6
   7 README for Edition 2.9 of the Emacs Lisp Reference Manual.
   8
   9 * This directory contains the texinfo source files for the Reference
  10 Manual, make-permuted-index, and the latest version of texinfo.tex,
  11 which handles forms that cannot be handled by the older versions of
  12 texinfo.tex.
  13
  14 * Report Lisp Manual bugs to bug-lisp-manual@gnu.org.  We don't read
  15 these bug reports until it's time for a new edition.  To report other
  16 Emacs bugs, use bug-gnu-emacs@gnu.org.  To ask questions, use the
  17 newsgroup gnu.emacs.help.
  18
  19 * The Emacs Lisp Reference Manual is quite large.  It totals around
  20 1100 pages in smallbook format; the info files total over
  21 2.5 megabytes.
  22
  23 * You can format this manual either for Info or for printing hardcopy
  24 using TeX.
  25
  26 * You can buy nicely printed copies from the Free Software Foundation.
  27 For info, send mail to gnu@gnu.org or phone 617-542-5942.  Buying a
  28 manual from the Free Software Foundation helps support our GNU
  29 development work.
  30
  31 ** This distribution contains a Makefile that you can use with GNU Make.
  32 Otherwise, here are detailed instructions:
  33
  34 ** HARDCOPY: A copy of the version of `texinfo.tex' that formats this
  35 manual is included in this distribution.
  36
  37 The master file for formatting this manual for Tex is called
  38 `elisp.texi'.  It contains @include commands to include all the
  39 chapters that make up the manual.  In addition, `elisp.texi' has
  40 the title page in a new format designed by Karl Berry, using the
  41 @titlespec command.
  42
  43 To create a DVI file with a sorted index, execute the following
  44 commands in the shell:
  45
  46 % ./configure
  47 % make index.texi
  48 % make elisp.dvi
  49
  50 *** To create a DVI file with a permuted index, you may experiment
  51 with `make-permuted-index'.
  52
  53 ** To make an Info file, you need to install Texinfo, then run
  54 `./configure' and `make info'.  To install the Info files, run
  55 `make install'.