view lispref/README @ 16969:436fd36233d1

Update copyright notice to reflect assignment to FSF and incorporation into Emacs. Attempt to load `timer'. (eldoc-idle-delay): Make defconst. (eldoc-minor-mode-string): Make defconst. (eldoc-argument-case): Make defconst. (eldoc-message-commands): Renamed from eldoc-mode-message-commands. All callers changed. Add `mouse-set-point' as a default candidate. (eldoc-use-idle-timer-p): New constant. (eldoc-timer): New variable. (eldoc-current-idle-delay): New variable. (eldoc-schedule-timer): New function. (eldoc-mode): Use idle timers if supported. (eldoc-add-command): Provide completion on interactive commands only, not all bound functions. (eldoc-print-current-symbol-info): Renamed from eldoc-mode-print-current-symbol-info. All callers changed. Check whether using idle timers or being run from post-command hooks. Use `executing-kbd-macro' instead of `executing-macro'. (eldoc-print-fnsym-args): Don't make interactive. Cache current symbol name in eldoc-last-data; it was forgetting to do this previously. If subr args cannot be determined, show single-line docstring for it instead. (eldoc-docstring-message): New function. (eldoc-print-docstring): New function. (eldoc-print-var-docstring): Use them. (eldoc-function-argstring-from-docstring-method-table): New constant. (eldoc-function-argstring-from-docstring): Use it.

README for Edition 2.4 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.  Also, it contains makeinfo.c.

* 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
700 pages in smallbook format; the info files total almost two
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:

% make index.texi
% make elisp.dvi

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

** INFO: A copy of makeinfo.c that will format this manual for Info is
included in this distribution.  This program is written in C and can
be used separately from Emacs.  `makeinfo' produces much better error
messages than the old `texinfo-format-buffer'.  You can run `makeinfo'
it on the `elisp.texi' file.