annotate man/xemacs/glossary.texi @ 5853:1044acf60048

Revert part of Jerry's December 2014 that broke gnuclient on some OS X. lib-src/ChangeLog addition: 2015-03-08 Aidan Kehoe <kehoea@parhasard.net> * gnuserv.c (echo_request): No longer close the file handle unconditionally, leave this to the individual socket types. * gnuserv.c (handle_internet_request): Close the file handle here. * gnuserv.c (handle_unix_request): Don't close the file handle here, document why (it broke gnuclient under OS X). It should actually be OK, but my suspicion is that the issues is that the Unix (local) domain sockets are still underdocumented compared to the internet sockets.
author Aidan Kehoe <kehoea@parhasard.net>
date Sun, 08 Mar 2015 20:59:25 +0000
parents abe6d1db359e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
1
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
2 @node Glossary, Manifesto, Intro, Top
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
3 @unnumbered Glossary
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
4
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
5 @table @asis
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
6 @item Abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
7 An abbrev is a text string which expands into a different text string
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
8 when present in the buffer. For example, you might define a short
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
9 word as an abbrev for a long phrase that you want to insert
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
10 frequently. @xref{Abbrevs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
11
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
12 @item Aborting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
13 Aborting means getting out of a recursive edit (q.v.@:). You can use
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
14 the commands @kbd{C-]} and @kbd{M-x top-level} for this.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
15 @xref{Quitting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
16
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
17 @item Auto Fill mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
18 Auto Fill mode is a minor mode in which text you insert is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
19 automatically broken into lines of fixed width. @xref{Filling}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
20
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
21 @item Auto Saving
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
22 Auto saving means that Emacs automatically stores the contents of an
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
23 Emacs buffer in a specially-named file so the information will not be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
24 lost if the buffer is lost due to a system error or user error.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
25 @xref{Auto Save}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
26
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
27 @item Backup File
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
28 A backup file records the contents that a file had before the current
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
29 editing session. Emacs creates backup files automatically to help you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
30 track down or cancel changes you later regret. @xref{Backup}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
31
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
32 @item Balance Parentheses
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
33 Emacs can balance parentheses manually or automatically. Manual
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
34 balancing is done by the commands to move over balanced expressions
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
35 (@pxref{Lists}). Automatic balancing is done by blinking the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
36 parenthesis that matches one just inserted (@pxref{Matching,,Matching
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
37 Parens}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
38
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
39 @item Bind
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
40 To bind a key is to change its binding (q.v.@:). @xref{Rebinding}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
41
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
42 @item Binding
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
43 A key gets its meaning in Emacs by having a binding which is a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
44 command (q.v.@:), a Lisp function that is run when the key is typed.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
45 @xref{Commands,Binding}. Customization often involves rebinding a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
46 character to a different command function. The bindings of all keys
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
47 are recorded in the keymaps (q.v.@:). @xref{Keymaps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
48
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
49 @item Blank Lines
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
50 Blank lines are lines that contain only whitespace. Emacs has several
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
51 commands for operating on the blank lines in a buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
52
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
53 @item Buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
54 The buffer is the basic editing unit; one buffer corresponds to one
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
55 piece of text being edited. You can have several buffers, but at any
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
56 time you are editing only one, the `selected' buffer, though several
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
57 buffers can be visible when you are using multiple windows. @xref{Buffers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
58
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
59 @item Buffer Selection History
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
60 Emacs keeps a buffer selection history which records how recently each
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
61 Emacs buffer was selected. Emacs uses this list when choosing a buffer to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
62 select. @xref{Buffers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
63
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
64 @item C-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
65 @samp{C} in the name of a character is an abbreviation for Control.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
66 @xref{Keystrokes,C-}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
67
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
68 @item C-M-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
69 @samp{C-M-} in the name of a character is an abbreviation for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
70 Control-Meta. @xref{Keystrokes,C-M-}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
71
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
72 @item Case Conversion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
73 Case conversion means changing text from upper case to lower case or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
74 vice versa. @xref{Case}, for the commands for case conversion.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
75
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
76 @item Characters
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
77 Characters form the contents of an Emacs buffer; also, Emacs commands
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
78 are invoked by keys (q.v.@:), which are sequences of one or more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
79 characters. @xref{Keystrokes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
80
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
81 @item Command
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
82 A command is a Lisp function specially defined to be able to serve as a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
83 key binding in Emacs. When you type a key (q.v.@:), Emacs looks up its
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
84 binding (q.v.@:) in the relevant keymaps (q.v.@:) to find the command to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
85 run. @xref{Commands}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
86
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
87 @item Command Name
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
88 A command name is the name of a Lisp symbol which is a command
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
89 (@pxref{Commands}). You can invoke any command by its name using
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
90 @kbd{M-x} (@pxref{M-x}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
91
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
92 @item Comments
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
93 A comment is text in a program which is intended only for the people
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
94 reading the program, and is marked specially so that it will be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
95 ignored when the program is loaded or compiled. Emacs offers special
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
96 commands for creating, aligning, and killing comments.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
97 @xref{Comments}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
98
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
99 @item Compilation
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
100 Compilation is the process of creating an executable program from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
101 source code. Emacs has commands for compiling files of Emacs Lisp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
102 code (@pxref{Lisp Libraries}) and programs in C and other languages
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
103 (@pxref{Compilation}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
104
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
105 @item Complete Key
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
106 A complete key is a character or sequence of characters which, when typed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
107 by the user, fully specifies one action to be performed by Emacs. For
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
108 example, @kbd{X} and @kbd{Control-f} and @kbd{Control-x m} are keys. Keys
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
109 derive their meanings from being bound (q.v.@:) to commands (q.v.@:).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
110 Thus, @kbd{X} is conventionally bound to a command to insert @samp{X} in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
111 the buffer; @kbd{C-x m} is conventionally bound to a command to begin
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
112 composing a mail message. @xref{Keystrokes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
113
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
114 @item Completion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
115 When Emacs automatically fills an abbreviation for a name into the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
116 entire name, that process is called completion. Completion is done for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
117 minibuffer (q.v.@:) arguments when the set of possible valid inputs is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
118 known; for example, on command names, buffer names, and file names.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
119 Completion occurs when you type @key{TAB}, @key{SPC}, or @key{RET}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
120 @xref{Completion}.@refill
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
121
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
122 @item Continuation Line
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
123 When a line of text is longer than the width of the frame, it
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
124 takes up more than one screen line when displayed. We say that the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
125 text line is continued, and all screen lines used for it after the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
126 first are called continuation lines. @xref{Basic,Continuation,Basic
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
127 Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
128
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
129 @item Control-Character
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
130 ASCII characters with octal codes 0 through 037, and also code 0177,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
131 do not have graphic images assigned to them. These are the control
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
132 characters. Any control character can be typed by holding down the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
133 @key{CTRL} key and typing some other character; some have special keys
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
134 on the keyboard. @key{RET}, @key{TAB}, @key{ESC}, @key{LFD}, and
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
135 @key{DEL} are all control characters. @xref{Keystrokes}.@refill
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
136
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
137 @item Copyleft
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
138 A copyleft is a notice giving the public legal permission to redistribute
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
139 a program or other work of art. Copylefts are used by leftists to enrich
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
140 the public just as copyrights are used by rightists to gain power over
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
141 the public.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
142
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
143 @item Current Buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
144 The current buffer in Emacs is the Emacs buffer on which most editing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
145 commands operate. You can select any Emacs buffer as the current one.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
146 @xref{Buffers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
147
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
148 @item Current Line
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
149 The line point is on (@pxref{Point}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
150
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
151 @item Current Paragraph
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
152 The paragraph that point is in. If point is between paragraphs, the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
153 current paragraph is the one that follows point. @xref{Paragraphs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
154
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
155 @item Current Defun
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
156 The defun (q.v.@:) that point is in. If point is between defuns, the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
157 current defun is the one that follows point. @xref{Defuns}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
158
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
159 @item Cursor
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
160 The cursor is the rectangle on the screen which indicates the position
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
161 called point (q.v.@:) at which insertion and deletion takes place.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
162 The cursor is on or under the character that follows point. Often
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
163 people speak of `the cursor' when, strictly speaking, they mean
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
164 `point'. @xref{Basic,Cursor,Basic Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
165
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
166 @item Customization
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
167 Customization is making minor changes in the way Emacs works. It is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
168 often done by setting variables (@pxref{Variables}) or by rebinding
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
169 keys (@pxref{Keymaps}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
170
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
171 @item Default Argument
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
172 The default for an argument is the value that is used if you do not
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
173 specify one. When Emacs prompts you in the minibuffer for an argument,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
174 the default argument is used if you just type @key{RET}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
175 @xref{Minibuffer}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
176
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
177 @item Default Directory
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
178 When you specify a file name that does not start with @samp{/} or @samp{~},
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
179 it is interpreted relative to the current buffer's default directory.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
180 @xref{Minibuffer File,Default Directory}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
181
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
182 @item Defun
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
183 A defun is a list at the top level of parenthesis or bracket structure
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
184 in a program. It is so named because most such lists in Lisp programs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
185 are calls to the Lisp function @code{defun}. @xref{Defuns}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
186
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
187 @item @key{DEL}
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
188 The @key{DEL} character runs the command that deletes one character of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
189 text. @xref{Basic,DEL,Basic Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
190
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
191 @item Deletion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
192 Deleting text means erasing it without saving it. Emacs deletes text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
193 only when it is expected not to be worth saving (all whitespace, or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
194 only one character). The alternative is killing (q.v.@:).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
195 @xref{Killing,Deletion}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
196
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
197 @item Deletion of Files
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
198 Deleting a file means removing it from the file system.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
199 @xref{Misc File Ops}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
200
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
201 @item Deletion of Messages
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
202 Deleting a message means flagging it to be eliminated from your mail
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
203 file. Until the mail file is expunged, you can undo this by undeleting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
204 the message.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
205
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
206 @item Deletion of Frames
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
207 When working under the multi-frame X-based version of XEmacs,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
208 you can delete individual frames using the @b{Close} menu item from the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
209 @b{File} menu.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
210
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
211 @item Deletion of Windows
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
212 When you delete a subwindow of an Emacs frame, you eliminate it from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
213 the frame. Other windows expand to use up the space. The deleted
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
214 window can never come back, but no actual text is lost. @xref{Windows}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
215
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
216 @item Directory
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
217 Files in the Unix file system are grouped into file directories.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
218 @xref{ListDir,,Directories}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
219
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
220 @item Dired
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
221 Dired is the Emacs facility that displays the contents of a file
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
222 directory and allows you to ``edit the directory'', performing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
223 operations on the files in the directory. @xref{Dired}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
224
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
225 @item Disabled Command
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
226 A disabled command is one that you may not run without special
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
227 confirmation. Commands are usually disabled because they are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
228 confusing for beginning users. @xref{Disabling}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
229
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
230 @item Dribble File
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
231 A file into which Emacs writes all the characters that the user types
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
232 on the keyboard. Dribble files are used to make a record for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
233 debugging Emacs bugs. Emacs does not make a dribble file unless you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
234 tell it to. @xref{Bugs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
235
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
236 @item Echo Area
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
237 The area at the bottom of the Emacs frame which is used for echoing the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
238 arguments to commands, for asking questions, and for printing brief
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
239 messages (including error messages). @xref{Echo Area}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
240
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
241 @item Echoing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
242 Echoing refers to acknowledging the receipt of commands by displaying them
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
243 (in the echo area). Emacs never echoes single-character keys; longer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
244 keys echo only if you pause while typing them.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
245
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
246 @item Error
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
247 An error occurs when an Emacs command cannot execute in the current
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
248 circumstances. When an error occurs, execution of the command stops
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
249 (unless the command has been programmed to do otherwise) and Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
250 reports the error by printing an error message (q.v.). Type-ahead
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
251 is discarded. Then Emacs is ready to read another editing command.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
252
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
253 @item Error Messages
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
254 Error messages are single lines of output printed by Emacs when the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
255 user asks for something impossible to do (such as killing text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
256 forward when point is at the end of the buffer). They appear in the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
257 echo area, accompanied by a beep.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
258
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
259 @item @key{ESC}
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
260 @key{ESC} is a character used as a prefix for typing Meta characters on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
261 keyboards lacking a @key{META} key. Unlike the @key{META} key (which,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
262 like the @key{SHIFT} key, is held down while another character is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
263 typed), the @key{ESC} key is pressed and released, and applies to the
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
264 next character typed.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
265
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
266 @item Fill Prefix
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
267 The fill prefix is a string that Emacs enters at the beginning
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
268 of each line when it performs filling. It is not regarded as part of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
269 text to be filled. @xref{Filling}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
270
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
271 @item Filling
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
272 Filling text means moving text from line to line so that all the lines
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
273 are approximately the same length. @xref{Filling}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
274
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
275 @item Frame
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
276 When running Emacs on a TTY terminal, ``frame'' means the terminal's
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
277 screen. When running Emacs under X, you can have multiple frames,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
278 each corresponding to a top-level X window and each looking like
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
279 the screen on a TTY. Each frame contains one or more non-overlapping
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
280 Emacs windows (possibly with associated scrollbars, under X), an
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
281 echo area, and (under X) possibly a menubar, toolbar, and/or gutter.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
282
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
283 @item Global
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
284 Global means `independent of the current environment; in effect
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
285 @*throughout Emacs'. It is the opposite of local (q.v.@:).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
286 Examples of the use of `global' appear below.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
287
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
288 @item Global Abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
289 A global definition of an abbrev (q.v.@:) is effective in all major
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
290 modes that do not have local (q.v.@:) definitions for the same abbrev.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
291 @xref{Abbrevs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
292
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
293 @item Global Keymap
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
294 The global keymap (q.v.@:) contains key bindings that are in effect
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
295 unless local key bindings in a major mode's local
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
296 keymap (q.v.@:) override them.@xref{Keymaps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
297
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
298 @item Global Substitution
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
299 Global substitution means replacing each occurrence of one string by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
300 another string through a large amount of text. @xref{Replace}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
301
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
302 @item Global Variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
303 The global value of a variable (q.v.@:) takes effect in all buffers
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
304 that do not have their own local (q.v.@:) values for the variable.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
305 @xref{Variables}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
306
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
307 @item Graphic Character
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
308 Graphic characters are those assigned pictorial images rather than
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
309 just names. All the non-Meta (q.v.@:) characters except for the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
310 Control (q.v.@:) character are graphic characters. These include
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
311 letters, digits, punctuation, and spaces; they do not include
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
312 @key{RET} or @key{ESC}. In Emacs, typing a graphic character inserts
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
313 that character (in ordinary editing modes). @xref{Basic,,Basic Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
314
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
315 @item Grinding
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
316 Grinding means adjusting the indentation in a program to fit the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
317 nesting structure. @xref{Indentation,Grinding}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
318
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
319 @item Hardcopy
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
320 Hardcopy means printed output. Emacs has commands for making printed
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
321 listings of text in Emacs buffers. @xref{Hardcopy}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
322
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
323 @item @key{HELP}
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
324 You can type @key{HELP} at any time to ask what options you have, or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
325 to ask what any command does. @key{HELP} is really @kbd{Control-h}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
326 @xref{Help}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
327
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
328 @item Inbox
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
329 An inbox is a file in which mail is delivered by the operating system.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
330 Some mail handlers transfers mail from inboxes to mail files (q.v.) in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
331 which the mail is then stored permanently or until explicitly deleted.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
332
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
333 @item Indentation
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
334 Indentation means blank space at the beginning of a line. Most
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
335 programming languages have conventions for using indentation to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
336 illuminate the structure of the program, and Emacs has special
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
337 features to help you set up the correct indentation.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
338 @xref{Indentation}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
339
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
340 @item Insertion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
341 Insertion means copying text into the buffer, either from the keyboard
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
342 or from some other place in Emacs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
343
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
344 @item Justification
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
345 Justification means adding extra spaces to lines of text to make them
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
346 come exactly to a specified width. @xref{Filling,Justification}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
347
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
348 @item Keyboard Macros
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
349 Keyboard macros are a way of defining new Emacs commands from
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
350 sequences of existing ones, with no need to write a Lisp program.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
351 @xref{Keyboard Macros}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
352
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
353 @item Key
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
354 A key is a sequence of characters that, when input to Emacs, specify
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
355 or begin to specify a single action for Emacs to perform. That is,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
356 the sequence is considered a single unit. If the key is enough to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
357 specify one action, it is a complete key (q.v.); if it is less than
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
358 enough, it is a prefix key (q.v.). @xref{Keystrokes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
359
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
360 @item Keymap
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
361 The keymap is the data structure that records the bindings (q.v.@:) of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
362 keys to the commands that they run. For example, the keymap binds the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
363 character @kbd{C-n} to the command function @code{next-line}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
364 @xref{Keymaps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
365
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
366 @item Kill Ring
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
367 The kill ring is the place where all text you have killed recently is saved.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
368 You can re-insert any of the killed text still in the ring; this is
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
369 called yanking (q.v.@:). @xref{Yanking}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
370
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
371 @item Killing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
372 Killing means erasing text and saving it on the kill ring so it can be
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
373 yanked (q.v.@:) later. Some other systems call this ``cutting.''
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
374 Most Emacs commands to erase text do killing, as opposed to deletion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
375 (q.v.@:). @xref{Killing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
376
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
377 @item Killing Jobs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
378 Killing a job (such as, an invocation of Emacs) means making it cease
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
379 to exist. Any data within it, if not saved in a file, is lost.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
380 @xref{Exiting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
381
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
382 @item List
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
383 A list is, approximately, a text string beginning with an open
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
384 parenthesis and ending with the matching close parenthesis. In C mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
385 and other non-Lisp modes, groupings surrounded by other kinds of matched
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
386 delimiters appropriate to the language, such as braces, are also
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
387 considered lists. Emacs has special commands for many operations on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
388 lists. @xref{Lists}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
389
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
390 @item Local
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
391 Local means `in effect only in a particular context'; the relevant
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
392 kind of context is a particular function execution, a particular
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
393 buffer, or a particular major mode. Local is the opposite of `global'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
394 (q.v.@:). Specific uses of `local' in Emacs terminology appear below.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
395
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
396 @item Local Abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
397 A local abbrev definition is effective only if a particular major mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
398 is selected. In that major mode, it overrides any global definition
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
399 for the same abbrev. @xref{Abbrevs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
400
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
401 @item Local Keymap
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
402 A local keymap is used in a particular major mode; the key bindings
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
403 (q.v.@:) in the current local keymap override global bindings of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
404 same keys. @xref{Keymaps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
405
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
406 @item Local Variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
407 A local value of a variable (q.v.@:) applies to only one buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
408 @xref{Locals}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
409
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
410 @item M-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
411 @kbd{M-} in the name of a character is an abbreviation for @key{META},
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
412 one of the modifier keys that can accompany any character.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
413 @xref{Keystrokes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
414
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
415 @item M-C-
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
416 @samp{M-C-} in the name of a character is an abbreviation for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
417 Control-Meta; it means the same thing as @samp{C-M-}. If your
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
418 terminal lacks a real @key{META} key, you type a Control-Meta character by
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
419 typing @key{ESC} and then typing the corresponding Control character.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
420 @xref{Keystrokes,C-M-}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
421
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
422 @item M-x
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
423 @kbd{M-x} is the key which is used to call an Emacs command by name.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
424 You use it to call commands that are not bound to keys.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
425 @xref{M-x}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
426
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
427 @item Mail
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
428 Mail means messages sent from one user to another through the computer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
429 system, to be read at the recipient's convenience. Emacs has commands for
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
430 composing and sending mail, and for reading and editing the mail you have
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
431 received. @xref{Sending Mail}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
432
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
433 @item Major Mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
434 The major modes are a mutually exclusive set of options each of which
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
435 configures Emacs for editing a certain sort of text. Ideally, each
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
436 programming language has its own major mode. @xref{Major Modes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
437
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
438 @item Mark
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
439 The mark points to a position in the text. It specifies one end of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
440 region (q.v.@:), point being the other end. Many commands operate on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
441 the whole region, that is, all the text from point to the mark.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
442 @xref{Mark}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
443
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
444 @item Mark Ring
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
445 The mark ring is used to hold several recent previous locations of the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
446 mark, just in case you want to move back to them. @xref{Mark Ring}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
447
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
448 @item Message
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
449 See `mail'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
450
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
451 @item Meta
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
452 Meta is the name of a modifier bit which a command character may have.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
453 It is present in a character if the character is typed with the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
454 @key{META} key held down. Such characters are given names that start
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
455 with @kbd{Meta-}. For example, @kbd{Meta-<} is typed by holding down
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
456 @key{META} and at the same time typing @kbd{<} (which itself is done,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
457 on most terminals, by holding down @key{SHIFT} and typing @kbd{,}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
458 @xref{Keystrokes,Meta}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
459
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
460 @item Meta Character
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
461 A Meta character is one whose character code includes the Meta bit.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
462
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
463 @item Minibuffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
464 The minibuffer is the window that Emacs displays inside the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
465 echo area (q.v.@:) when it prompts you for arguments to commands.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
466 @xref{Minibuffer}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
467
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
468 @item Minor Mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
469 A minor mode is an optional feature of Emacs which can be switched on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
470 or off independent of the major mode. Each minor mode has a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
471 command to turn it on or off. @xref{Minor Modes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
472
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
473 @item Mode Line
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
474 The mode line is the line at the bottom of each text window (q.v.@:),
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
475 which gives status information on the buffer displayed in that window.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
476 @xref{Mode Line}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
477
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
478 @item Modified Buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
479 A buffer (q.v.@:) is modified if its text has been changed since the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
480 last time the buffer was saved (or since it was created, if it
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
481 has never been saved). @xref{Saving}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
482
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
483 @item Moving Text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
484 Moving text means erasing it from one place and inserting it in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
485 another. This is done by killing (q.v.@:) and then yanking (q.v.@:).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
486 @xref{Killing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
487
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
488 @item Named Mark
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
489 A named mark is a register (q.v.@:) in its role of recording a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
490 location in text so that you can move point to that location.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
491 @xref{Registers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
492
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
493 @item Narrowing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
494 Narrowing means creating a restriction (q.v.@:) that limits editing in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
495 the current buffer to only a part of the text in the buffer. Text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
496 outside that part is inaccessible to the user until the boundaries are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
497 widened again, but it is still there, and saving the file saves the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
498 invisible text. @xref{Narrowing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
499
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
500 @item Newline
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
501 @key{LFD} characters in the buffer terminate lines of text and are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
502 called newlines. @xref{Keystrokes,Newline}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
503
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
504 @item Numeric Argument
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
505 A numeric argument is a number, specified before a command, to change
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
506 the effect of the command. Often the numeric argument serves as a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
507 repeat count. @xref{Arguments}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
508
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
509 @item Option
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
510 An option is a variable (q.v.@:) that allows you to customize
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
511 Emacs by giving it a new value. @xref{Variables}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
512
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
513 @item Overwrite Mode
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
514 Overwrite mode is a minor mode. When it is enabled, ordinary text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
515 characters replace the existing text after point rather than pushing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
516 it to the right. @xref{Minor Modes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
517
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
518 @item Page
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
519 A page is a unit of text, delimited by formfeed characters (ASCII
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
520 Control-L, code 014) coming at the beginning of a line. Some Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
521 commands are provided for moving over and operating on pages.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
522 @xref{Pages}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
523
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
524 @item Paragraphs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
525 Paragraphs are the medium-size unit of English text. There are
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
526 special Emacs commands for moving over and operating on paragraphs.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
527 @xref{Paragraphs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
528
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
529 @item Parsing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
530 We say that Emacs parses words or expressions in the text being
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
531 edited. Really, all it knows how to do is find the other end of a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
532 word or expression. @xref{Syntax}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
533
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
534 @item Point
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
535 Point is the place in the buffer at which insertion and deletion
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
536 occur. Point is considered to be between two characters, not at one
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
537 character. The terminal's cursor (q.v.@:) indicates the location of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
538 point. @xref{Basic,Point}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
539
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
540 @item Prefix Key
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
541 A prefix key is a key (q.v.@:) whose sole function is to introduce a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
542 set of multi-character keys. @kbd{Control-x} is an example of a prefix
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
543 key; any two-character sequence starting with @kbd{C-x} is also
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
544 a legitimate key. @xref{Keystrokes}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
545
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
546 @item Prompt
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
547 A prompt is text printed to ask the user for input. Printing a prompt
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
548 is called prompting. Emacs prompts always appear in the echo area
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
549 (q.v.@:). One kind of prompting happens when the minibuffer is used
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
550 to read an argument (@pxref{Minibuffer}); the echoing which happens
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
551 when you pause in the middle of typing a multi-character key is also a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
552 kind of prompting (@pxref{Echo Area}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
553
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
554 @item Quitting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
555 Quitting means cancelling a partially typed command or a running
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
556 command, using @kbd{C-g}. @xref{Quitting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
557
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
558 @item Quoting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
559 Quoting means depriving a character of its usual special significance.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
560 In Emacs this is usually done with @kbd{Control-q}. What constitutes special
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
561 significance depends on the context and on convention. For example,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
562 an ``ordinary'' character as an Emacs command inserts itself; so in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
563 this context, a special character is any character that does not
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
564 normally insert itself (such as @key{DEL}, for example), and quoting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
565 it makes it insert itself as if it were not special. Not all contexts
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
566 allow quoting. @xref{Basic,Quoting,Basic Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
567
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
568 @item Read-only Buffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
569 A read-only buffer is one whose text you are not allowed to change.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
570 Normally Emacs makes buffers read-only when they contain text which
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
571 has a special significance to Emacs, such as Dired buffers.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
572 Visiting a file that is write-protected also makes a read-only buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
573 @xref{Buffers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
574
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
575 @item Recursive Editing Level
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
576 A recursive editing level is a state in which part of the execution of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
577 a command involves asking the user to edit some text. This text may
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
578 or may not be the same as the text to which the command was applied.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
579 The mode line indicates recursive editing levels with square brackets
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
580 (@samp{[} and @samp{]}). @xref{Recursive Edit}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
581
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
582 @item Redisplay
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
583 Redisplay is the process of correcting the image on the screen to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
584 correspond to changes that have been made in the text being edited.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
585 @xref{Frame,Redisplay}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
586
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
587 @item Regexp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
588 See `regular expression'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
589
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
590 @item Region
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
591 The region is the text between point (q.v.@:) and the mark (q.v.@:).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
592 Many commands operate on the text of the region. @xref{Mark,Region}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
593
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
594 @item Registers
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
595 Registers are named slots in which text or buffer positions or
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
596 rectangles can be saved for later use. @xref{Registers}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
597
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
598 @item Regular Expression
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
599 A regular expression is a pattern that can match various text strings;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
600 for example, @samp{l[0-9]+} matches @samp{l} followed by one or more
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
601 digits. @xref{Regexps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
602
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
603 @item Replacement
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
604 See `global substitution'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
605
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
606 @item Restriction
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
607 A buffer's restriction is the amount of text, at the beginning or the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
608 end of the buffer, that is temporarily invisible and inaccessible.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
609 Giving a buffer a nonzero amount of restriction is called narrowing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
610 (q.v.). @xref{Narrowing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
611
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
612 @item @key{RET}
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
613 @key{RET} is the character than runs the command to insert a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
614 newline into the text. It is also used to terminate most arguments
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
615 read in the minibuffer (q.v.@:). @xref{Keystrokes,Return}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
616
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
617 @item Saving
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
618 Saving a buffer means copying its text into the file that was visited
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
619 (q.v.@:) in that buffer. To actually change a file you have edited in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
620 Emacs, you have to save it. @xref{Saving}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
621
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
622 @item Scrolling
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
623 Scrolling means shifting the text in the Emacs window to make a
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
624 different part of the buffer visible. @xref{Display,Scrolling}.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
625
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
626 @item Searching
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
627 Searching means moving point to the next occurrence of a specified
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
628 string. @xref{Search}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
629
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
630 @item Selecting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
631 Selecting a buffer means making it the current (q.v.@:) buffer.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
632 @xref{Buffers,Selecting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
633
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
634 @item Self-documentation
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
635 Self-documentation is the feature of Emacs which can tell you what any
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
636 command does, or can give you a list of all commands related to a topic
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
637 you specify. You ask for self-documentation with the help character,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
638 @kbd{C-h}. @xref{Help}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
639
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
640 @item Sentences
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
641 Emacs has commands for moving by or killing by sentences.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
642 @xref{Sentences}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
643
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
644 @item Sexp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
645 An sexp (short for `s-expression,' itself short for `symbolic
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
646 expression') is the basic syntactic unit of Lisp
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
647 in its textual form: either a list, or Lisp atom. Many Emacs commands
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
648 operate on sexps. The term `sexp' is generalized to languages other
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
649 than Lisp to mean a syntactically recognizable expression.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
650 @xref{Lists,Sexps}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
651
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
652 @item Simultaneous Editing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
653 Simultaneous editing means two users modifying the same file at once.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
654 If simultaneous editing is not detected, you may lose your
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
655 work. Emacs detects all cases of simultaneous editing and warns the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
656 user to investigate them. @xref{Interlocking,,Simultaneous Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
657
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
658 @item String
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
659 A string is a kind of Lisp data object which contains a sequence of
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
660 characters. Many Emacs variables are intended to have strings as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
661 values. The Lisp syntax for a string consists of the characters in
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
662 the string with a @samp{"} before and another @samp{"} after. Write a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
663 @samp{"} that is part of the string as @samp{\"} and a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
664 @samp{\} that is part of the string as @samp{\\}. You can include all
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
665 other characters, including newline, just by writing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
666 them inside the string. You can also include escape sequences as in C, such as
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
667 @samp{\n} for newline or @samp{\241} using an octal character code.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
668
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
669 @item String Substitution
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
670 See `global substitution'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
671
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
672 @item Syntax Table
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
673 The syntax table tells Emacs which characters are part of a word,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
674 which characters balance each other like parentheses, etc.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
675 @xref{Syntax}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
676
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
677 @item Tag Table
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
678 A tag table is a file that serves as an index to the function
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
679 definitions in one or more other files. @xref{Tags}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
680
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
681 @item Termscript File
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
682 A termscript file contains a record of all characters Emacs sent to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
683 the terminal. It is used for tracking down bugs in Emacs redisplay.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
684 Emacs does not make a termscript file unless explicitly instructed to do
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
685 so.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
686 @xref{Bugs}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
687
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
688 @item Text
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
689 Text has two meanings (@pxref{Text}):
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
690
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
691 @itemize @bullet
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
692 @item
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
693 Data consisting of a sequence of characters, as opposed to binary
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
694 numbers, images, graphics commands, executable programs, and the like.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
695 The contents of an Emacs buffer are always text in this sense.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
696 @item
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
697 Data consisting of written human language, as opposed to programs,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
698 or something that follows the stylistic conventions of human language.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
699 @end itemize
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
700
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
701 @item Top Level
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
702 Top level is the normal state of Emacs, in which you are editing the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
703 text of the file you have visited. You are at top level whenever you
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
704 are not in a recursive editing level (q.v.@:) or the minibuffer
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
705 (q.v.@:), and not in the middle of a command. You can get back to top
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
706 level by aborting (q.v.@:) and quitting (q.v.@:). @xref{Quitting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
707
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
708 @item Transposition
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
709 Transposing two units of text means putting each one into the place
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
710 formerly occupied by the other. There are Emacs commands to transpose
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
711 two adjacent characters, words, sexps (q.v.@:), or lines
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
712 (@pxref{Transpose}).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
713
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
714 @item Truncation
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
715 Truncating text lines in the display means leaving out any text on a
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
716 line that does not fit within the right margin of the window
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
717 displaying it. See also `continuation line'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
718 @xref{Basic,Truncation,Basic Editing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
719
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
720 @item Undoing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
721 Undoing means making your previous editing go in reverse, bringing
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
722 back the text that existed earlier in the editing session.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
723 @xref{Undo}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
724
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
725 @item Variable
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
726 A variable is Lisp object that can store an arbitrary value. Emacs uses
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
727 some variables for internal purposes, and has others (known as `options'
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
728 (q.v.@:)) you can set to control the behavior of Emacs. The variables
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
729 used in Emacs that you are likely to be interested in are listed in the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
730 Variables Index of this manual. @xref{Variables}, for information on
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
731 variables.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
732
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
733 @item Visiting
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
734 Visiting a file means loading its contents into a buffer (q.v.@:)
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
735 where they can be edited. @xref{Visiting}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
736
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
737 @item Whitespace
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
738 Whitespace is any run of consecutive formatting characters (spaces,
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
739 tabs, newlines, and backspaces).
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
740
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
741 @item Widening
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
742 Widening is removing any restriction (q.v.@:) on the current buffer;
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
743 it is the opposite of narrowing (q.v.@:). @xref{Narrowing}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
744
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
745 @item Window
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
746 Emacs divides the frame into one or more windows, each of which can
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
747 display the contents of one buffer (q.v.@:) at any time.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
748 @xref{Frame}, for basic information on how Emacs uses the frame.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
749 @xref{Windows}, for commands to control the use of windows. Note that if
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
750 you are running Emacs under X, terminology can be confusing: Each Emacs
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
751 frame occupies a separate X window and can, in turn, be divided into
442
abe6d1db359e Import from CVS: tag r21-2-36
cvs
parents: 0
diff changeset
752 different subwindows.
0
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
753
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
754 @item Word Abbrev
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
755 Synonymous with `abbrev'.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
756
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
757 @item Word Search
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
758 Word search is searching for a sequence of words, considering the
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
759 punctuation between them as insignificant. @xref{Word Search}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
760
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
761 @item Yanking
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
762 Yanking means reinserting text previously killed. It can be used to
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
763 undo a mistaken kill, or for copying or moving text. Some other
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
764 systems call this ``pasting''. @xref{Yanking}.
376386a54a3c Import from CVS: tag r19-14
cvs
parents:
diff changeset
765 @end table