Checked emacs.texi

[gnu-emacs] / doc / emacs / emacs-xtra.texi

diff --git a/doc/emacs/emacs-xtra.texi b/doc/emacs/emacs-xtra.texi
index 3cc010dbdb6eb56cfabaa1ed633886ece774374a..208eb743de80d8625784db8c6845947df9a475a9 100644 (file)
--- 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
@@ -10,7 +11,7 @@
 @copying
 This manual describes specialized features of Emacs.
 
-Copyright @copyright{} 2004, 2005, 2006, 2007, 2008, 2009
+Copyright @copyright{} 2004-2012
 Free Software Foundation, Inc.
 
 @quotation
@@ -33,6 +34,8 @@ license to the document, as described in section 6 of the license.
 @end quotation
 @end copying
 
+@documentencoding ISO-8859-1
+
 @dircategory Emacs
 @direntry
 * Emacs-Xtra: (emacs-xtra).    Specialized Emacs features.
@@ -67,7 +70,7 @@ license to the document, as described in section 6 of the license.
 * Emerge::              A convenient way of merging two versions of a program.
 * Advanced VC Usage::   Advanced VC (version control) features.
 * Fortran::             Fortran mode and its special features.
-* MS-DOS::              Using Emacs on MS-DOS (otherwise known as @dfn{MS-DOG}).
+* MS-DOS::              Using Emacs on MS-DOS.
 @end iftex
 * Index::
 @end menu
@@ -82,12 +85,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
@@ -121,7 +138,3 @@ the Emacs manual.
 @printindex cp
 
 @bye
-
-@ignore
-   arch-tag: 75c33f13-32c6-41b6-9537-847a312e2e49
-@end ignore