GNU emacs manual 2

GNU Emacs Manual



GNU Emacs Manual
Seventeenth Edition, Updated for Emacs Version 24.2.

Richard Stallman et al.


This is the Seventeenth edition of the GNU Emacs Manual,
updated for Emacs version 24.2.
Copyright c 1985-1987, 1993-2012 Free Software Foundation, Inc.
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
the Invariant Sections being “The GNU Manifesto,” “Distribution” and
“GNU GENERAL PUBLIC LICENSE,” 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. Buying copies from the FSF supports it in
developing GNU and promoting software freedom.”

Published by the Free Software Foundation
51 Franklin Street, Fifth Floor
Boston, MA 02110-1301 USA
ISBN 978-0-9831592-4-7

Cover art by Etienne Suvasa; cover design by Matt Lee.

Did Amazon sell you this book?

Either way, thank you for buying this title from GNU Press. GNU Press is the publishing outfit of the Free Software Foundation, a nonprofit organization in Boston,
Massachusetts.
While we appreciate your purchase, we hope that in the future you will buy directly
from us at . We list our books on Amazon so more people
can find them, but selling books on Amazon is something we would rather not do,
because:
• Amazon is bad for small publishers. Amazon requires that we sell them our
books at a 55% discount—and pay for their shipping. The standard bookstore
pays for its own shipping and only asks for a 40% discount. Amazon cuts
better deals with larger publishers, and finances those deals by forcing steep
discounts from smaller publishers.
• Amazon is pushing digital restrictions management (DRM) on ebooks,
which is bad for everyone who reads books. Using this DRM, Amazon can
control how people read, and can even delete readers’ books (as they did
with copies of 1984). For more information about the dangers of DRM,
please see "The Right to Read" and "The Danger of E-books" by Richard
Stallman at and
and the
website />Digital versions of GNU books can downloaded from and
. All GNU Press books are distributed without DRM.
Thank you again for your purchase. Please support us and other small publishers
by not buying paper or electronic books from Amazon in the future.


i

Short Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1 The Organization of the Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
2 Characters, Keys and Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
3 Entering and Exiting Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
4 Basic Editing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
5 The Minibuffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
6 Running Commands by Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
7 Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
8 The Mark and the Region . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
9 Killing and Moving Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
10 Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
11 Controlling the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
12 Searching and Replacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
13 Commands for Fixing Typos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
14 Keyboard Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
15 File Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
16 Using Multiple Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
17 Multiple Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
18 Frames and Graphical Displays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
19 International Character Set Support . . . . . . . . . . . . . . . . . . . . . . . . 180
20 Major and Minor Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
21 Indentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
22 Commands for Human Languages . . . . . . . . . . . . . . . . . . . . . . . . . . 214
23 Editing Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
24 Compiling and Testing Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . 271
25 Maintaining Large Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
26 Abbrevs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322

27 Dired, the Directory Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
28 The Calendar and the Diary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 346


ii
29 Sending Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30 Reading Mail with Rmail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31 Miscellaneous Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
32 Emacs Lisp Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33 Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34 Dealing with Common Problems . . . . . . . . . . . . . . . . . . . . . . . . . . . .
A GNU GENERAL PUBLIC LICENSE . . . . . . . . . . . . . . . . . . . . . . .
B GNU Free Documentation License . . . . . . . . . . . . . . . . . . . . . . . . . .
C Command Line Arguments for Emacs Invocation . . . . . . . . . . . .
D X Options and Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
E Emacs 23 Antinews . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
F Emacs and Mac OS / GNUstep . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
G Emacs and Microsoft Windows/MS-DOS . . . . . . . . . . . . . . . . . . .
The GNU Manifesto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Key (Character) Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command and Function Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Variable Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Concept Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

367
376
397
430
434

468
484
496
505
521
529
531
535
546
555
580
590
604
612


iii

Table of Contents
Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Distribution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
1

The Organization of the Screen . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
1.1
1.2
1.3

1.4

2

Characters, Keys and Commands . . . . . . . . . . . . . . . . . . . . . . . 11
2.1
2.2
2.3

3

Kinds of User Input . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Keys and Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Entering and Exiting Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
3.1
3.2

4

Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
The Echo Area. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
The Mode Line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
The Menu Bar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Entering Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Exiting Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Basic Editing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

4.1
4.2
4.3
4.4
4.5
4.6
4.7
4.8
4.9
4.10
4.11

Inserting Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Changing the Location of Point . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Erasing Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Undoing Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Blank Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Continuation Lines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Cursor Position Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Numeric Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Repeating a Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17
18
20
21
22
22

22
23
23
25
26


iv

5

The Minibuffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
5.1
5.2
5.3

Minibuffers for File Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Editing in the Minibuffer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Completion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.1 Completion Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.2 Completion Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.3 Completion Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.3.4 How Completion Alternatives Are Chosen . . . . . . . . . . . . . . . . . . . . . . .
5.3.5 Completion Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.4 Minibuffer History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.5 Repeating Minibuffer Commands. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5.6 Entering passwords . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

6
7

Running Commands by Name . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
7.1
7.2
7.3
7.4
7.5
7.6
7.7
7.8
7.9

8

27
28
29
29
30
31
32
33
34
35
36

Documentation for a Key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Help by Command or Variable Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Apropos . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Help Mode Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keyword Search for Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Help for International Language Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Other Help Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Help Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Help on Active Text and Tooltips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

40
40
41
43
43
44
44
45
46

The Mark and the Region. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
8.1
8.2
8.3
8.4
8.5
8.6
8.7

Setting the Mark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Commands to Mark Textual Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Operating on the Region . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Mark Ring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

The Global Mark Ring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Shift Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Disabling Transient Mark Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

47
49
50
51
51
52
52


v

9

Killing and Moving Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54
9.1

Deletion and Killing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.1.1 Deletion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.1.2 Killing by Lines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.1.3 Other Kill Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.1.4 Options for Killing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.2 Yanking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.2.1 The Kill Ring. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.2.2 Yanking Earlier Kills . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.2.3 Appending Kills . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.3 “Cut and Paste” Operations on Graphical Displays . . . . . . . . . . . . . . . . . . .

9.3.1 Using the Clipboard . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.3.2 Cut and Paste with Other Window Applications . . . . . . . . . . . . . . . .
9.3.3 Secondary Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.4 Accumulating Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.5 Rectangles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9.6 CUA Bindings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

10

Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
10.1
10.2
10.3
10.4
10.5
10.6
10.7

11

54
54
55
56
56
57
57
58
58
59

59
60
61
61
63
64

Saving Positions in Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Saving Text in Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Saving Rectangles in Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Saving Window Configurations in Registers . . . . . . . . . . . . . . . . . . . . . . . . .
Keeping Numbers in Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Keeping File Names in Registers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Bookmarks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

66
66
67
67
68
68
68

Controlling the Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
11.1
11.2
11.3
11.4
11.5
11.6

11.7
11.8
11.9
11.10
11.11
11.12
11.13
11.14
11.15
11.16
11.17

Scrolling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Recentering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Automatic Scrolling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Horizontal Scrolling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Narrowing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
View Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Follow Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Text Faces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Colors for Faces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Standard Faces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Text Scale . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Font Lock mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Interactive Highlighting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Window Fringes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying Boundaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Useless Whitespace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selective Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

70
71
72
73
74
75
75
75
76
77
79
80
81
83
83
84
85


vi
11.18
11.19
11.20
11.21
11.22
11.23

12

Optional Mode Line Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

How Text Is Displayed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Displaying the Cursor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Line Truncation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Visual Line Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Customization of Display . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

85
87
88
89
89
90

Searching and Replacement. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
12.1 Incremental Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
12.1.1 Basics of Incremental Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
12.1.2 Repeating Incremental Search. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
12.1.3 Errors in Incremental Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
12.1.4 Special Input for Incremental Search . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
12.1.5 Isearch Yanking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
12.1.6 Scrolling During Incremental Search . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
12.1.7 Searching the Minibuffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
12.2 Nonincremental Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
12.3 Word Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
12.4 Regular Expression Search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
12.5 Syntax of Regular Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 97
12.6 Backslash in Regular Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
12.7 Regular Expression Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
12.8 Searching and Case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
12.9 Replacement Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

12.9.1 Unconditional Replacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
12.9.2 Regexp Replacement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
12.9.3 Replace Commands and Case . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
12.9.4 Query Replace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
12.10 Other Search-and-Loop Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107

13

Commands for Fixing Typos . . . . . . . . . . . . . . . . . . . . . . . . . . 110
13.1
13.2
13.3
13.4

14

Undo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Transposing Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Case Conversion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Checking and Correcting Spelling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

110
111
112
112

Keyboard Macros . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
14.1
14.2
14.3

14.4
14.5
14.6
14.7

Basic Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Keyboard Macro Ring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
The Keyboard Macro Counter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Executing Macros with Variations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Naming and Saving Keyboard Macros. . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Editing a Keyboard Macro. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Stepwise Editing a Keyboard Macro . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

116
118
118
120
121
122
122


vii

15

File Handling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
15.1 File Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.2 Visiting Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3 Saving Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

15.3.1 Commands for Saving Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3.2 Backup Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3.2.1 Single or Numbered Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3.2.2 Automatic Deletion of Backups . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3.2.3 Copying vs. Renaming. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3.3 Customizing Saving of Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3.4 Protection against Simultaneous Editing . . . . . . . . . . . . . . . . . . . . . .
15.3.5 Shadowing Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.3.6 Updating Time Stamps Automatically . . . . . . . . . . . . . . . . . . . . . . . .
15.4 Reverting a Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.5 Auto-Saving: Protection Against Disasters . . . . . . . . . . . . . . . . . . . . . . . . .
15.5.1 Auto-Save Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.5.2 Controlling Auto-Saving . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.5.3 Recovering Data from Auto-Saves. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.6 File Name Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.7 File Directories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.8 Comparing Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.9 Diff Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.10 Miscellaneous File Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.11 Accessing Compressed Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.12 File Archives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.13 Remote Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.14 Quoted File Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.15 File Name Cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.16 Convenience Features for Finding Files. . . . . . . . . . . . . . . . . . . . . . . . . . . .
15.17 Filesets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

16

124

125
128
128
130
130
131
132
132
133
134
135
135
136
136
137
137
138
139
140
141
143
144
144
145
146
147
148
148

Using Multiple Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150

16.1 Creating and Selecting Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.2 Listing Existing Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.3 Miscellaneous Buffer Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.4 Killing Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.5 Operating on Several Buffers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.6 Indirect Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.7 Convenience Features and Customization of Buffer Handling . . . . . . .
16.7.1 Making Buffer Names Unique . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
16.7.2 Switching Between Buffers using Substrings . . . . . . . . . . . . . . . . . . .
16.7.3 Customizing Buffer Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

150
152
152
153
154
156
157
157
158
158


viii

17

Multiple Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 159
17.1 Concepts of Emacs Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17.2 Splitting Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

17.3 Using Other Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17.4 Displaying in Another Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17.5 Deleting and Rearranging Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17.6 Displaying a Buffer in a Window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17.6.1 How display-buffer works . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
17.7 Convenience Features for Window Handling . . . . . . . . . . . . . . . . . . . . . . . .

18

Frames and Graphical Displays . . . . . . . . . . . . . . . . . . . . . . . 165
18.1
18.2
18.3
18.4
18.5
18.6
18.7
18.8
18.9
18.10
18.11
18.12
18.13
18.14
18.15
18.16
18.17
18.18
18.19
18.20

19

159
159
160
161
162
163
163
164

Mouse Commands for Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mouse Commands for Words and Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Following References with the Mouse. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mouse Clicks for Menus. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mode Line Mouse Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Creating Frames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Frame Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fonts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Speedbar Frames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Multiple Displays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Frame Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Scroll Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Drag and Drop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Menu Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tool Bars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using Dialog Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tooltips . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mouse Avoidance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Non-Window Terminals. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Using a Mouse in Text Terminals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

165
167
167
168
169
169
170
171
174
175
175
176
176
176
177
177
178
178
179
179

International Character Set Support . . . . . . . . . . . . . . . . . 180
19.1
19.2
19.3
19.4
19.5

19.6
19.7
19.8
19.9
19.10
19.11
19.12

Introduction to International Character Sets . . . . . . . . . . . . . . . . . . . . . . .
Disabling Multibyte Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Language Environments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Input Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Selecting an Input Method . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Coding Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Recognizing Coding Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specifying a File’s Coding System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Choosing Coding Systems for Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specifying a Coding System for File Text . . . . . . . . . . . . . . . . . . . . . . . . .
Coding Systems for Interprocess Communication . . . . . . . . . . . . . . . . . .
Coding Systems for File Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

180
182
183
185
186
188
190
192
192

193
194
195


ix
19.13
19.14
19.15
19.16
19.17
19.18
19.19
19.20

20

Major Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
Minor Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 205
Choosing File Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 207

Indentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 210
21.1
21.2
21.3
21.4

22

196

197
198
199
200
200
202
202

Major and Minor Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 204
20.1
20.2
20.3

21

Coding Systems for Terminal I/O . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Fontsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Defining fontsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Modifying Fontsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Undisplayable Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Unibyte Editing Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Charsets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Bidirectional Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Indentation Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tab Stops . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Tabs vs. Spaces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Convenience Features for Indentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

210

211
212
212

Commands for Human Languages . . . . . . . . . . . . . . . . . . . . 214
22.1 Words . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.2 Sentences . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.3 Paragraphs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.4 Pages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.5 Filling Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.5.1 Auto Fill Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.5.2 Explicit Fill Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.5.3 The Fill Prefix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.5.4 Adaptive Filling . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.6 Case Conversion Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.7 Text Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.8 Outline Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.8.1 Format of Outlines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.8.2 Outline Motion Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.8.3 Outline Visibility Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.8.4 Viewing One Outline in Multiple Views . . . . . . . . . . . . . . . . . . . . . . .
22.8.5 Folding Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.9 Org Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.9.1 Org as an organizer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.9.2 Org as an authoring system. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.10 TEX Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.10.1 TEX Editing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.10.2 LaTEX Editing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.10.3 TEX Printing Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

214
215
216
217
218
218
219
220
222
223
223
224
225
226
226
228
228
229
230
230
231
232
233
233


x
22.10.4 TEX Mode Miscellany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.11 SGML and HTML Modes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.12 Nroff Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

22.13 Enriched Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.13.1 Enriched Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.13.2 Hard and Soft Newlines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.13.3 Editing Format Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.13.4 Faces in Enriched Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.13.5 Indentation in Enriched Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.13.6 Justification in Enriched Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.13.7 Setting Other Text Properties . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.14 Editing Text-based Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.14.1 What is a Text-based Table? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.14.2 Creating a Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.14.3 Table Recognition . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.14.4 Commands for Table Cells . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.14.5 Cell Justification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.14.6 Table Rows and Columns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.14.7 Converting Between Plain Text and Tables . . . . . . . . . . . . . . . . . .
22.14.8 Table Miscellany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
22.15 Two-Column Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

23

235
236
237
237
238
238
239
239
240

241
241
241
242
243
243
244
244
245
245
246
247

Editing Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
23.1 Major Modes for Programming Languages . . . . . . . . . . . . . . . . . . . . . . . . .
23.2 Top-Level Definitions, or Defuns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.2.1 Left Margin Convention . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.2.2 Moving by Defuns . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.2.3 Imenu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.2.4 Which Function Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.3 Indentation for Programs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.3.1 Basic Program Indentation Commands. . . . . . . . . . . . . . . . . . . . . . . .
23.3.2 Indenting Several Lines . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.3.3 Customizing Lisp Indentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.3.4 Commands for C Indentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.3.5 Customizing C Indentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.4 Commands for Editing with Parentheses . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.4.1 Expressions with Balanced Parentheses . . . . . . . . . . . . . . . . . . . . . . .
23.4.2 Moving in the Parenthesis Structure . . . . . . . . . . . . . . . . . . . . . . . . . .
23.4.3 Matching Parentheses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

23.5 Manipulating Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.5.1 Comment Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.5.2 Multiple Lines of Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.5.3 Options Controlling Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.6 Documentation Lookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.6.1 Info Documentation Lookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.6.2 Man Page Lookup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

249
250
250
251
251
252
252
252
253
254
254
255
256
256
257
258
258
259
260
261
261
262

262


xi
23.6.3 Emacs Lisp Documentation Lookup . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.7 Hideshow minor mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.8 Completion for Symbol Names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.9 Glasses minor mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.10 Semantic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.11 Other Features Useful for Editing Programs . . . . . . . . . . . . . . . . . . . . . . .
23.12 C and Related Modes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.12.1 C Mode Motion Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.12.2 Electric C Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.12.3 Hungry Delete Feature in C . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.12.4 Other Commands for C Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
23.13 Asm Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

24

263
263
264
264
265
265
266
266
267
267
268

270

Compiling and Testing Programs . . . . . . . . . . . . . . . . . . . . . 271
24.1 Running Compilations under Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.2 Compilation Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.3 Subshells for Compilation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.4 Searching with Grep under Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.5 Finding Syntax Errors On The Fly. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6 Running Debuggers Under Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.1 Starting GUD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.2 Debugger Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.3 Commands of GUD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.4 GUD Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.5 GDB Graphical Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.5.1 GDB User Interface Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.5.2 Source Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.5.3 Breakpoints Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.5.4 Threads Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.5.5 Stack Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.5.6 Other GDB Buffers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.5.7 Watch Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.6.5.8 Multithreaded Debugging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.7 Executing Lisp Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.8 Libraries of Lisp Code for Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.9 Evaluating Emacs Lisp Expressions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.10 Lisp Interaction Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
24.11 Running an External Lisp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

271
272

274
275
276
276
276
277
278
280
281
281
282
282
283
284
284
285
286
287
287
288
290
290


xii

25

Maintaining Large Programs . . . . . . . . . . . . . . . . . . . . . . . . . . 292
25.1 Version Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

25.1.1 Introduction to Version Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.1.1 Understanding the problems it addresses . . . . . . . . . . . . . . . . .
25.1.1.2 Supported Version Control Systems . . . . . . . . . . . . . . . . . . . . . .
25.1.1.3 Concepts of Version Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.1.4 Merge-based vs lock-based Version Control . . . . . . . . . . . . . .
25.1.1.5 Changeset-based vs File-based Version Control . . . . . . . . . . .
25.1.1.6 Decentralized vs Centralized Repositories . . . . . . . . . . . . . . . .
25.1.1.7 Types of Log File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.2 Version Control and the Mode Line . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.3 Basic Editing under Version Control . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.3.1 Basic Version Control with Merging . . . . . . . . . . . . . . . . . . . . .
25.1.3.2 Basic Version Control with Locking . . . . . . . . . . . . . . . . . . . . . .
25.1.3.3 Advanced Control in C-x v v . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.4 Features of the Log Entry Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.5 Registering a File for Version Control . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.6 Examining And Comparing Old Revisions . . . . . . . . . . . . . . . . . . . .
25.1.7 VC Change Log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.8 Undoing Version Control Actions . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.9 VC Directory Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.9.1 The VC Directory Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.9.2 VC Directory Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.10 Version Control Branches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.10.1 Switching between Branches . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.10.2 Pulling Changes into a Branch . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.10.3 Merging Branches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.1.10.4 Creating New Branches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.2 Change Logs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.2.1 Change Log Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.2.2 Format of ChangeLog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.3 Tags Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

25.3.1 Source File Tag Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.3.2 Creating Tags Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.3.3 Etags Regexps. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.3.4 Selecting a Tags Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.3.5 Finding a Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.3.6 Searching and Replacing with Tags Tables . . . . . . . . . . . . . . . . . . . .
25.3.7 Tags Table Inquiries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
25.4 Emacs Development Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

292
292
292
293
293
294
295
295
295
296
296
297
298
298
299
300
300
302
304
304
305

305
307
307
308
308
309
309
310
310
311
312
314
315
317
317
318
319
320


xiii

26

Abbrevs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
26.1
26.2
26.3
26.4
26.5

26.6
26.7

27

322
322
323
324
325
326
327

Dired, the Directory Editor . . . . . . . . . . . . . . . . . . . . . . . . . . . 329
27.1
27.2
27.3
27.4
27.5
27.6
27.7
27.8
27.9
27.10
27.11
27.12
27.13
27.14
27.15
27.16

27.17
27.18

28

Abbrev Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Defining Abbrevs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Controlling Abbrev Expansion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Examining and Editing Abbrevs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Saving Abbrevs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Dynamic Abbrev Expansion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Customizing Dynamic Abbreviation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Entering Dired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Navigation in the Dired Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Deleting Files with Dired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Flagging Many Files at Once . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Visiting Files in Dired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Dired Marks vs. Flags . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Operating on Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Shell Commands in Dired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Transforming File Names in Dired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
File Comparison with Dired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Subdirectories in Dired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Moving Over Subdirectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Hiding Subdirectories . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Updating the Dired Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Dired and find . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Editing the Dired Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Viewing Image Thumbnails in Dired . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Other Dired Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

329
330
330
331
332
333
335
337
338
339
339
340
340
341
342
343
343
344

The Calendar and the Diary . . . . . . . . . . . . . . . . . . . . . . . . . . 346
28.1 Movement in the Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.1.1 Motion by Standard Lengths of Time . . . . . . . . . . . . . . . . . . . . . . . . .
28.1.2 Beginning or End of Week, Month or Year . . . . . . . . . . . . . . . . . . . .
28.1.3 Specified Dates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.2 Scrolling in the Calendar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.3 Counting Days . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.4 Miscellaneous Calendar Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.5 Writing Calendar Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

28.6 Holidays . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.7 Times of Sunrise and Sunset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.8 Phases of the Moon. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.9 Conversion To and From Other Calendars . . . . . . . . . . . . . . . . . . . . . . . . . .
28.9.1 Supported Calendar Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.9.2 Converting To Other Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.9.3 Converting From Other Calendars . . . . . . . . . . . . . . . . . . . . . . . . . . . .

346
346
347
347
348
348
349
349
351
352
353
353
354
355
356


xiv
28.9.4 Converting from the Mayan Calendar . . . . . . . . . . . . . . . . . . . . . . . . .
28.10 The Diary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.10.1 Displaying the Diary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.10.2 The Diary File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

28.10.3 Date Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.10.4 Commands to Add to the Diary . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.10.5 Special Diary Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.11 Appointments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.12 Importing and Exporting Diary Entries . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.13 Daylight Saving Time . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
28.14 Summing Time Intervals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

29

Sending Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 367
29.1 The Format of the Mail Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.2 Mail Header Fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.3 Mail Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.4 Mail Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.4.1 Mail Sending . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.4.2 Mail Header Editing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.4.3 Citing Mail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.4.4 Mail Miscellany . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.5 Mail Signature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.6 Mail Amusements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
29.7 Mail-Composition Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

30

357
358
359
360
360

361
362
364
364
365
366

367
368
370
370
370
372
373
373
374
374
375

Reading Mail with Rmail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 376
30.1 Basic Concepts of Rmail . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.2 Scrolling Within a Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.3 Moving Among Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.4 Deleting Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.5 Rmail Files and Inboxes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.6 Multiple Rmail Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.7 Copying Messages Out to Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.8 Labels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.9 Rmail Attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.10 Sending Replies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

30.11 Summaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.11.1 Making Summaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.11.2 Editing in Summaries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.12 Sorting the Rmail File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.13 Display of Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.14 Rmail and Coding Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.15 Editing Within a Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.16 Digest Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
30.17 Reading Rot13 Messages. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

376
376
377
378
379
380
381
383
384
385
386
387
388
390
391
392
392
393
393

xv
30.18 movemail program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 393
30.19 Retrieving Mail from Remote Mailboxes . . . . . . . . . . . . . . . . . . . . . . . . . . 395
30.20 Retrieving Mail from Local Mailboxes in Various Formats . . . . . . . . . 396

31

Miscellaneous Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
31.1 Gnus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.1.1 Gnus Buffers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.1.2 When Gnus Starts Up . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.1.3 Using the Gnus Group Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.1.4 Using the Gnus Summary Buffer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.2 Document Viewing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.2.1 DocView Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.2.2 DocView Searching . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.2.3 DocView Slicing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.2.4 DocView Conversion. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3 Running Shell Commands from Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.1 Single Shell Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.2 Interactive Subshell. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.3 Shell Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.4 Shell Prompts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.5 Shell Command History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.5.1 Shell History Ring . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.5.2 Shell History Copying . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.5.3 Shell History References . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.6 Directory Tracking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.7 Shell Mode Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

31.3.8 Emacs Terminal Emulator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.9 Term Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.10 Remote Host Shell . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.3.11 Serial Terminal . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.4 Using Emacs as a Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.4.1 Invoking emacsclient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.4.2 emacsclient Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.5 Printing Hard Copies . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.5.1 PostScript Hardcopy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.5.2 Variables for PostScript Hardcopy . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.5.3 Printing Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.6 Sorting Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.7 Editing Binary Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.8 Saving Emacs Sessions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.9 Recursive Editing Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.10 Emulation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.11 Hyperlinking and Navigation Features . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.11.1 Following URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.11.2 Activating URLs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
31.11.3 Finding Files and URLs at Point . . . . . . . . . . . . . . . . . . . . . . . . . . . .

397
397
397
398
399
399
400
400
400

401
401
402
403
403
406
407
407
408
408
409
409
410
411
411
412
412
413
414
417
418
419
420
420
422
423
424
425
426
426

426
427


xvi
31.12

32

Emacs Lisp Packages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
32.1
32.2
32.3

33

Other Amusements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 428

The Package Menu Buffer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 430
Package Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 431
Package Files and Directory Layout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 432

Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 434
33.1 Easy Customization Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.1.1 Customization Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.1.2 Browsing and Searching for Settings . . . . . . . . . . . . . . . . . . . . . . . . . .
33.1.3 Changing a Variable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.1.4 Saving Customizations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.1.5 Customizing Faces . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.1.6 Customizing Specific Items . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

33.1.7 Custom Themes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.1.8 Creating Custom Themes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.2 Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.2.1 Examining and Setting Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.2.2 Hooks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.2.3 Local Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.2.4 Local Variables in Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.2.4.1 Specifying File Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.2.4.2 Safety of File Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.2.5 Per-Directory Local Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3 Customizing Key Bindings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.1 Keymaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.2 Prefix Keymaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.3 Local Keymaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.4 Minibuffer Keymaps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.5 Changing Key Bindings Interactively . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.6 Rebinding Keys in Your Init File . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.7 Modifier Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.8 Rebinding Function Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.9 Named ASCII Control Characters . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.10 Rebinding Mouse Buttons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.3.11 Disabling Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.4 The Emacs Initialization File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.4.1 Init File Syntax . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.4.2 Init File Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.4.3 Terminal-specific Initialization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.4.4 How Emacs Finds Your Init File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
33.4.5 Non-ASCII Characters in Init Files . . . . . . . . . . . . . . . . . . . . . . . . . . . .

434

434
435
436
438
439
440
441
442
443
443
445
446
447
447
449
450
452
452
453
453
454
454
455
456
457
458
459
460
461
462

463
465
466
466


xvii

34

Dealing with Common Problems . . . . . . . . . . . . . . . . . . . . . . 468
34.1 Quitting and Aborting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.2 Dealing with Emacs Trouble . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.2.1 If DEL Fails to Delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.2.2 Recursive Editing Levels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.2.3 Garbage on the Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.2.4 Garbage in the Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.2.5 Running out of Memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.2.6 Recovery After a Crash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.2.7 Emergency Escape . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.3 Reporting Bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.3.1 Reading Existing Bug Reports and Known Problems . . . . . . . . . .
34.3.2 When Is There a Bug. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.3.3 Understanding Bug Reporting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.3.4 Checklist for Bug Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.3.5 Sending Patches for GNU Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.4 Contributing to Emacs Development . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
34.5 How To Get Help with GNU Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

468

469
470
470
470
471
471
471
472
473
473
474
475
475
481
483
483

Appendix A

GNU GENERAL PUBLIC LICENSE . . . . 484

Appendix B

GNU Free Documentation License . . . . . . . . 496

Appendix C Command Line Arguments for Emacs
Invocation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 505
C.1
C.2
C.3

C.4

Action Arguments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Initial Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Command Argument Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Environment Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.4.1 General Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.4.2 Miscellaneous Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.4.3 The MS-Windows System Registry . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.5 Specifying the Display Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.6 Font Specification Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.7 Window Color Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.8 Options for Window Size and Position . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.9 Internal and External Borders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.10 Frame Titles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.11 Icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
C.12 Other Display Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

505
507
509
509
510
513
514
514
515
515
517
518

519
519
519


xviii

Appendix D

X Options and Resources . . . . . . . . . . . . . . . . . . 521

D.1 X Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
D.2 Table of X Resources for Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
D.3 GTK resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
D.3.1 GTK Resource Basics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
D.3.2 GTK widget names . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
D.3.3 GTK Widget Names in Emacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
D.3.4 GTK styles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

521
522
523
524
525
525
526

Appendix E

Emacs 23 Antinews . . . . . . . . . . . . . . . . . . . . . . . . . 529

Appendix F

Emacs and Mac OS / GNUstep . . . . . . . . . . . 531

F.1

Basic Emacs usage under Mac OS and GNUstep . . . . . . . . . . . . . . . . . . . .
F.1.1 Grabbing environment variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
F.2 Mac / GNUstep Customization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
F.2.1 Font and Color Panels . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
F.2.2 Customization options specific to Mac OS / GNUstep. . . . . . . . . .
F.3 Windowing System Events under Mac OS / GNUstep . . . . . . . . . . . . . . .
F.4 GNUstep Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

531
531
532
532
532
532
534

Appendix G Emacs and Microsoft Windows/MS-DOS
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 535
G.1
G.2
G.3
G.4
G.5

G.6
G.7
G.8
G.9
G.10
G.11

How to Start Emacs on MS-Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Text Files and Binary Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
File Names on MS-Windows. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Emulation of ls on MS-Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
HOME and Startup Directories on MS-Windows. . . . . . . . . . . . . . . . . . . .
Keyboard Usage on MS-Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Mouse Usage on MS-Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Subprocesses on Windows 9X/ME and Windows NT/2K/XP . . . . . . .
Printing and MS-Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Specifying Fonts on MS-Windows . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Miscellaneous Windows-specific features . . . . . . . . . . . . . . . . . . . . . . . . . . .

535
536
538
538
538
539
540
540
541
543
545

The GNU Manifesto . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 546
What’s GNU? Gnu’s Not Unix! . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Why I Must Write GNU . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Why GNU Will Be Compatible with Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How GNU Will Be Available . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Why Many Other Programmers Want to Help . . . . . . . . . . . . . . . . . . . . . . . . . . . .
How You Can Contribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Why All Computer Users Will Benefit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Some Easily Rebutted Objections to GNU’s Goals . . . . . . . . . . . . . . . . . . . . . . . .

546
547
547
547
547
548
548
549


xix

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 555
Key (Character) Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 580
Command and Function Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 590
Variable Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 604
Concept Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 612

Preface

1

Preface
This manual documents the use and simple customization of the Emacs editor.
Simple Emacs customizations do not require you to be a programmer, but if you
are not interested in customizing, you can ignore the customization hints.
This is primarily a reference manual, but can also be used as a primer. If you
are new to Emacs, we recommend you start with the integrated, learn-by-doing
tutorial, before reading the manual. To run the tutorial, start Emacs and type C-h
t. The tutorial describes commands, tells you when to try them, and explains the
results. The tutorial is available in several languages.
On first reading, just skim chapters 1 and 2, which describe the notational
conventions of the manual and the general appearance of the Emacs display screen.
Note which questions are answered in these chapters, so you can refer back later.
After reading chapter 4, you should practice the commands shown there. The next
few chapters describe fundamental techniques and concepts that are used constantly.
You need to understand them thoroughly, so experiment with them until you are
fluent.
Chapters 14 through 19 describe intermediate-level features that are useful for
many kinds of editing. Chapter 20 and following chapters describe optional but
useful features; read those chapters when you need them.
Read the Common Problems chapter if Emacs does not seem to be working
properly. It explains how to cope with several common problems (see Section 34.2
[Dealing with Emacs Trouble], page 469), as well as when and how to report Emacs
bugs (see Section 34.3 [Bugs], page 473).
To find the documentation of a particular command, look in the index. Keys
(character commands) and command names have separate indexes. There is also a
glossary, with a cross reference for each term.

This manual is available as a printed book and also as an Info file. The Info
file is for reading from Emacs itself, or with the Info program. Info is the principal
format for documentation in the GNU system. The Info file and the printed book
contain substantially the same text and are generated from the same source files,
which are also distributed with GNU Emacs.
GNU Emacs is a member of the Emacs editor family. There are many Emacs
editors, all sharing common principles of organization. For information on the
underlying philosophy of Emacs and the lessons learned from its development, see
Emacs, the Extensible, Customizable Self-Documenting Display Editor, available
from />This version of the manual is mainly intended for use with GNU Emacs installed
on GNU and Unix systems. GNU Emacs can also be used on MS-DOS, Microsoft
Windows, and Macintosh systems. The Info file version of this manual contains
some more information about using Emacs on those systems. Those systems use
different file name syntax; in addition MS-DOS does not support all GNU Emacs
features. See Appendix G [Microsoft Windows], page 535, for information about
using Emacs on Windows. See Appendix F [Mac OS / GNUstep], page 531, for
information about using Emacs on Macintosh (and GNUstep).