diff options
author | Glenn Morris <rgm@gnu.org> | 2009-07-02 02:25:23 +0000 |
---|---|---|
committer | Glenn Morris <rgm@gnu.org> | 2009-07-02 02:25:23 +0000 |
commit | fa84122467c4276df4b149e78a87cc6b23e6766e (patch) | |
tree | 0de7d38d4f758884e288b76ea32c53f7f4b97ebb | |
parent | 47869be8d821b9490f2af51b5e1401e3357f6bfc (diff) | |
download | emacs-fa84122467c4276df4b149e78a87cc6b23e6766e.tar.gz |
(Introduction): Mention included in info Emacs manual.
-rw-r--r-- | doc/emacs/emacs-xtra.texi | 25 |
1 files changed, 20 insertions, 5 deletions
diff --git a/doc/emacs/emacs-xtra.texi b/doc/emacs/emacs-xtra.texi index 3cc010dbdb6..0450450fbcd 100644 --- a/doc/emacs/emacs-xtra.texi +++ b/doc/emacs/emacs-xtra.texi @@ -2,6 +2,7 @@ @comment %**start of header @setfilename ../../info/emacs-xtra @settitle Specialized Emacs Features +@c Merge all functions, variables, and keys into the concept index. @syncodeindex fn cp @syncodeindex vr cp @syncodeindex ky cp @@ -82,12 +83,26 @@ However, certain sections may be intended for a more specialized audience, such as Elisp authors. This should be clearly pointed out at the beginning of these sections. -Certain packages, or collections of related features, have their own -manuals, separate from the main Emacs User's manual. This manual is +@c Note to authors - you need to be careful about cross-references to +@c topics in the Emacs manual. As a printed document, the xtra files +@c are separate from the Emacs manual; but as an info document, they +@c are part of the Emacs manual. Hence you need to use something like: +@c @iftex +@c @ref{Comparing Files,,, emacs, the Emacs Manual}, +@c @end iftex +@c @ifnottex +@c @ref{Comparing Files}, +@c @end ifnottex + +Certain packages (or collections of related features) have their own +manuals, separate from the main Emacs manual. This manual is intended as a complement, rather than an alternative, to reading those -additional manuals; in a nutshell, it is a collection of smaller -specialized features, too small or too obscure to justify their own -manual. +additional manuals. In a nutshell, it is a collection of smaller +specialized features (or extra detail about standard features), too +small or too obscure to justify their own manual, or inclusion in the +printed Emacs manual. The chapters in this manual are, however, +included (at the relevant places) in the main Emacs manual when it is +formatted as an Info document. Sections intended specifically for Elisp programmers can follow the style of the Elisp manual. Other sections should follow the style of |