diff options
| author | Glenn Morris <rgm@gnu.org> | 2009-07-02 02:31:26 +0000 |
|---|---|---|
| committer | Glenn Morris <rgm@gnu.org> | 2009-07-02 02:31:26 +0000 |
| commit | 897f80939756ff7691984497baff9516f27d8259 (patch) | |
| tree | e1153b3ada32cff2519e1f34237c0aa942583b77 /doc/emacs/emacs-xtra.texi | |
| parent | e1fbeef1fbe4607abb1c6d8d02e7c875c03abb13 (diff) | |
(Introduction): Mention included in info Emacs manual.
Diffstat (limited to 'doc/emacs/emacs-xtra.texi')
| -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 3cc010dbdb..0450450fbc 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 |