Merge from emacs-24; up to 2012-12-06T01:39:03Z!monnier@iro.umontreal.ca
[bpt/emacs.git] / doc / emacs / glossary.texi
CommitLineData
8cf51b2c 1@c This is part of the Emacs manual.
ab422c4d
PE
2@c Copyright (C) 1985-1987, 1993-1995, 1997, 2001-2013 Free Software
3@c Foundation, Inc.
8cf51b2c 4@c See file emacs.texi for copying conditions.
abb9615e 5@node Glossary
8cf51b2c
GM
6@unnumbered Glossary
7
8@table @asis
f99f1641 9@anchor{Glossary---Abbrev}
8cf51b2c 10@item Abbrev
8bf27c8a 11An abbrev is a text string that expands into a different text string
8cf51b2c
GM
12when present in the buffer. For example, you might define a few letters
13as an abbrev for a long phrase that you want to insert frequently.
14@xref{Abbrevs}.
15
16@item Aborting
1df7defd 17Aborting means getting out of a recursive edit (q.v.). The
8cf51b2c
GM
18commands @kbd{C-]} and @kbd{M-x top-level} are used for this.
19@xref{Quitting}.
20
a0706406
GM
21@c FIXME? Active Region
22
8cf51b2c 23@item Alt
07ee224d 24Alt is the name of a modifier bit that a keyboard input character may
8cf51b2c
GM
25have. To make a character Alt, type it while holding down the @key{ALT}
26key. Such characters are given names that start with @kbd{Alt-}
27(usually written @kbd{A-} for short). (Note that many terminals have a
07ee224d 28key labeled @key{ALT} that is really a @key{META} key.) @xref{User
8cf51b2c
GM
29Input, Alt}.
30
31@item Argument
f99f1641 32@xref{Glossary---Numeric Argument}.
8cf51b2c
GM
33
34@item @acronym{ASCII} character
07ee224d
GM
35An @acronym{ASCII} character is either an @acronym{ASCII} control
36character or an @acronym{ASCII} printing character. @xref{User Input}.
8cf51b2c
GM
37
38@item @acronym{ASCII} control character
39An @acronym{ASCII} control character is the Control version of an upper-case
40letter, or the Control version of one of the characters @samp{@@[\]^_?}.
41
42@item @acronym{ASCII} printing character
166bc0c8
CY
43@acronym{ASCII} letters, digits, space, and the following punctuation
44characters: @samp{!@@#$%^&*()_-+=|\~`@{@}[]:;"'<>,.?/}.
8cf51b2c
GM
45
46@item Auto Fill Mode
07ee224d 47Auto Fill mode is a minor mode (q.v.@:) in which text that you insert is
8cf51b2c
GM
48automatically broken into lines of a given maximum width.
49@xref{Filling}.
50
51@item Auto Saving
07ee224d
GM
52Auto saving is the practice of periodically saving the contents of an
53Emacs buffer in a specially-named file, so that the information will
54be preserved if the buffer is lost due to a system error or user error.
55@xref{Auto Save}.
8cf51b2c
GM
56
57@item Autoloading
07ee224d 58Emacs can automatically load Lisp libraries when a Lisp program requests a
8bf27c8a 59function from those libraries. This is called `autoloading'.
07ee224d 60@xref{Lisp Libraries}.
8cf51b2c
GM
61
62@item Backtrace
63A backtrace is a trace of a series of function calls showing how a
07ee224d 64program arrived at a certain point. It is used mainly for finding and
1df7defd 65correcting bugs (q.v.). Emacs can display a backtrace when it signals
f99f1641 66an error or when you type @kbd{C-g} (@pxref{Glossary---Quitting}).
8980d0b9 67@xref{Checklist}.
8cf51b2c
GM
68
69@item Backup File
70A backup file records the contents that a file had before the current
71editing session. Emacs makes backup files automatically to help you
72track down or cancel changes you later regret making. @xref{Backup}.
73
74@item Balancing Parentheses
75Emacs can balance parentheses (or other matching delimiters) either
76manually or automatically. You do manual balancing with the commands
77to move over parenthetical groupings (@pxref{Moving by Parens}).
78Automatic balancing works by blinking or highlighting the delimiter
8bf27c8a
GM
79that matches the one you just inserted, or inserting the matching
80delimiter for you (@pxref{Matching,,Matching Parens}).
8cf51b2c 81
f99f1641 82@anchor{Glossary---Balanced Expression}
8cf51b2c
GM
83@item Balanced Expressions
84A balanced expression is a syntactically recognizable expression, such
85as a symbol, number, string constant, block, or parenthesized expression
1df7defd 86in C@. @xref{Expressions,Balanced Expressions}.
8cf51b2c
GM
87
88@item Balloon Help
f99f1641 89@xref{Glossary---Tooltips}.
8cf51b2c
GM
90
91@item Base Buffer
92A base buffer is a buffer whose text is shared by an indirect buffer
1df7defd 93(q.v.).
8cf51b2c 94
a0706406
GM
95@item Bidirectional Text
96Some human languages, such as English, are written from left to right.
97Others, such as Arabic, are written from right to left. Emacs
98supports both of these forms, as well as any mixture of them---this
99is `bidirectional text'. @xref{Bidirectional Editing}.
100
8cf51b2c 101@item Bind
1df7defd 102To bind a key sequence means to give it a binding (q.v.).
8cf51b2c
GM
103@xref{Rebinding}.
104
f99f1641 105@anchor{Glossary---Binding}
8cf51b2c
GM
106@item Binding
107A key sequence gets its meaning in Emacs by having a binding, which is a
1df7defd 108command (q.v.), a Lisp function that is run when you type that
8cf51b2c
GM
109sequence. @xref{Commands,Binding}. Customization often involves
110rebinding a character to a different command function. The bindings of
1df7defd 111all key sequences are recorded in the keymaps (q.v.). @xref{Keymaps}.
8cf51b2c
GM
112
113@item Blank Lines
114Blank lines are lines that contain only whitespace. Emacs has several
8bf27c8a 115commands for operating on the blank lines in the buffer. @xref{Blank Lines}.
8cf51b2c
GM
116
117@item Bookmark
118Bookmarks are akin to registers (q.v.@:) in that they record positions
119in buffers to which you can return later. Unlike registers, bookmarks
8bf27c8a 120persist between Emacs sessions. @xref{Bookmarks}.
8cf51b2c
GM
121
122@item Border
123A border is a thin space along the edge of the frame, used just for
124spacing, not for displaying anything. An Emacs frame has an ordinary
125external border, outside of everything including the menu bar, plus an
07ee224d
GM
126internal border that surrounds the text windows, their scroll bars
127and fringes, and separates them from the menu bar and tool bar. You
128can customize both borders with options and resources (@pxref{Borders
1df7defd 129X}). Borders are not the same as fringes (q.v.).
8cf51b2c
GM
130
131@item Buffer
132The buffer is the basic editing unit; one buffer corresponds to one text
8bf27c8a
GM
133being edited. You normally have several buffers, but at any time you are
134editing only one, the `current buffer', though several can be visible
1df7defd 135when you are using multiple windows or frames (q.v.). Most buffers
07ee224d 136are visiting (q.v.@:) some file. @xref{Buffers}.
8cf51b2c
GM
137
138@item Buffer Selection History
8bf27c8a 139Emacs keeps a buffer selection history that records how recently each
8cf51b2c
GM
140Emacs buffer has been selected. This is used for choosing a buffer to
141select. @xref{Buffers}.
142
143@item Bug
144A bug is an incorrect or unreasonable behavior of a program, or
145inaccurate or confusing documentation. Emacs developers treat bug
146reports, both in Emacs code and its documentation, very seriously and
147ask you to report any bugs you find. @xref{Bugs}.
148
149@item Button Down Event
07ee224d
GM
150A button down event is the kind of input event (q.v.@:) generated
151right away when you press down on a mouse button. @xref{Mouse Buttons}.
8cf51b2c
GM
152
153@item By Default
f99f1641 154@xref{Glossary---Default}.
8cf51b2c
GM
155
156@item Byte Compilation
f99f1641 157@xref{Glossary---Compilation}.
8cf51b2c 158
f99f1641 159@anchor{Glossary---C-}
8cf51b2c
GM
160@item @kbd{C-}
161@kbd{C-} in the name of a character is an abbreviation for Control.
162@xref{User Input,C-}.
163
164@item @kbd{C-M-}
165@kbd{C-M-} in the name of a character is an abbreviation for
07ee224d
GM
166Control-Meta. If your terminal lacks a real @key{META} key, you type
167a Control-Meta character by typing @key{ESC} and then typing the
168corresponding Control character. @xref{User Input,C-M-}.
8cf51b2c
GM
169
170@item Case Conversion
171Case conversion means changing text from upper case to lower case or
8bf27c8a 172vice versa. @xref{Case}.
8cf51b2c
GM
173
174@item Character
71f675e5
CY
175Characters form the contents of an Emacs buffer. Also, key sequences
176(q.v.@:) are usually made up of characters (though they may include
177other input events as well). @xref{User Input}.
8cf51b2c
GM
178
179@item Character Set
180Emacs supports a number of character sets, each of which represents a
181particular alphabet or script. @xref{International}.
182
183@item Character Terminal
f99f1641 184@xref{Glossary---Text Terminal}.
8cf51b2c
GM
185
186@item Click Event
07ee224d
GM
187A click event is the kind of input event (q.v.@:) generated when you
188press a mouse button and release it without moving the mouse.
189@xref{Mouse Buttons}.
8cf51b2c 190
a0706406 191@item Client
f99f1641 192@xref{Glossary---Server}.
a0706406 193
8cf51b2c
GM
194@item Clipboard
195A clipboard is a buffer provided by the window system for transferring
870e8fb8 196text between applications. On the X Window System, the clipboard is
1df7defd 197provided in addition to the primary selection (q.v.); on MS-Windows and Mac,
8cf51b2c
GM
198the clipboard is used @emph{instead} of the primary selection.
199@xref{Clipboard}.
200
201@item Coding System
202A coding system is an encoding for representing text characters in a
203file or in a stream of information. Emacs has the ability to convert
204text to or from a variety of coding systems when reading or writing it.
205@xref{Coding Systems}.
206
207@item Command
208A command is a Lisp function specially defined to be able to serve as a
1df7defd 209key binding in Emacs. When you type a key sequence (q.v.), its
8cf51b2c
GM
210binding (q.v.@:) is looked up in the relevant keymaps (q.v.@:) to find
211the command to run. @xref{Commands}.
212
213@item Command History
f99f1641 214@xref{Glossary---Minibuffer History}.
8cf51b2c
GM
215
216@item Command Name
8bf27c8a 217A command name is the name of a Lisp symbol that is a command
8cf51b2c
GM
218(@pxref{Commands}). You can invoke any command by its name using
219@kbd{M-x} (@pxref{M-x,M-x,Running Commands by Name}).
220
221@item Comment
222A comment is text in a program which is intended only for humans reading
07ee224d 223the program, and which is specially marked so that it will be ignored
8cf51b2c
GM
224when the program is loaded or compiled. Emacs offers special commands
225for creating, aligning and killing comments. @xref{Comments}.
226
227@item Common Lisp
228Common Lisp is a dialect of Lisp (q.v.@:) much larger and more powerful
229than Emacs Lisp. Emacs provides a subset of Common Lisp in the CL
230package. @xref{Top, Common Lisp, Overview, cl, Common Lisp Extensions}.
231
f99f1641 232@anchor{Glossary---Compilation}
8cf51b2c
GM
233@item Compilation
234Compilation is the process of creating an executable program from source
235code. Emacs has commands for compiling files of Emacs Lisp code
236(@pxref{Byte Compilation,,, elisp, the Emacs Lisp
237Reference Manual}) and programs in C and other languages
238(@pxref{Compilation}).
239
240@item Complete Key
8bf27c8a 241A complete key is a key sequence that fully specifies one action to be
8cf51b2c
GM
242performed by Emacs. For example, @kbd{X} and @kbd{C-f} and @kbd{C-x m}
243are complete keys. Complete keys derive their meanings from being bound
1df7defd 244(q.v.@:) to commands (q.v.). Thus, @kbd{X} is conventionally bound to
8cf51b2c
GM
245a command to insert @samp{X} in the buffer; @kbd{C-x m} is
246conventionally bound to a command to begin composing a mail message.
247@xref{Keys}.
248
249@item Completion
07ee224d 250Completion is what Emacs does when it automatically expands an
8cf51b2c
GM
251abbreviation for a name into the entire name. Completion is done for
252minibuffer (q.v.@:) arguments when the set of possible valid inputs
253is known; for example, on command names, buffer names, and
07ee224d
GM
254file names. Completion usually occurs when @key{TAB}, @key{SPC} or
255@key{RET} is typed. @xref{Completion}.@refill
8cf51b2c 256
f99f1641 257@anchor{Glossary---Continuation Line}
8cf51b2c
GM
258@item Continuation Line
259When a line of text is longer than the width of the window, it
f99f1641 260normally (but see @ref{Glossary---Truncation}) takes up more than one
6cac07d8 261screen line when displayed. We say that the text line is continued, and all
07ee224d
GM
262screen lines used for it after the first are called continuation
263lines. @xref{Continuation Lines}. A related Emacs feature is
1df7defd 264`filling' (q.v.).
8cf51b2c
GM
265
266@item Control Character
267A control character is a character that you type by holding down the
268@key{CTRL} key. Some control characters also have their own keys, so
269that you can type them without using @key{CTRL}. For example,
270@key{RET}, @key{TAB}, @key{ESC} and @key{DEL} are all control
271characters. @xref{User Input}.
272
273@item Copyleft
274A copyleft is a notice giving the public legal permission to
275redistribute and modify a program or other work of art, but requiring
276modified versions to carry similar permission. Copyright is normally
277used to keep users divided and helpless; with copyleft we turn that
278around to empower users and encourage them to cooperate.
279
280The particular form of copyleft used by the GNU project is called the
281GNU General Public License. @xref{Copying}.
282
283@item @key{CTRL}
284The @key{CTRL} or ``control'' key is what you hold down
f99f1641 285in order to enter a control character (q.v.). @xref{Glossary---C-}.
8cf51b2c
GM
286
287@item Current Buffer
288The current buffer in Emacs is the Emacs buffer on which most editing
289commands operate. You can select any Emacs buffer as the current one.
290@xref{Buffers}.
291
292@item Current Line
293The current line is the line that point is on (@pxref{Point}).
294
295@item Current Paragraph
296The current paragraph is the paragraph that point is in. If point is
297between two paragraphs, the current paragraph is the one that follows
298point. @xref{Paragraphs}.
299
300@item Current Defun
301The current defun is the defun (q.v.@:) that point is in. If point is
302between defuns, the current defun is the one that follows point.
303@xref{Defuns}.
304
305@item Cursor
306The cursor is the rectangle on the screen which indicates the position
07ee224d 307(called point; q.v.@:) at which insertion and deletion takes place.
8cf51b2c
GM
308The cursor is on or under the character that follows point. Often
309people speak of `the cursor' when, strictly speaking, they mean
8bf27c8a 310`point'. @xref{Point,Cursor}.
8cf51b2c
GM
311
312@item Customization
07ee224d
GM
313Customization is making minor changes in the way Emacs works, to
314reflect your preferences or needs. It is often done by setting
315variables (@pxref{Variables}) or faces (@pxref{Face Customization}),
316or by rebinding key sequences (@pxref{Keymaps}).
8cf51b2c
GM
317
318@cindex cut and paste
319@item Cut and Paste
f99f1641 320@xref{Glossary---Killing}, and @ref{Glossary---Yanking}.
8cf51b2c 321
f99f1641 322@anchor{Glossary---Daemon}
07ee224d 323@item Daemon
bd8aaa36 324A daemon is a standard term for a system-level process that runs in the
07ee224d
GM
325background. Daemons are often started when the system first starts up.
326When Emacs runs in daemon-mode, it runs in the background and does not
327open a display. You can then connect to it with the
328@command{emacsclient} program. @xref{Emacs Server}.
329
8cf51b2c
GM
330@item Default Argument
331The default for an argument is the value that will be assumed if you
332do not specify one. When the minibuffer is used to read an argument,
333the default argument is used if you just type @key{RET}.
334@xref{Minibuffer}.
335
f99f1641 336@anchor{Glossary---Default}
8cf51b2c 337@item Default
8bf27c8a
GM
338A default is the value that is used for a certain purpose when
339you do not explicitly specify a value to use.
8cf51b2c
GM
340
341@item Default Directory
342When you specify a file name that does not start with @samp{/} or @samp{~},
343it is interpreted relative to the current buffer's default directory.
8bf27c8a 344(On MS systems, file names that start with a drive letter
8cf51b2c
GM
345@samp{@var{x}:} are treated as absolute, not relative.)
346@xref{Minibuffer File,Default Directory}.
347
348@item Defun
349A defun is a major definition at the top level in a program. The name
350`defun' comes from Lisp, where most such definitions use the construct
351@code{defun}. @xref{Defuns}.
352
353@item @key{DEL}
354@key{DEL} is a character that runs the command to delete one character
355of text before the cursor. It is typically either the @key{DELETE}
356key or the @key{BACKSPACE} key, whichever one is easy to type.
357@xref{Erasing,DEL}.
358
359@item Deletion
360Deletion means erasing text without copying it into the kill ring
1df7defd 361(q.v.). The alternative is killing (q.v.). @xref{Killing,Deletion}.
8cf51b2c 362
f99f1641 363@anchor{Glossary---Deletion of Files}
8cf51b2c
GM
364@item Deletion of Files
365Deleting a file means erasing it from the file system.
07ee224d
GM
366(Note that some systems use the concept of a ``trash can'', or ``recycle
367bin'', to allow you to ``undelete'' files.)
8cf51b2c
GM
368@xref{Misc File Ops,Misc File Ops,Miscellaneous File Operations}.
369
370@item Deletion of Messages
07ee224d
GM
371Deleting a message (in Rmail, and other mail clients) means flagging
372it to be eliminated from your mail file. Until you expunge (q.v.@:)
373the Rmail file, you can still undelete the messages you have deleted.
374@xref{Rmail Deletion}.
8cf51b2c
GM
375
376@item Deletion of Windows
377Deleting a window means eliminating it from the screen. Other windows
07ee224d
GM
378expand to use up the space. The text that was in the window is not
379lost, and you can create a new window with the same dimensions as the
380old if you wish. @xref{Windows}.
8cf51b2c
GM
381
382@item Directory
383File directories are named collections in the file system, within which
07ee224d 384you can place individual files or subdirectories. They are sometimes
8bf27c8a 385referred to as ``folders''. @xref{Directories}.
8cf51b2c 386
f99f1641 387@anchor{Glossary---Directory Local Variable}
a0706406
GM
388@item Directory Local Variable
389A directory local variable is a local variable (q.v.@:) that applies
390to all the files within a certain directory. @xref{Directory
391Variables}.
392
8cf51b2c
GM
393@item Dired
394Dired is the Emacs facility that displays the contents of a file
8bf27c8a 395directory and allows you to ``edit the directory'', performing
8cf51b2c
GM
396operations on the files in the directory. @xref{Dired}.
397
398@item Disabled Command
399A disabled command is one that you may not run without special
400confirmation. The usual reason for disabling a command is that it is
401confusing for beginning users. @xref{Disabling}.
402
403@item Down Event
1df7defd 404Short for `button down event' (q.v.).
8cf51b2c
GM
405
406@item Drag Event
07ee224d
GM
407A drag event is the kind of input event (q.v.@:) generated when you
408press a mouse button, move the mouse, and then release the button.
409@xref{Mouse Buttons}.
8cf51b2c
GM
410
411@item Dribble File
412A dribble file is a file into which Emacs writes all the characters that
07ee224d 413you type on the keyboard. Dribble files can be used to make a record
8cf51b2c
GM
414for debugging Emacs bugs. Emacs does not make a dribble file unless you
415tell it to. @xref{Bugs}.
416
a0706406
GM
417@c TODO? Not really appropriate for the user manual I think.
418@c Dynamic Binding
419
8cf51b2c
GM
420@item Echo Area
421The echo area is the bottom line of the screen, used for echoing the
422arguments to commands, for asking questions, and showing brief messages
423(including error messages). The messages are stored in the buffer
1c64e6ed 424@file{*Messages*} so you can review them later. @xref{Echo Area}.
8cf51b2c
GM
425
426@item Echoing
427Echoing is acknowledging the receipt of input events by displaying
428them (in the echo area). Emacs never echoes single-character key
429sequences; longer key sequences echo only if you pause while typing
430them.
431
432@item Electric
433We say that a character is electric if it is normally self-inserting
1df7defd 434(q.v.), but the current major mode (q.v.@:) redefines it to do something
8cf51b2c 435else as well. For example, some programming language major modes define
07ee224d 436particular delimiter characters to reindent the line, or insert one or
8cf51b2c
GM
437more newlines in addition to self-insertion.
438
f99f1641 439@anchor{Glossary---End Of Line}
8cf51b2c
GM
440@item End Of Line
441End of line is a character or a sequence of characters that indicate
442the end of a text line. On GNU and Unix systems, this is a newline
1df7defd 443(q.v.), but other systems have other conventions. @xref{Coding
8cf51b2c
GM
444Systems,end-of-line}. Emacs can recognize several end-of-line
445conventions in files and convert between them.
446
447@item Environment Variable
448An environment variable is one of a collection of variables stored by
449the operating system, each one having a name and a value. Emacs can
450access environment variables set by its parent shell, and it can set
451variables in the environment it passes to programs it invokes.
452@xref{Environment}.
453
454@item EOL
f99f1641 455@xref{Glossary---End Of Line}.
8cf51b2c
GM
456
457@item Error
458An error occurs when an Emacs command cannot execute in the current
459circumstances. When an error occurs, execution of the command stops
460(unless the command has been programmed to do otherwise) and Emacs
1df7defd 461reports the error by displaying an error message (q.v.).
07ee224d
GM
462@c Not helpful?
463@c Type-ahead is discarded. Then Emacs is ready to read another
464@c editing command.
8cf51b2c
GM
465
466@item Error Message
07ee224d
GM
467An error message is output displayed by Emacs when you ask it to do
468something impossible (such as, killing text forward when point is at
469the end of the buffer), or when a command malfunctions in some way.
470Such messages appear in the echo area, accompanied by a beep.
8cf51b2c
GM
471
472@item @key{ESC}
473@key{ESC} is a character used as a prefix for typing Meta characters on
474keyboards lacking a @key{META} key. Unlike the @key{META} key (which,
475like the @key{SHIFT} key, is held down while another character is
476typed), you press the @key{ESC} key as you would press a letter key, and
477it applies to the next character you type.
478
479@item Expression
f99f1641 480@xref{Glossary---Balanced Expression}.
8cf51b2c
GM
481
482@item Expunging
07ee224d
GM
483Expunging an Rmail, Gnus newsgroup, or Dired buffer is an operation
484that truly discards the messages or files you have previously flagged
485for deletion.
8cf51b2c
GM
486
487@item Face
488A face is a style of displaying characters. It specifies attributes
489such as font family and size, foreground and background colors,
490underline and strike-through, background stipple, etc. Emacs provides
491features to associate specific faces with portions of buffer text, in
492order to display that text as specified by the face attributes.
493@xref{Faces}.
494
a0706406
GM
495@item File Local Variable
496A file local variable is a local variable (q.v.@:) specified in a
f99f1641 497given file. @xref{File Variables}, and @ref{Glossary---Directory
6cac07d8 498Local Variable}.
a0706406 499
f99f1641 500@anchor{Glossary---File Locking}
8cf51b2c
GM
501@item File Locking
502Emacs uses file locking to notice when two different users
503start to edit one file at the same time. @xref{Interlocking}.
504
505@item File Name
a0706406 506@c This is fairly tautological...
8cf51b2c
GM
507A file name is a name that refers to a file. File names may be relative
508or absolute; the meaning of a relative file name depends on the current
509directory, but an absolute file name refers to the same file regardless
510of which directory is current. On GNU and Unix systems, an absolute
511file name starts with a slash (the root directory) or with @samp{~/} or
512@samp{~@var{user}/} (a home directory). On MS-Windows/MS-DOS, an
1df7defd 513absolute file name can also start with a drive letter and a colon, e.g.,
8cf51b2c
GM
514@samp{@var{d}:}.
515
516Some people use the term ``pathname'' for file names, but we do not;
1df7defd 517we use the word ``path'' only in the term ``search path'' (q.v.).
8cf51b2c
GM
518
519@item File-Name Component
520A file-name component names a file directly within a particular
521directory. On GNU and Unix systems, a file name is a sequence of
522file-name components, separated by slashes. For example, @file{foo/bar}
523is a file name containing two components, @samp{foo} and @samp{bar}; it
524refers to the file named @samp{bar} in the directory named @samp{foo} in
525the current directory. MS-DOS/MS-Windows file names can also use
526backslashes to separate components, as in @file{foo\bar}.
527
528@item Fill Prefix
529The fill prefix is a string that should be expected at the beginning
530of each line when filling is done. It is not regarded as part of the
531text to be filled. @xref{Filling}.
532
f99f1641 533@anchor{Glossary---Filling}
8cf51b2c 534@item Filling
07ee224d
GM
535Filling text means adjusting the position of line-breaks to shift text
536between consecutive lines, so that all the lines are approximately the
537same length. @xref{Filling}. Some other editors call this feature
a0706406 538``line wrapping''.
8cf51b2c 539
f99f1641 540@anchor{Glossary---Font Lock}
8cf51b2c 541@item Font Lock
07ee224d 542Font Lock is a mode that highlights parts of buffer text in different
a0706406
GM
543faces, according to the syntax. Some other editors refer to this as
544``syntax highlighting''. For example, all comments (q.v.@:)
07ee224d 545might be colored red. @xref{Font Lock}.
8cf51b2c
GM
546
547@item Fontset
548A fontset is a named collection of fonts. A fontset specification lists
549character sets and which font to use to display each of them. Fontsets
550make it easy to change several fonts at once by specifying the name of a
551fontset, rather than changing each font separately. @xref{Fontsets}.
552
8cf51b2c 553@item Formfeed Character
f99f1641 554@xref{Glossary---Page}.
8cf51b2c
GM
555
556@item Frame
557A frame is a rectangular cluster of Emacs windows. Emacs starts out
558with one frame, but you can create more. You can subdivide each frame
1df7defd
PE
559into Emacs windows (q.v.). When you are using a window system
560(q.v.), more than one frame can be visible at the same time.
8cf51b2c
GM
561@xref{Frames}. Some other editors use the term ``window'' for this,
562but in Emacs a window means something else.
563
07ee224d
GM
564@item Free Software
565Free software is software that gives you the freedom to share, study
566and modify it. Emacs is free software, part of the GNU project
1df7defd 567(q.v.), and distributed under a copyleft (q.v.@:) license called the
07ee224d
GM
568GNU General Public License. @xref{Copying}.
569
f99f1641 570@anchor{Glossary---Free Software Foundation}
07ee224d
GM
571@item Free Software Foundation
572The Free Software Foundation (FSF) is a charitable foundation
1df7defd 573dedicated to promoting the development of free software (q.v.).
07ee224d
GM
574For more information, see @uref{http://fsf.org/, the FSF website}.
575
8cf51b2c 576@item Fringe
1df7defd 577On a graphical display (q.v.), there's a narrow portion of the frame
07ee224d 578(q.v.@:) between the text area and the window's border. These
a0706406 579``fringes'' are used to display symbols that provide information about
07ee224d
GM
580the buffer text (@pxref{Fringes}). Emacs displays the fringe using a
581special face (q.v.@:) called @code{fringe}. @xref{Faces,fringe}.
582
583@item FSF
f99f1641 584@xref{Glossary---Free Software Foundation}.
8cf51b2c
GM
585
586@item FTP
07ee224d 587FTP is an acronym for File Transfer Protocol. This is one standard
1df7defd 588method for retrieving remote files (q.v.).
8cf51b2c
GM
589
590@item Function Key
591A function key is a key on the keyboard that sends input but does not
592correspond to any character. @xref{Function Keys}.
593
594@item Global
595Global means ``independent of the current environment; in effect
1df7defd 596throughout Emacs''. It is the opposite of local (q.v.). Particular
8cf51b2c
GM
597examples of the use of `global' appear below.
598
599@item Global Abbrev
600A global definition of an abbrev (q.v.@:) is effective in all major
601modes that do not have local (q.v.@:) definitions for the same abbrev.
602@xref{Abbrevs}.
603
604@item Global Keymap
605The global keymap (q.v.@:) contains key bindings that are in effect
07ee224d 606everywhere, except when overridden by local key bindings in a major
1df7defd 607mode's local keymap (q.v.). @xref{Keymaps}.
8cf51b2c
GM
608
609@item Global Mark Ring
610The global mark ring records the series of buffers you have recently
611set a mark (q.v.@:) in. In many cases you can use this to backtrack
07ee224d 612through buffers you have been editing, or in which you have found
f99f1641 613tags (@pxref{Glossary---Tags Table}). @xref{Global Mark Ring}.
8cf51b2c 614
f99f1641 615@anchor{Glossary---Global Substitution}
8cf51b2c
GM
616@item Global Substitution
617Global substitution means replacing each occurrence of one string by
618another string throughout a large amount of text. @xref{Replace}.
619
620@item Global Variable
621The global value of a variable (q.v.@:) takes effect in all buffers
622that do not have their own local (q.v.@:) values for the variable.
623@xref{Variables}.
624
07ee224d 625@item GNU
bd8aaa36 626GNU is a recursive acronym for GNU's Not Unix, and it refers to a
1df7defd 627Unix-compatible operating system which is free software (q.v.).
bd8aaa36
RS
628@xref{Manifesto}. GNU is normally used with Linux as the kernel since
629Linux works better than the GNU kernel. For more information, see
07ee224d
GM
630@uref{http://www.gnu.org/, the GNU website}.
631
8cf51b2c
GM
632@item Graphic Character
633Graphic characters are those assigned pictorial images rather than
634just names. All the non-Meta (q.v.@:) characters except for the
635Control (q.v.@:) characters are graphic characters. These include
636letters, digits, punctuation, and spaces; they do not include
637@key{RET} or @key{ESC}. In Emacs, typing a graphic character inserts
638that character (in ordinary editing modes). @xref{Inserting Text}.
639
640@item Graphical Display
641A graphical display is one that can display images and multiple fonts.
1df7defd 642Usually it also has a window system (q.v.).
8cf51b2c
GM
643
644@item Highlighting
645Highlighting text means displaying it with a different foreground and/or
646background color to make it stand out from the rest of the text in the
647buffer.
648
c8388862
CY
649Emacs uses highlighting in several ways. It highlights the region
650whenever it is active (@pxref{Mark}). Incremental search also
f99f1641 651highlights matches (@pxref{Incremental Search}). @xref{Glossary---Font Lock}.
8cf51b2c
GM
652
653@item Hardcopy
07ee224d
GM
654Hardcopy means printed output. Emacs has various commands for
655printing the contents of Emacs buffers. @xref{Printing}.
8cf51b2c
GM
656
657@item @key{HELP}
658@key{HELP} is the Emacs name for @kbd{C-h} or @key{F1}. You can type
a0706406 659@key{HELP} at any time to ask what options you have, or to ask what a
8cf51b2c
GM
660command does. @xref{Help}.
661
662@item Help Echo
07ee224d
GM
663Help echo is a short message displayed in the echo area (q.v.@:) when
664the mouse pointer is located on portions of display that require some
8cf51b2c 665explanations. Emacs displays help echo for menu items, parts of the
a0706406 666mode line, tool-bar buttons, etc. On graphical displays, the messages
1df7defd 667can be displayed as tooltips (q.v.). @xref{Tooltips}.
8cf51b2c 668
07ee224d
GM
669@item Home Directory
670Your home directory contains your personal files. On a multi-user GNU
671or Unix system, each user has his or her own home directory. When you
672start a new login session, your home directory is the default
673directory in which to start. A standard shorthand for your home
674directory is @samp{~}. Similarly, @samp{~@var{user}} represents the
675home directory of some other user.
676
8cf51b2c
GM
677@item Hook
678A hook is a list of functions to be called on specific occasions, such
679as saving a buffer in a file, major mode activation, etc. By
680customizing the various hooks, you can modify Emacs's behavior without
681changing any of its code. @xref{Hooks}.
682
683@item Hyper
07ee224d 684Hyper is the name of a modifier bit that a keyboard input character may
8cf51b2c
GM
685have. To make a character Hyper, type it while holding down the
686@key{HYPER} key. Such characters are given names that start with
07ee224d 687@kbd{Hyper-} (usually written @kbd{H-} for short). @xref{User Input}.
8cf51b2c
GM
688
689@item Iff
8bf27c8a 690``Iff'' means ``if and only if''. This terminology comes from
8cf51b2c
GM
691mathematics. Try to avoid using this term in documentation, since
692many are unfamiliar with it and mistake it for a typo.
693
694@item Inbox
695An inbox is a file in which mail is delivered by the operating system.
a0706406 696Rmail transfers mail from inboxes to Rmail files in which the
8cf51b2c
GM
697mail is then stored permanently or until explicitly deleted.
698@xref{Rmail Inbox}.
699
f99f1641 700@anchor{Glossary---Incremental Search}
8cf51b2c 701@item Incremental Search
07ee224d
GM
702Emacs provides an incremental search facility, whereby Emacs begins
703searching for a string as soon as you type the first character.
704As you type more characters, it refines the search. @xref{Incremental Search}.
8cf51b2c
GM
705
706@item Indentation
707Indentation means blank space at the beginning of a line. Most
708programming languages have conventions for using indentation to
709illuminate the structure of the program, and Emacs has special
710commands to adjust indentation.
711@xref{Indentation}.
712
713@item Indirect Buffer
714An indirect buffer is a buffer that shares the text of another buffer,
1df7defd 715called its base buffer (q.v.). @xref{Indirect Buffers}.
8cf51b2c
GM
716
717@item Info
718Info is the hypertext format used by the GNU project for writing
719documentation.
720
721@item Input Event
722An input event represents, within Emacs, one action taken by the user on
723the terminal. Input events include typing characters, typing function
724keys, pressing or releasing mouse buttons, and switching between Emacs
725frames. @xref{User Input}.
726
727@item Input Method
728An input method is a system for entering non-@acronym{ASCII} text characters by
1df7defd 729typing sequences of @acronym{ASCII} characters (q.v.). @xref{Input Methods}.
8cf51b2c
GM
730
731@item Insertion
07ee224d 732Insertion means adding text into the buffer, either from the keyboard
8cf51b2c
GM
733or from some other place in Emacs.
734
735@item Interlocking
f99f1641 736@xref{Glossary---File Locking}.
8cf51b2c
GM
737
738@item Isearch
f99f1641 739@xref{Glossary---Incremental Search}.
8cf51b2c
GM
740
741@item Justification
8863a584
CY
742Justification means adding extra spaces within lines of text in order
743to adjust the position of the text edges. @xref{Fill Commands}.
8cf51b2c 744
5a331f34 745@item Key Binding
f99f1641 746@xref{Glossary---Binding}.
8cf51b2c
GM
747
748@item Keyboard Macro
749Keyboard macros are a way of defining new Emacs commands from
750sequences of existing ones, with no need to write a Lisp program.
07ee224d
GM
751You can use a macro to record a sequence of commands, then
752play them back as many times as you like.
8cf51b2c
GM
753@xref{Keyboard Macros}.
754
755@cindex keyboard shortcuts
756@item Keyboard Shortcut
a0706406 757A keyboard shortcut is a key sequence (q.v.@:) that invokes a
8bf27c8a 758command. What some programs call ``assigning a keyboard shortcut'',
f99f1641 759Emacs calls ``binding a key sequence''. @xref{Glossary---Binding}.
8cf51b2c
GM
760
761@item Key Sequence
762A key sequence (key, for short) is a sequence of input events (q.v.@:)
763that are meaningful as a single unit. If the key sequence is enough to
1df7defd
PE
764specify one action, it is a complete key (q.v.); if it is not enough,
765it is a prefix key (q.v.). @xref{Keys}.
8cf51b2c
GM
766
767@item Keymap
768The keymap is the data structure that records the bindings (q.v.@:) of
769key sequences to the commands that they run. For example, the global
770keymap binds the character @kbd{C-n} to the command function
771@code{next-line}. @xref{Keymaps}.
772
773@item Keyboard Translation Table
774The keyboard translation table is an array that translates the character
775codes that come from the terminal into the character codes that make up
776key sequences.
777
778@item Kill Ring
f99f1641 779The kill ring is where all text you have killed (@pxref{Glossary---Killing})
a0706406 780recently is saved. You can reinsert any of the killed text still in
1df7defd 781the ring; this is called yanking (q.v.). @xref{Yanking}.
8cf51b2c 782
f99f1641 783@anchor{Glossary---Killing}
8cf51b2c
GM
784@item Killing
785Killing means erasing text and saving it on the kill ring so it can be
8bf27c8a 786yanked (q.v.@:) later. Some other systems call this ``cutting''.
8cf51b2c 787Most Emacs commands that erase text perform killing, as opposed to
1df7defd 788deletion (q.v.). @xref{Killing}.
8cf51b2c
GM
789
790@item Killing a Job
791Killing a job (such as, an invocation of Emacs) means making it cease
792to exist. Any data within it, if not saved in a file, is lost.
793@xref{Exiting}.
794
795@item Language Environment
796Your choice of language environment specifies defaults for the input
1df7defd 797method (q.v.@:) and coding system (q.v.). @xref{Language
07ee224d
GM
798Environments}. These defaults are relevant if you edit
799non-@acronym{ASCII} text (@pxref{International}).
8cf51b2c 800
a0706406
GM
801@c TODO? Not really appropriate for the user manual I think.
802@c Lexical Binding
803
8cf51b2c 804@item Line Wrapping
f99f1641 805@xref{Glossary---Filling}.
8cf51b2c
GM
806
807@item Lisp
808Lisp is a programming language. Most of Emacs is written in a dialect
07ee224d 809of Lisp, called Emacs Lisp, which is extended with special features that
8cf51b2c
GM
810make it especially suitable for text editing tasks.
811
812@item List
813A list is, approximately, a text string beginning with an open
814parenthesis and ending with the matching close parenthesis. In C mode
815and other non-Lisp modes, groupings surrounded by other kinds of matched
816delimiters appropriate to the language, such as braces, are also
817considered lists. Emacs has special commands for many operations on
818lists. @xref{Moving by Parens}.
819
820@item Local
821Local means ``in effect only in a particular context''; the relevant
822kind of context is a particular function execution, a particular
823buffer, or a particular major mode. It is the opposite of `global'
1df7defd 824(q.v.). Specific uses of `local' in Emacs terminology appear below.
8cf51b2c
GM
825
826@item Local Abbrev
827A local abbrev definition is effective only if a particular major mode
828is selected. In that major mode, it overrides any global definition
829for the same abbrev. @xref{Abbrevs}.
830
831@item Local Keymap
832A local keymap is used in a particular major mode; the key bindings
833(q.v.@:) in the current local keymap override global bindings of the
834same key sequences. @xref{Keymaps}.
835
836@item Local Variable
837A local value of a variable (q.v.@:) applies to only one buffer.
838@xref{Locals}.
839
840@item @kbd{M-}
841@kbd{M-} in the name of a character is an abbreviation for @key{META},
842one of the modifier keys that can accompany any character.
843@xref{User Input,M-}.
844
845@item @kbd{M-C-}
846@kbd{M-C-} in the name of a character is an abbreviation for
1df7defd 847Control-Meta; it means the same thing as `@kbd{C-M-}' (q.v.).
8cf51b2c
GM
848
849@item @kbd{M-x}
07ee224d 850@kbd{M-x} is the key sequence that is used to call an Emacs command by
8cf51b2c
GM
851name. This is how you run commands that are not bound to key sequences.
852@xref{M-x,M-x,Running Commands by Name}.
853
f99f1641 854@anchor{Glossary---Mail}
8cf51b2c
GM
855@item Mail
856Mail means messages sent from one user to another through the computer
857system, to be read at the recipient's convenience. Emacs has commands for
858composing and sending mail, and for reading and editing the mail you have
07ee224d
GM
859received. @xref{Sending Mail}. @xref{Rmail}, for one way to read
860mail with Emacs.
8cf51b2c
GM
861
862@item Mail Composition Method
863A mail composition method is a program runnable within Emacs for editing
864and sending a mail message. Emacs lets you select from several
865alternative mail composition methods. @xref{Mail Methods}.
866
867@item Major Mode
868The Emacs major modes are a mutually exclusive set of options, each of
869which configures Emacs for editing a certain sort of text. Ideally,
870each programming language has its own major mode. @xref{Major Modes}.
871
872@item Margin
873The space between the usable part of a window (including the
874fringe) and the window edge.
875
876@item Mark
877The mark points to a position in the text. It specifies one end of the
1df7defd 878region (q.v.), point being the other end. Many commands operate on
8cf51b2c
GM
879all the text from point to the mark. Each buffer has its own mark.
880@xref{Mark}.
881
882@item Mark Ring
883The mark ring is used to hold several recent previous locations of the
a0706406 884mark, in case you want to move back to them. Each buffer has its
1df7defd 885own mark ring; in addition, there is a single global mark ring (q.v.).
8cf51b2c
GM
886@xref{Mark Ring}.
887
888@item Menu Bar
07ee224d 889The menu bar is a line at the top of an Emacs frame. It contains
8cf51b2c
GM
890words you can click on with the mouse to bring up menus, or you can use
891a keyboard interface to navigate it. @xref{Menu Bars}.
892
893@item Message
f99f1641 894@xref{Glossary---Mail}.
8cf51b2c
GM
895
896@item Meta
897Meta is the name of a modifier bit which you can use in a command
898character. To enter a meta character, you hold down the @key{META}
899key while typing the character. We refer to such characters with
900names that start with @kbd{Meta-} (usually written @kbd{M-} for
901short). For example, @kbd{M-<} is typed by holding down @key{META}
902and at the same time typing @kbd{<} (which itself is done, on most
903terminals, by holding down @key{SHIFT} and typing @kbd{,}).
904@xref{User Input,Meta}.
905
906On some terminals, the @key{META} key is actually labeled @key{ALT}
907or @key{EDIT}.
908
909@item Meta Character
910A Meta character is one whose character code includes the Meta bit.
911
912@item Minibuffer
913The minibuffer is the window that appears when necessary inside the
1df7defd 914echo area (q.v.), used for reading arguments to commands.
8cf51b2c
GM
915@xref{Minibuffer}.
916
f99f1641 917@anchor{Glossary---Minibuffer History}
8cf51b2c
GM
918@item Minibuffer History
919The minibuffer history records the text you have specified in the past
920for minibuffer arguments, so you can conveniently use the same text
921again. @xref{Minibuffer History}.
922
923@item Minor Mode
a0706406 924A minor mode is an optional feature of Emacs, which can be switched on
8cf51b2c 925or off independently of all other features. Each minor mode has a
1df7defd
PE
926command to turn it on or off. Some minor modes are global (q.v.),
927and some are local (q.v.). @xref{Minor Modes}.
8cf51b2c
GM
928
929@item Minor Mode Keymap
930A minor mode keymap is a keymap that belongs to a minor mode and is
931active when that mode is enabled. Minor mode keymaps take precedence
932over the buffer's local keymap, just as the local keymap takes
933precedence over the global keymap. @xref{Keymaps}.
934
935@item Mode Line
1df7defd 936The mode line is the line at the bottom of each window (q.v.), giving
8cf51b2c
GM
937status information on the buffer displayed in that window. @xref{Mode
938Line}.
939
940@item Modified Buffer
941A buffer (q.v.@:) is modified if its text has been changed since the
07ee224d 942last time the buffer was saved (or since it was created, if it
8cf51b2c
GM
943has never been saved). @xref{Saving}.
944
945@item Moving Text
946Moving text means erasing it from one place and inserting it in
947another. The usual way to move text is by killing (q.v.@:) it and then
948yanking (q.v.@:) it. @xref{Killing}.
949
950@item MULE
07ee224d 951MULE refers to the Emacs features for editing multilingual
1df7defd 952non-@acronym{ASCII} text using multibyte characters (q.v.).
07ee224d 953@xref{International}.
8cf51b2c
GM
954
955@item Multibyte Character
956A multibyte character is a character that takes up several bytes in a
957buffer. Emacs uses multibyte characters to represent non-@acronym{ASCII} text,
958since the number of non-@acronym{ASCII} characters is much more than 256.
959@xref{International Chars, International Characters}.
960
961@item Named Mark
1df7defd 962A named mark is a register (q.v.), in its role of recording a
8cf51b2c
GM
963location in text so that you can move point to that location.
964@xref{Registers}.
965
966@item Narrowing
967Narrowing means creating a restriction (q.v.@:) that limits editing in
07ee224d
GM
968the current buffer to only a part of the text. Text outside that part
969is inaccessible for editing (or viewing) until the boundaries are
8cf51b2c
GM
970widened again, but it is still there, and saving the file saves it
971all. @xref{Narrowing}.
972
973@item Newline
974Control-J characters in the buffer terminate lines of text and are
f99f1641 975therefore also called newlines. @xref{Glossary---End Of Line}.
8cf51b2c
GM
976
977@cindex nil
978@cindex t
979@item @code{nil}
8bf27c8a
GM
980@code{nil} is a value usually interpreted as a logical ``false''. Its
981opposite is @code{t}, interpreted as ``true''.
8cf51b2c 982
f99f1641 983@anchor{Glossary---Numeric Argument}
8cf51b2c
GM
984@item Numeric Argument
985A numeric argument is a number, specified before a command, to change
986the effect of the command. Often the numeric argument serves as a
987repeat count. @xref{Arguments}.
988
989@item Overwrite Mode
990Overwrite mode is a minor mode. When it is enabled, ordinary text
991characters replace the existing text after point rather than pushing
a0706406
GM
992it to one side. @xref{Minor Modes}.
993
994@item Package
995A package is a collection of Lisp code that you download and
996automatically install from within Emacs. Packages provide a
997convenient way to add new features. @xref{Packages}.
8cf51b2c 998
f99f1641 999@anchor{Glossary---Page}
8cf51b2c
GM
1000@item Page
1001A page is a unit of text, delimited by formfeed characters (@acronym{ASCII}
a0706406 1002control-L, code 014) at the beginning of a line. Some Emacs
8cf51b2c
GM
1003commands are provided for moving over and operating on pages.
1004@xref{Pages}.
1005
1006@item Paragraph
1007Paragraphs are the medium-size unit of human-language text. There are
1008special Emacs commands for moving over and operating on paragraphs.
1009@xref{Paragraphs}.
1010
1011@item Parsing
1012We say that certain Emacs commands parse words or expressions in the
1013text being edited. Really, all they know how to do is find the other
6cfd0fa2 1014end of a word or expression.
8cf51b2c
GM
1015
1016@item Point
1017Point is the place in the buffer at which insertion and deletion
1018occur. Point is considered to be between two characters, not at one
1019character. The terminal's cursor (q.v.@:) indicates the location of
1020point. @xref{Point}.
1021
1022@item Prefix Argument
f99f1641 1023@xref{Glossary---Numeric Argument}.
8cf51b2c
GM
1024
1025@item Prefix Key
1026A prefix key is a key sequence (q.v.@:) whose sole function is to
1027introduce a set of longer key sequences. @kbd{C-x} is an example of
1028prefix key; any two-character sequence starting with @kbd{C-x} is
1029therefore a legitimate key sequence. @xref{Keys}.
1030
8bf27c8a
GM
1031@c I don't think this kind of thing needs to be here.
1032@ignore
8cf51b2c
GM
1033@item Primary Rmail File
1034Your primary Rmail file is the file named @samp{RMAIL} in your home
1035directory. That's where Rmail stores your incoming mail, unless you
1036specify a different file name. @xref{Rmail}.
8bf27c8a 1037@end ignore
8cf51b2c
GM
1038
1039@item Primary Selection
1df7defd 1040The primary selection is one particular X selection (q.v.); it is the
8cf51b2c
GM
1041selection that most X applications use for transferring text to and from
1042other applications.
1043
1044The Emacs kill commands set the primary selection and the yank command
1045uses the primary selection when appropriate. @xref{Killing}.
1046
1047@item Prompt
07ee224d 1048A prompt is text used to ask you for input. Displaying a prompt
8cf51b2c 1049is called prompting. Emacs prompts always appear in the echo area
1df7defd 1050(q.v.). One kind of prompting happens when the minibuffer is used to
07ee224d 1051read an argument (@pxref{Minibuffer}); the echoing that happens when
8cf51b2c
GM
1052you pause in the middle of typing a multi-character key sequence is also
1053a kind of prompting (@pxref{Echo Area}).
1054
1055@item Query-Replace
1056Query-replace is an interactive string replacement feature provided by
1057Emacs. @xref{Query Replace}.
1058
f99f1641 1059@anchor{Glossary---Quitting}
8cf51b2c
GM
1060@item Quitting
1061Quitting means canceling a partially typed command or a running
1062command, using @kbd{C-g} (or @kbd{C-@key{BREAK}} on MS-DOS). @xref{Quitting}.
1063
1064@item Quoting
1065Quoting means depriving a character of its usual special significance.
1066The most common kind of quoting in Emacs is with @kbd{C-q}. What
1067constitutes special significance depends on the context and on
1068convention. For example, an ``ordinary'' character as an Emacs command
1069inserts itself; so in this context, a special character is any character
1070that does not normally insert itself (such as @key{DEL}, for example),
1071and quoting it makes it insert itself as if it were not special. Not
1072all contexts allow quoting. @xref{Inserting Text,Quoting}.
1073
1074@item Quoting File Names
1075Quoting a file name turns off the special significance of constructs
1076such as @samp{$}, @samp{~} and @samp{:}. @xref{Quoted File Names}.
1077
1078@item Read-Only Buffer
1079A read-only buffer is one whose text you are not allowed to change.
1080Normally Emacs makes buffers read-only when they contain text which
1081has a special significance to Emacs; for example, Dired buffers.
1082Visiting a file that is write-protected also makes a read-only buffer.
1083@xref{Buffers}.
1084
1085@item Rectangle
1086A rectangle consists of the text in a given range of columns on a given
1087range of lines. Normally you specify a rectangle by putting point at
1088one corner and putting the mark at the diagonally opposite corner.
1089@xref{Rectangles}.
1090
1091@item Recursive Editing Level
1092A recursive editing level is a state in which part of the execution of
1093a command involves asking you to edit some text. This text may
1094or may not be the same as the text to which the command was applied.
1095The mode line indicates recursive editing levels with square brackets
1096(@samp{[} and @samp{]}). @xref{Recursive Edit}.
1097
1098@item Redisplay
1099Redisplay is the process of correcting the image on the screen to
1100correspond to changes that have been made in the text being edited.
1101@xref{Screen,Redisplay}.
1102
1103@item Regexp
f99f1641 1104@xref{Glossary---Regular Expression}.
8cf51b2c
GM
1105
1106@item Region
1df7defd 1107The region is the text between point (q.v.@:) and the mark (q.v.).
8cf51b2c
GM
1108Many commands operate on the text of the region. @xref{Mark,Region}.
1109
1110@item Register
07ee224d 1111Registers are named slots in which text, buffer positions, or
8cf51b2c 1112rectangles can be saved for later use. @xref{Registers}. A related
1df7defd 1113Emacs feature is `bookmarks' (q.v.).
8cf51b2c 1114
f99f1641 1115@anchor{Glossary---Regular Expression}
8cf51b2c
GM
1116@item Regular Expression
1117A regular expression is a pattern that can match various text strings;
1118for example, @samp{a[0-9]+} matches @samp{a} followed by one or more
1119digits. @xref{Regexps}.
1120
1121@item Remote File
1122A remote file is a file that is stored on a system other than your own.
1123Emacs can access files on other computers provided that they are
1124connected to the same network as your machine, and (obviously) that
1125you have a supported method to gain access to those files.
1126@xref{Remote Files}.
1127
1128@item Repeat Count
f99f1641 1129@xref{Glossary---Numeric Argument}.
8cf51b2c
GM
1130
1131@item Replacement
f99f1641 1132@xref{Glossary---Global Substitution}.
8cf51b2c
GM
1133
1134@item Restriction
1135A buffer's restriction is the amount of text, at the beginning or the
1136end of the buffer, that is temporarily inaccessible. Giving a buffer a
1df7defd
PE
1137nonzero amount of restriction is called narrowing (q.v.); removing
1138a restriction is called widening (q.v.). @xref{Narrowing}.
8cf51b2c
GM
1139
1140@item @key{RET}
1141@key{RET} is a character that in Emacs runs the command to insert a
1142newline into the text. It is also used to terminate most arguments
1df7defd 1143read in the minibuffer (q.v.). @xref{User Input,Return}.
8cf51b2c
GM
1144
1145@item Reverting
1146Reverting means returning to the original state. Emacs lets you
1147revert a buffer by re-reading its file from disk. @xref{Reverting}.
1148
8bf27c8a
GM
1149@c Seems too obvious, also there is nothing special about the format
1150@c these days.
1151@ignore
8cf51b2c 1152@item Rmail File
07ee224d 1153An Rmail file is a file containing text in the format used by
8cf51b2c 1154Rmail for storing mail. @xref{Rmail}.
8bf27c8a 1155@end ignore
8cf51b2c
GM
1156
1157@item Saving
1158Saving a buffer means copying its text into the file that was visited
1159(q.v.@:) in that buffer. This is the way text in files actually gets
1160changed by your Emacs editing. @xref{Saving}.
1161
1162@item Scroll Bar
1163A scroll bar is a tall thin hollow box that appears at the side of a
1164window. You can use mouse commands in the scroll bar to scroll the
1165window. The scroll bar feature is supported only under windowing
1166systems. @xref{Scroll Bars}.
1167
1168@item Scrolling
1169Scrolling means shifting the text in the Emacs window so as to see a
1170different part of the buffer. @xref{Scrolling}.
1171
1172@item Searching
1173Searching means moving point to the next occurrence of a specified
1174string or the next match for a specified regular expression.
1175@xref{Search}.
1176
1177@item Search Path
1178A search path is a list of directory names, to be used for searching for
1179files for certain purposes. For example, the variable @code{load-path}
1180holds a search path for finding Lisp library files. @xref{Lisp Libraries}.
1181
1182@item Secondary Selection
1df7defd 1183The secondary selection is one particular X selection (q.v.); some X
8cf51b2c
GM
1184applications can use it for transferring text to and from other
1185applications. Emacs has special mouse commands for transferring text
1186using the secondary selection. @xref{Secondary Selection}.
1187
1188@item Selected Frame
1189The selected frame is the one your input currently operates on.
1190@xref{Frames}.
1191
1192@item Selected Window
8dc17977 1193The selected window is the one your input currently operates on.
8cf51b2c
GM
1194@xref{Basic Window}.
1195
1196@item Selecting a Buffer
1197Selecting a buffer means making it the current (q.v.@:) buffer.
1198@xref{Select Buffer}.
1199
1200@item Selection
1201Windowing systems allow an application program to specify
1202selections whose values are text. A program can also read the
1203selections that other programs have set up. This is the principal way
1204of transferring text between window applications. Emacs has commands to
1205work with the primary (q.v.@:) selection and the secondary (q.v.@:)
1df7defd 1206selection, and also with the clipboard (q.v.).
8cf51b2c
GM
1207
1208@item Self-Documentation
07ee224d 1209Self-documentation is the feature of Emacs that can tell you what any
8cf51b2c
GM
1210command does, or give you a list of all commands related to a topic
1211you specify. You ask for self-documentation with the help character,
1212@kbd{C-h}. @xref{Help}.
1213
1214@item Self-Inserting Character
1215A character is self-inserting if typing that character inserts that
1216character in the buffer. Ordinary printing and whitespace characters
1217are self-inserting in Emacs, except in certain special major modes.
1218
1219@item Sentences
1220Emacs has commands for moving by or killing by sentences.
1221@xref{Sentences}.
1222
f99f1641 1223@anchor{Glossary---Server}
a0706406
GM
1224@item Server
1225Within Emacs, you can start a `server' process, which listens for
1226connections from `clients'. This offers a faster alternative to
6cac07d8 1227starting several Emacs instances. @xref{Emacs Server}, and
f99f1641 1228@ref{Glossary---Daemon}.
a0706406
GM
1229
1230@c This is only covered in the lispref, not the user manual.
1231@ignore
1232@item Session Manager
1233Some window systems (q.v.@:) provide a tool called a `session manager'.
1234This offers the ability to save your windows when you log off,
1235and restore them after you log in again.
1236@end ignore
1237
8cf51b2c
GM
1238@item Sexp
1239A sexp (short for ``s-expression'') is the basic syntactic unit of
1240Lisp in its textual form: either a list, or Lisp atom. Sexps are also
1241the balanced expressions (q.v.@:) of the Lisp language; this is why
1242the commands for editing balanced expressions have `sexp' in their
1243name. @xref{Expressions,Sexps}.
1244
1245@item Simultaneous Editing
1246Simultaneous editing means two users modifying the same file at once.
1247Simultaneous editing, if not detected, can cause one user to lose his
1248or her work. Emacs detects all cases of simultaneous editing, and
1249warns one of the users to investigate.
1250@xref{Interlocking,Interlocking,Simultaneous Editing}.
1251
1252@item @key{SPC}
1253@key{SPC} is the space character, which you enter by pressing the
1254space bar.
1255
1256@item Speedbar
1257The speedbar is a special tall frame that provides fast access to Emacs
1258buffers, functions within those buffers, Info nodes, and other
1259interesting parts of text within Emacs. @xref{Speedbar}.
1260
1261@item Spell Checking
1262Spell checking means checking correctness of the written form of each
07ee224d
GM
1263one of the words in a text. Emacs can use various external
1264spelling-checker programs to check the spelling of parts of a buffer
1265via a convenient user interface. @xref{Spelling}.
8cf51b2c
GM
1266
1267@item String
a0706406 1268A string is a kind of Lisp data object that contains a sequence of
8cf51b2c
GM
1269characters. Many Emacs variables are intended to have strings as
1270values. The Lisp syntax for a string consists of the characters in the
1271string with a @samp{"} before and another @samp{"} after. A @samp{"}
1272that is part of the string must be written as @samp{\"} and a @samp{\}
1273that is part of the string must be written as @samp{\\}. All other
1274characters, including newline, can be included just by writing them
1275inside the string; however, backslash sequences as in C, such as
1276@samp{\n} for newline or @samp{\241} using an octal character code, are
1277allowed as well.
1278
1279@item String Substitution
f99f1641 1280@xref{Glossary---Global Substitution}.
8cf51b2c
GM
1281
1282@item Syntax Highlighting
f99f1641 1283@xref{Glossary---Font Lock}.
8cf51b2c
GM
1284
1285@item Syntax Table
1286The syntax table tells Emacs which characters are part of a word,
1287which characters balance each other like parentheses, etc.
6cfd0fa2
CY
1288@xref{Syntax Tables,, Syntax Tables, elisp, The Emacs Lisp Reference
1289Manual}.
8cf51b2c
GM
1290
1291@item Super
07ee224d 1292Super is the name of a modifier bit that a keyboard input character may
8cf51b2c
GM
1293have. To make a character Super, type it while holding down the
1294@key{SUPER} key. Such characters are given names that start with
07ee224d 1295@kbd{Super-} (usually written @kbd{s-} for short). @xref{User Input}.
8cf51b2c
GM
1296
1297@item Suspending
1298Suspending Emacs means stopping it temporarily and returning control
1299to its parent process, which is usually a shell. Unlike killing a job
1df7defd 1300(q.v.), you can later resume the suspended Emacs job without losing
8cf51b2c
GM
1301your buffers, unsaved edits, undo history, etc. @xref{Exiting}.
1302
1303@item @key{TAB}
1304@key{TAB} is the tab character. In Emacs it is typically used for
1305indentation or completion.
1306
f99f1641 1307@anchor{Glossary---Tags Table}
8cf51b2c
GM
1308@item Tags Table
1309A tags table is a file that serves as an index to the function
1310definitions in one or more other files. @xref{Tags}.
1311
1312@item Termscript File
1313A termscript file contains a record of all characters sent by Emacs to
1314the terminal. It is used for tracking down bugs in Emacs redisplay.
1315Emacs does not make a termscript file unless you tell it to.
1316@xref{Bugs}.
1317
1318@item Text
1319`Text' has two meanings (@pxref{Text}):
1320
1321@itemize @bullet
1322@item
1323Data consisting of a sequence of characters, as opposed to binary
1324numbers, executable programs, and the like. The basic contents of an
1325Emacs buffer (aside from the text properties, q.v.@:) are always text
1326in this sense.
1327@item
07ee224d 1328Data consisting of written human language (as opposed to programs),
8cf51b2c
GM
1329or following the stylistic conventions of human language.
1330@end itemize
1331
f99f1641 1332@anchor{Glossary---Text Terminal}
0be641c0
CY
1333@item Text Terminal
1334A text terminal, or character terminal, is a display that is limited
1335to displaying text in character units. Such a terminal cannot control
1336individual pixels it displays. Emacs supports a subset of display
1337features on text terminals.
8cf51b2c
GM
1338
1339@item Text Properties
1340Text properties are annotations recorded for particular characters in
1341the buffer. Images in the buffer are recorded as text properties;
1342they also specify formatting information. @xref{Editing Format Info}.
1343
a0706406
GM
1344@item Theme
1345A theme is a set of customizations (q.v.@:) that give Emacs a
1346particular appearance or behavior. For example, you might use a theme
1df7defd 1347for your favorite set of faces (q.v.).
a0706406 1348
8cf51b2c
GM
1349@item Tool Bar
1350The tool bar is a line (sometimes multiple lines) of icons at the top
1351of an Emacs frame. Clicking on one of these icons executes a command.
1df7defd 1352You can think of this as a graphical relative of the menu bar (q.v.).
8cf51b2c
GM
1353@xref{Tool Bars}.
1354
f99f1641 1355@anchor{Glossary---Tooltips}
8cf51b2c 1356@item Tooltips
07ee224d 1357Tooltips are small windows displaying a help echo (q.v.@:) text, which
8cf51b2c
GM
1358explains parts of the display, lists useful options available via mouse
1359clicks, etc. @xref{Tooltips}.
1360
1361@item Top Level
1362Top level is the normal state of Emacs, in which you are editing the
1363text of the file you have visited. You are at top level whenever you
1364are not in a recursive editing level (q.v.@:) or the minibuffer
1df7defd
PE
1365(q.v.), and not in the middle of a command. You can get back to top
1366level by aborting (q.v.@:) and quitting (q.v.). @xref{Quitting}.
8cf51b2c 1367
a0706406
GM
1368@c FIXME? Transient Mark Mode
1369
8cf51b2c
GM
1370@item Transposition
1371Transposing two units of text means putting each one into the place
1372formerly occupied by the other. There are Emacs commands to transpose
1373two adjacent characters, words, balanced expressions (q.v.@:) or lines
1374(@pxref{Transpose}).
1375
a0706406 1376@item Trash Can
f99f1641 1377@xref{Glossary---Deletion of Files}.
a0706406 1378
f99f1641 1379@anchor{Glossary---Truncation}
8cf51b2c
GM
1380@item Truncation
1381Truncating text lines in the display means leaving out any text on a
1382line that does not fit within the right margin of the window
6cac07d8 1383displaying it. @xref{Continuation Lines,Truncation}, and
f99f1641 1384@ref{Glossary---Continuation Line}.
8cf51b2c
GM
1385
1386@item TTY
f99f1641 1387@xref{Glossary---Text Terminal}.
8cf51b2c
GM
1388
1389@item Undoing
1390Undoing means making your previous editing go in reverse, bringing
1391back the text that existed earlier in the editing session.
1392@xref{Undo}.
1393
07ee224d
GM
1394@item Unix
1395Unix is a class of multi-user computer operating systems with a long
1396history. There are several implementations today. The GNU project
1397(q.v.@:) aims to develop a complete Unix-like operating system that
1df7defd 1398is free software (q.v.).
07ee224d 1399
8cf51b2c
GM
1400@item User Option
1401A user option is a face (q.v.@:) or a variable (q.v.@:) that exists so
1402that you can customize Emacs by setting it to a new value.
1403@xref{Easy Customization}.
1404
1405@item Variable
1406A variable is an object in Lisp that can store an arbitrary value.
1407Emacs uses some variables for internal purposes, and has others (known
07ee224d 1408as `user options'; q.v.@:) just so that you can set their values to
8cf51b2c
GM
1409control the behavior of Emacs. The variables used in Emacs that you
1410are likely to be interested in are listed in the Variables Index in
1411this manual (@pxref{Variable Index}). @xref{Variables}, for
1412information on variables.
1413
1414@item Version Control
1415Version control systems keep track of multiple versions of a source file.
1df7defd 1416They provide a more powerful alternative to keeping backup files (q.v.).
8cf51b2c
GM
1417@xref{Version Control}.
1418
1419@item Visiting
1420Visiting a file means loading its contents into a buffer (q.v.@:)
1421where they can be edited. @xref{Visiting}.
1422
1423@item Whitespace
1424Whitespace is any run of consecutive formatting characters (space,
1425tab, newline, and backspace).
1426
1427@item Widening
1428Widening is removing any restriction (q.v.@:) on the current buffer;
1df7defd 1429it is the opposite of narrowing (q.v.). @xref{Narrowing}.
8cf51b2c
GM
1430
1431@item Window
1432Emacs divides a frame (q.v.@:) into one or more windows, each of which
1433can display the contents of one buffer (q.v.@:) at any time.
1434@xref{Screen}, for basic information on how Emacs uses the screen.
1435@xref{Windows}, for commands to control the use of windows. Some
1436other editors use the term ``window'' for what we call a `frame'
1437(q.v.@:) in Emacs.
1438
1439@item Window System
1440A window system is software that operates on a graphical display
1df7defd 1441(q.v.), to subdivide the screen so that multiple applications can
8cf51b2c
GM
1442have their] own windows at the same time. All modern operating systems
1443include a window system.
1444
1445@item Word Abbrev
f99f1641 1446@xref{Glossary---Abbrev}.
8cf51b2c
GM
1447
1448@item Word Search
1449Word search is searching for a sequence of words, considering the
1450punctuation between them as insignificant. @xref{Word Search}.
1451
f99f1641 1452@anchor{Glossary---Yanking}
8cf51b2c 1453@item Yanking
1df7defd 1454Yanking means reinserting text previously killed (q.v.). It can be
07ee224d 1455used to undo a mistaken kill, or for copying or moving text. Some
8bf27c8a 1456other systems call this ``pasting''. @xref{Yanking}.
8cf51b2c 1457@end table