* emacs-lisp/trace.el (trace-function, trace-function-background): Doc fix.
[emacs.git] / doc / emacs / emacs-xtra.texi
blob40519e7e318f28f2ddb354ae96c309645bdbbe9b
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--2013 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 Manual,''
21 and with the Back-Cover Texts as in (a) below.  A copy of the license
22 is included in the section entitled ``GNU Free Documentation License''.
24 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
25 modify this GNU manual.''
26 @end quotation
27 @end copying
29 @documentencoding ISO-8859-1
31 @dircategory Emacs
32 @direntry
33 * Emacs-Xtra: (emacs-xtra).    Specialized Emacs features.
34 @end direntry
36 @titlepage
37 @title Specialized Emacs Features
38 @page
39 @vskip 0pt plus 1filll
40 @insertcopying
41 @end titlepage
43 @contents
45 @ifnottex
46 @node Top
47 @top Specialized Emacs Features
49 @insertcopying
51 @end ifnottex
53 @menu
54 * Introduction::        What documentation belongs here?
55 @iftex
56 * Picture Mode::        Editing pictures made up of characters using
57                          the quarter-plane screen model.
59 * Autorevert::          Auto Reverting non-file buffers.
60 * Subdir Switches::     Subdirectory switches in Dired.
61 * Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization.
62 * Emerge::              A convenient way of merging two versions of a program.
63 * Advanced VC Usage::   Advanced VC (version control) features.
64 * Fortran::             Fortran mode and its special features.
65 * MS-DOS::              Using Emacs on MS-DOS.
66 @end iftex
67 * GNU Free Documentation License::  The license for this documentation.
68 * Index::
69 @end menu
71 @node Introduction
72 @unnumbered Introduction
74 This manual contains detailed information about various features that
75 are too specialized to be included in the printed Emacs manual.  It is
76 intended to be readable by anyone having a basic knowledge of Emacs.
77 However, certain sections may be intended for a more specialized
78 audience, such as Elisp authors.  This should be clearly pointed out
79 at the beginning of these sections.
81 @c Note to authors - you need to be careful about cross-references to
82 @c topics in the Emacs manual.  As a printed document, the xtra files
83 @c are separate from the Emacs manual; but as an info document, they
84 @c are part of the Emacs manual.  Hence you need to use something like:
85 @c @iftex
86 @c @ref{Comparing Files,,, emacs, the Emacs Manual},
87 @c @end iftex
88 @c @ifnottex
89 @c @ref{Comparing Files},
90 @c @end ifnottex
92 Certain packages (or collections of related features) have their own
93 manuals, separate from the main Emacs manual.  This manual is
94 intended as a complement, rather than an alternative, to reading those
95 additional manuals.  In a nutshell, it is a collection of smaller
96 specialized features (or extra detail about standard features), too
97 small or too obscure to justify their own manual, or inclusion in the
98 printed Emacs manual.  The chapters in this manual are, however,
99 included (at the relevant places) in the main Emacs manual when it is
100 formatted as an Info document.
102 Sections intended specifically for Elisp programmers can follow the
103 style of the Elisp manual.  Other sections should follow the style of
104 the Emacs manual.
106 @iftex
108 @raisesections
109 @include picture-xtra.texi
111 @include arevert-xtra.texi
113 @include dired-xtra.texi
115 @include cal-xtra.texi
117 @include emerge-xtra.texi
119 @include vc-xtra.texi
121 @include fortran-xtra.texi
123 @include msdog-xtra.texi
125 @lowersections
126 @end iftex
128 @node GNU Free Documentation License
129 @appendix GNU Free Documentation License
130 @include doclicense.texi
132 @node Index
133 @unnumbered Index
135 @printindex cp
137 @bye