view lispref/README @ 50435:2c804de1a942

(find-file-of-tag-noselect, find-file-of-tag): New helper functions. (snarf-tag-function): Doc string is changed. Explained about new optional argument, `use-explicit'. (etags-snarf-tag): Added one optional argument `use-explicit'. (file-of-tag-function): Doc string is changed. Explained about new optional argument, `relative'. (file-of-tag): Doc string is changed. Explained about new optional argument, `relative'. Pass `relative' to `file-of-tag-function'. (etags-file-of-tag): Added new argument `relative`. (list-tags): Set `buffer-read-only' to t after making the major mode apropos-mode. (etags-list-tags): Used `make-text-button' instead of `add-text-properties'. Used `snarf-tag-function', `goto-tag-location-function' and `find-file-of-tag' instead of `find-tag-other-window' (it's too simple). (find-tag-in-order): Used `find-file-of-tag-noselect' instead of `find-file'. (etags-tags-apropos): Used `find-file-of-tag-noselect' instead of `find-file'. Do not use `etags-goto-tag-location` directly; use `goto-tag-location-function' instead. Print relative file paths instead of complete ones in *Tags List* buffer, so lines in the buffer become shorter. (etags-tags-apropos-additional): Use `make-text-button' instead of `add-text-properties'.

README for Edition 2.8 of the Emacs Lisp Reference Manual.

* This directory contains the texinfo source files for the Reference
Manual, make-permuted-index, and the latest version of texinfo.tex,
which handles forms that cannot be handled by the older versions of
texinfo.tex.

* Report Lisp Manual bugs to [e-mail].  We don't read
these bug reports until it's time for a new edition.  To report other
Emacs bugs, use [e-mail].  To ask questions, use the
newsgroup gnu.emacs.help.

* The Emacs Lisp Reference Manual is quite large.  It totals around
980 pages in smallbook format; the info files total almost
2.5 megabytes.

* You can format this manual either for Info or for printing hardcopy
using TeX.

* You can buy nicely printed copies from the Free Software Foundation.
For info, send mail to [e-mail] or phone [phone].  Buying a
manual from the Free Software Foundation helps support our GNU
development work.

** This distribution contains a Makefile that you can use with GNU Make.
Otherwise, here are detailed instructions:

** HARDCOPY: A copy of the version of `texinfo.tex' that formats this
manual is included in this distribution.

The master file for formatting this manual for Tex is called
`elisp.texi'.  It contains @include commands to include all the
chapters that make up the manual.  In addition, `elisp.texi' has
the title page in a new format designed by Karl Berry, using the
@titlespec command.

To create a DVI file with a sorted index, execute the following
commands in the shell:

% ./configure
% make index.texi
% make elisp.dvi

*** To create a DVI file with a permuted index, you may experiment
with `make-permuted-index'.

** To make an Info file, you need to install Texinfo, then run
`./configure' and `make info'.  To install the Info files, run
`make install'.