Fix package.el handling of local variables on first line.
[emacs.git] / doc / emacs / emacs-xtra.texi
blob78cac7d8a10bc3a388c7a3a1da8c5f1b8877a73a
1 \input texinfo    @c -*-texinfo-*-
2 @comment %**start of header
3 @setfilename ../../info/emacs-xtra
4 @settitle Specialized Emacs Features
5 @c Merge all functions, variables, and keys into the concept index.
6 @syncodeindex fn cp
7 @syncodeindex vr cp
8 @syncodeindex ky cp
9 @comment %**end of header
11 @copying
12 This manual describes specialized features of Emacs.
14 Copyright @copyright{} 2004-2012 Free Software Foundation, Inc.
16 @quotation
17 Permission is granted to copy, distribute and/or modify this document
18 under the terms of the GNU Free Documentation License, Version 1.3 or
19 any later version published by the Free Software Foundation; with no
20 Invariant Sections, with the Front-Cover texts being ``A GNU
21 Manual,'' and with the Back-Cover Texts as in (a) below.  A copy of the
22 license is included in the section entitled ``GNU Free Documentation
23 License'' in the Emacs manual.
25 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
26 modify this GNU manual.  Buying copies from the FSF supports it in
27 developing GNU and promoting software freedom.''
29 This document is part of a collection distributed under the GNU Free
30 Documentation License.  If you want to distribute this document
31 separately from the collection, you can do so by adding a copy of the
32 license to the document, as described in section 6 of the license.
33 @end quotation
34 @end copying
36 @documentencoding ISO-8859-1
38 @dircategory Emacs
39 @direntry
40 * Emacs-Xtra: (emacs-xtra).    Specialized Emacs features.
41 @end direntry
43 @titlepage
44 @title Specialized Emacs Features
45 @page
46 @vskip 0pt plus 1filll
47 @insertcopying
48 @end titlepage
50 @contents
52 @ifnottex
53 @node Top
54 @top Specialized Emacs Features
56 @insertcopying
58 @end ifnottex
60 @menu
61 * Introduction::        What documentation belongs here?
62 @iftex
63 * Picture Mode::        Editing pictures made up of characters using 
64                          the quarter-plane screen model.
66 * Autorevert::          Auto Reverting non-file buffers.
67 * Subdir Switches::     Subdirectory switches in Dired.
68 * Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization.
69 * Emerge::              A convenient way of merging two versions of a program.
70 * Advanced VC Usage::   Advanced VC (version control) features.
71 * Fortran::             Fortran mode and its special features.
72 * MS-DOS::              Using Emacs on MS-DOS.
73 @end iftex
74 * Index::
75 @end menu
77 @node Introduction
78 @unnumbered Introduction
80 This manual contains detailed information about various features that
81 are too specialized to be included in the printed Emacs manual.  It is
82 intended to be readable by anyone having a basic knowledge of Emacs.
83 However, certain sections may be intended for a more specialized
84 audience, such as Elisp authors.  This should be clearly pointed out
85 at the beginning of these sections.
87 @c Note to authors - you need to be careful about cross-references to
88 @c topics in the Emacs manual.  As a printed document, the xtra files
89 @c are separate from the Emacs manual; but as an info document, they
90 @c are part of the Emacs manual.  Hence you need to use something like:
91 @c @iftex
92 @c @ref{Comparing Files,,, emacs, the Emacs Manual},
93 @c @end iftex
94 @c @ifnottex
95 @c @ref{Comparing Files},
96 @c @end ifnottex
98 Certain packages (or collections of related features) have their own
99 manuals, separate from the main Emacs manual.  This manual is
100 intended as a complement, rather than an alternative, to reading those
101 additional manuals.  In a nutshell, it is a collection of smaller
102 specialized features (or extra detail about standard features), too
103 small or too obscure to justify their own manual, or inclusion in the
104 printed Emacs manual.  The chapters in this manual are, however,
105 included (at the relevant places) in the main Emacs manual when it is
106 formatted as an Info document.
108 Sections intended specifically for Elisp programmers can follow the
109 style of the Elisp manual.  Other sections should follow the style of
110 the Emacs manual.
112 @iftex
114 @raisesections
115 @include picture-xtra.texi
117 @include arevert-xtra.texi
119 @include dired-xtra.texi
121 @include cal-xtra.texi
123 @include emerge-xtra.texi
125 @include vc-xtra.texi
127 @include fortran-xtra.texi
129 @include msdog-xtra.texi
131 @lowersections
132 @end iftex
134 @node Index
135 @unnumbered Index
137 @printindex cp
139 @bye