summaryrefslogtreecommitdiff
path: root/doc/emacs/emacs-xtra.texi
blob: 2d511bffbc6db41454e68cb74a8c7e70e926a22d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
\input texinfo    @c -*-texinfo-*-
@comment %**start of header
@setfilename ../../info/emacs-xtra.info
@settitle Specialized Emacs Features
@include docstyle.texi
@c Merge all functions, variables, and keys into the concept index.
@syncodeindex fn cp
@syncodeindex vr cp
@syncodeindex ky cp
@comment %**end of header

@c This is a separate manual to avoid making the Emacs User manual too
@c large in print.  In the Info format, the chapters included below
@c are part of the Emacs User manual.

@copying
This manual describes specialized features of Emacs.

Copyright @copyright{} 2004--2021 Free Software Foundation, Inc.

@quotation
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with the Front-Cover Texts being ``A GNU Manual,''
and with the Back-Cover Texts as in (a) below.  A copy of the license
is included in the section entitled ``GNU Free Documentation License''.

(a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
modify this GNU manual.''
@end quotation
@end copying

@dircategory Emacs
@direntry
* Emacs-Xtra: (emacs-xtra).    Specialized Emacs features.
@end direntry

@titlepage
@title Specialized Emacs Features
@page
@vskip 0pt plus 1filll
@insertcopying
@end titlepage

@contents

@ifnottex
@node Top
@top Specialized Emacs Features

@insertcopying

@end ifnottex

@menu
* Introduction::        What documentation belongs here?
@iftex
* Picture Mode::        Editing pictures made up of characters using
                         the quarter-plane screen model.

* Non-File Buffers::    Auto Reverting non-file buffers.
* Subdir Switches::     Subdirectory switches in Dired.
* Advanced Calendar/Diary Usage:: Advanced Calendar/Diary customization.
* 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.
@end iftex
* GNU Free Documentation License::  The license for this documentation.
* Index::
@end menu

@node Introduction
@unnumbered Introduction

This manual contains detailed information about various features that
are too specialized to be included in the printed Emacs manual.  It is
intended to be readable by anyone having a basic knowledge of Emacs.
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.

@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 (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
the Emacs manual.

@iftex

@raisesections
@include picture-xtra.texi

@include arevert-xtra.texi

@include dired-xtra.texi

@include cal-xtra.texi

@include emerge-xtra.texi

@include vc-xtra.texi

@include fortran-xtra.texi

@include msdos-xtra.texi

@lowersections
@end iftex

@node GNU Free Documentation License
@appendix GNU Free Documentation License
@include doclicense.texi

@node Index
@unnumbered Index

@printindex cp

@bye