aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--man/abbrevs.texi10
-rw-r--r--man/building.texi33
-rw-r--r--man/glossary.texi33
-rw-r--r--man/help.texi56
-rw-r--r--man/indent.texi18
-rw-r--r--man/killing.texi54
-rw-r--r--man/major.texi29
-rw-r--r--man/mark.texi44
-rw-r--r--man/mini.texi26
-rw-r--r--man/picture.texi14
-rw-r--r--man/sending.texi16
11 files changed, 172 insertions, 161 deletions
diff --git a/man/abbrevs.texi b/man/abbrevs.texi
index b4dbbdee8e3..9ec427dc1b7 100644
--- a/man/abbrevs.texi
+++ b/man/abbrevs.texi
@@ -123,7 +123,7 @@ read with the minibuffer).
123 123
124 To change the definition of an abbrev, just define a new definition. 124 To change the definition of an abbrev, just define a new definition.
125When the abbrev has a prior definition, the abbrev definition commands 125When the abbrev has a prior definition, the abbrev definition commands
126ask for confirmation for replacing it. 126ask for confirmation before replacing it.
127 127
128 To remove an abbrev definition, give a negative argument to the abbrev 128 To remove an abbrev definition, give a negative argument to the abbrev
129definition command: @kbd{C-u - C-x a g} or @kbd{C-u - C-x a l}. The 129definition command: @kbd{C-u - C-x a g} or @kbd{C-u - C-x a l}. The
@@ -212,7 +212,7 @@ once. This command is effective even if Abbrev mode is not enabled.
212 212
213@table @kbd 213@table @kbd
214@item M-x list-abbrevs 214@item M-x list-abbrevs
215Display a list of all abbrev definitions. With numeric argument, list 215Display a list of all abbrev definitions. With a numeric argument, list
216only local abbrevs. 216only local abbrevs.
217@item M-x edit-abbrevs 217@item M-x edit-abbrevs
218Edit a list of abbrevs; you can add, alter or remove definitions. 218Edit a list of abbrevs; you can add, alter or remove definitions.
@@ -387,8 +387,8 @@ you are expanding.
387@vindex dabbrev-case-fold-search 387@vindex dabbrev-case-fold-search
388 This feature is controlled by the variable 388 This feature is controlled by the variable
389@code{dabbrev-case-fold-search}. If it is @code{t}, case is ignored in 389@code{dabbrev-case-fold-search}. If it is @code{t}, case is ignored in
390this search; if @code{nil}, the word and the expansion must match in 390this search; if it is @code{nil}, the word and the expansion must match
391case. If the value of @code{dabbrev-case-fold-search} is 391in case. If the value of @code{dabbrev-case-fold-search} is
392@code{case-fold-search}, which is true by default, then the variable 392@code{case-fold-search}, which is true by default, then the variable
393@code{case-fold-search} controls whether to ignore case while searching 393@code{case-fold-search} controls whether to ignore case while searching
394for expansions. 394for expansions.
@@ -401,7 +401,7 @@ pattern.
401@vindex dabbrev-case-fold-search 401@vindex dabbrev-case-fold-search
402 The variable @code{dabbrev-case-replace} controls whether to preserve 402 The variable @code{dabbrev-case-replace} controls whether to preserve
403the case pattern of the abbrev. If it is @code{t}, the abbrev's case 403the case pattern of the abbrev. If it is @code{t}, the abbrev's case
404pattern is preserved in most cases; if @code{nil}, the expansion is 404pattern is preserved in most cases; if it is @code{nil}, the expansion is
405always copied verbatim. If the value of @code{dabbrev-case-replace} is 405always copied verbatim. If the value of @code{dabbrev-case-replace} is
406@code{case-replace}, which is true by default, then the variable 406@code{case-replace}, which is true by default, then the variable
407@code{case-replace} controls whether to copy the expansion verbatim. 407@code{case-replace} controls whether to copy the expansion verbatim.
diff --git a/man/building.texi b/man/building.texi
index c4ab97e4dd4..ec8d4e2ac8d 100644
--- a/man/building.texi
+++ b/man/building.texi
@@ -43,7 +43,7 @@ compilation errors occurred.
43@table @kbd 43@table @kbd
44@item M-x compile 44@item M-x compile
45Run a compiler asynchronously under Emacs, with error messages going to 45Run a compiler asynchronously under Emacs, with error messages going to
46@samp{*compilation*} buffer. 46the @samp{*compilation*} buffer.
47@item M-x grep 47@item M-x grep
48Run @code{grep} asynchronously under Emacs, with matching lines 48Run @code{grep} asynchronously under Emacs, with matching lines
49listed in the buffer named @samp{*grep*}. 49listed in the buffer named @samp{*grep*}.
@@ -161,9 +161,10 @@ Visit the locus of the error message that you click on.
161@kindex C-x ` 161@kindex C-x `
162@findex next-error 162@findex next-error
163 You can visit the source for any particular error message by moving 163 You can visit the source for any particular error message by moving
164point in @samp{*compilation*} to that error message and typing @key{RET} 164point in the @samp{*compilation*} buffer to that error message and
165(@code{compile-goto-error}). Or click @kbd{Mouse-2} on the error message; 165typing @key{RET} (@code{compile-goto-error}). Alternatively, you can
166you need not switch to the @samp{*compilation*} buffer first. 166click @kbd{Mouse-2} on the error message; you need not switch to the
167@samp{*compilation*} buffer first.
167 168
168 To parse the compiler error messages sequentially, type @kbd{C-x `} 169 To parse the compiler error messages sequentially, type @kbd{C-x `}
169(@code{next-error}). The character following the @kbd{C-x} is the 170(@code{next-error}). The character following the @kbd{C-x} is the
@@ -284,24 +285,24 @@ to a particular debugger program.
284@table @kbd 285@table @kbd
285@item M-x gdb @key{RET} @var{file} @key{RET} 286@item M-x gdb @key{RET} @var{file} @key{RET}
286@findex gdb 287@findex gdb
287Run GDB as a subprocess of Emacs. This command creates a buffer for 288This command runs GDB as a subprocess of Emacs. It creates a buffer
288input and output to GDB, and switches to it. If a GDB buffer already 289for input and output to GDB, and switches to it. If a GDB buffer
289exists, it just switches to that buffer. 290already exists, it just switches to that buffer.
290 291
291@item M-x dbx @key{RET} @var{file} @key{RET} 292@item M-x dbx @key{RET} @var{file} @key{RET}
292@findex dbx 293@findex dbx
293Similar, but run DBX instead of GDB. 294Similar, but runs DBX instead of GDB.
294 295
295@item M-x xdb @key{RET} @var{file} @key{RET} 296@item M-x xdb @key{RET} @var{file} @key{RET}
296@findex xdb 297@findex xdb
297@vindex gud-xdb-directories 298@vindex gud-xdb-directories
298Similar, but run XDB instead of GDB. Use the variable 299Similar, but runs XDB instead of GDB. Use the variable
299@code{gud-xdb-directories} to specify directories to search for source 300@code{gud-xdb-directories} to specify directories to search for source
300files. 301files.
301 302
302@item M-x sdb @key{RET} @var{file} @key{RET} 303@item M-x sdb @key{RET} @var{file} @key{RET}
303@findex sdb 304@findex sdb
304Similar, but run SDB instead of GDB. 305Similar, but runs SDB instead of GDB.
305 306
306 Some versions of SDB do not mention source file names in their 307 Some versions of SDB do not mention source file names in their
307messages. When you use them, you need to have a valid tags table 308messages. When you use them, you need to have a valid tags table
@@ -345,7 +346,7 @@ displayed in the marginal area of the Emacs window.} Moving point in
345this buffer does not move the arrow. 346this buffer does not move the arrow.
346 347
347 You can start editing these source files at any time in the buffers 348 You can start editing these source files at any time in the buffers
348that were made to display them. The arrow is not part of the file's 349that display them. The arrow is not part of the file's
349text; it appears only on the screen. If you do modify a source file, 350text; it appears only on the screen. If you do modify a source file,
350keep in mind that inserting or deleting lines will throw off the arrow's 351keep in mind that inserting or deleting lines will throw off the arrow's
351positioning; GUD has no way of figuring out which line corresponded 352positioning; GUD has no way of figuring out which line corresponded
@@ -368,9 +369,9 @@ selecting stack frames, and for stepping through the program. These
368commands are available both in the GUD buffer and globally, but with 369commands are available both in the GUD buffer and globally, but with
369different key bindings. 370different key bindings.
370 371
371 The breakpoint commands are usually used in source file buffers, 372 The breakpoint commands are normally used in source file buffers,
372because that is the way to specify where to set or clear the breakpoint. 373because that is the easiest way to specify where to set or clear the
373Here's the global command to set a breakpoint: 374breakpoint. Here's the global command to set a breakpoint:
374 375
375@table @kbd 376@table @kbd
376@item C-x @key{SPC} 377@item C-x @key{SPC}
@@ -513,7 +514,7 @@ debugger interaction buffer:
513 514
514 This defines a command named @var{function} which sends 515 This defines a command named @var{function} which sends
515@var{cmdstring} to the debugger process, and gives it the documentation 516@var{cmdstring} to the debugger process, and gives it the documentation
516string @var{docstring}. You can use the command thus defined in any 517string @var{docstring}. You can then use the command thus defined in any
517buffer. If @var{binding} is non-@code{nil}, @code{gud-def} also binds 518buffer. If @var{binding} is non-@code{nil}, @code{gud-def} also binds
518the command to @kbd{C-c @var{binding}} in the GUD buffer's mode and to 519the command to @kbd{C-c @var{binding}} in the GUD buffer's mode and to
519@kbd{C-x C-a @var{binding}} generally. 520@kbd{C-x C-a @var{binding}} generally.
@@ -748,7 +749,7 @@ is @code{eval-region}. @kbd{M-x eval-region} parses the text of the
748region as one or more Lisp expressions, evaluating them one by one. 749region as one or more Lisp expressions, evaluating them one by one.
749@kbd{M-x eval-current-buffer} is similar but evaluates the entire 750@kbd{M-x eval-current-buffer} is similar but evaluates the entire
750buffer. This is a reasonable way to install the contents of a file of 751buffer. This is a reasonable way to install the contents of a file of
751Lisp code that you are just ready to test. Later, as you find bugs and 752Lisp code that you are ready to test. Later, as you find bugs and
752change individual functions, use @kbd{C-M-x} on each function that you 753change individual functions, use @kbd{C-M-x} on each function that you
753change. This keeps the Lisp world in step with the source file. 754change. This keeps the Lisp world in step with the source file.
754 755
diff --git a/man/glossary.texi b/man/glossary.texi
index de8c26fad3d..5e16f9ba396 100644
--- a/man/glossary.texi
+++ b/man/glossary.texi
@@ -125,7 +125,7 @@ ask you to report any bugs you find. @xref{Bugs}.
125 125
126@item Button Down Event 126@item Button Down Event
127A button down event is the kind of input event generated right away when 127A button down event is the kind of input event generated right away when
128you press a mouse button. @xref{Mouse Buttons}. 128you press down on a mouse button. @xref{Mouse Buttons}.
129 129
130@item By Default 130@item By Default
131See `default.' 131See `default.'
@@ -255,11 +255,11 @@ The current line is a line point is on (@pxref{Point}).
255 255
256@item Current Paragraph 256@item Current Paragraph
257The current paragraph is the paragraph that point is in. If point is 257The current paragraph is the paragraph that point is in. If point is
258between paragraphs, the current paragraph is the one that follows point. 258between two paragraphs, the current paragraph is the one that follows
259@xref{Paragraphs}. 259point. @xref{Paragraphs}.
260 260
261@item Current Defun 261@item Current Defun
262The current defun is a defun (q.v.@:) that point is in. If point is 262The current defun is the defun (q.v.@:) that point is in. If point is
263between defuns, the current defun is the one that follows point. 263between defuns, the current defun is the one that follows point.
264@xref{Defuns}. 264@xref{Defuns}.
265 265
@@ -315,7 +315,7 @@ Deleting a file means erasing it from the file system.
315@item Deletion of Messages 315@item Deletion of Messages
316Deleting a message means flagging it to be eliminated from your mail 316Deleting a message means flagging it to be eliminated from your mail
317file. Until you expunge (q.v.@:) the Rmail file, you can still undelete 317file. Until you expunge (q.v.@:) the Rmail file, you can still undelete
318the messages you have deleted. @xref{Rmail Deletion}. 318the messages you have flagged to be deleted. @xref{Rmail Deletion}.
319 319
320@item Deletion of Windows 320@item Deletion of Windows
321Deleting a window means eliminating it from the screen. Other windows 321Deleting a window means eliminating it from the screen. Other windows
@@ -369,7 +369,7 @@ particular delimiter characters to reindent the line or insert one or
369more newlines in addition to self-insertion. 369more newlines in addition to self-insertion.
370 370
371@item End Of Line 371@item End Of Line
372End of line is a character or characters which signal an end of a text 372End of line is a character or characters which signal the end of a text
373line. On GNU and Unix systems, this is a newline (q.v.@:), but other 373line. On GNU and Unix systems, this is a newline (q.v.@:), but other
374systems have other conventions. @xref{Coding Systems,end-of-line}. 374systems have other conventions. @xref{Coding Systems,end-of-line}.
375Emacs can recognize several end-of-line conventions in files and convert 375Emacs can recognize several end-of-line conventions in files and convert
@@ -519,7 +519,7 @@ tags (see `tags table'). @xref{Global Mark Ring}.
519 519
520@item Global Substitution 520@item Global Substitution
521Global substitution means replacing each occurrence of one string by 521Global substitution means replacing each occurrence of one string by
522another string through a large amount of text. @xref{Replace}. 522another string throughout a large amount of text. @xref{Replace}.
523 523
524@item Global Variable 524@item Global Variable
525The global value of a variable (q.v.@:) takes effect in all buffers 525The global value of a variable (q.v.@:) takes effect in all buffers
@@ -616,8 +616,9 @@ that someone else is already editing.
616See `incremental search.' 616See `incremental search.'
617 617
618@item Justification 618@item Justification
619Justification means adding extra spaces to lines of text to make them 619Justification means adding extra spaces within lines of text to make
620come exactly to a specified width. @xref{Filling,Justification}. 620them align exactly to a specified width.
621@xref{Filling,Justification}.
621 622
622@item Keyboard Macro 623@item Keyboard Macro
623Keyboard macros are a way of defining new Emacs commands from 624Keyboard macros are a way of defining new Emacs commands from
@@ -655,8 +656,8 @@ called yanking (q.v.@:). @xref{Yanking}.
655@item Killing 656@item Killing
656Killing means erasing text and saving it on the kill ring so it can be 657Killing means erasing text and saving it on the kill ring so it can be
657yanked (q.v.@:) later. Some other systems call this ``cutting.'' 658yanked (q.v.@:) later. Some other systems call this ``cutting.''
658Most Emacs commands to erase text do killing, as opposed to deletion 659Most Emacs commands that erase text perform killing, as opposed to
659(q.v.@:). @xref{Killing}. 660deletion (q.v.@:). @xref{Killing}.
660 661
661@item Killing a Job 662@item Killing a Job
662Killing a job (such as, an invocation of Emacs) means making it cease 663Killing a job (such as, an invocation of Emacs) means making it cease
@@ -932,7 +933,7 @@ Visiting a file that is write-protected also makes a read-only buffer.
932@item Rectangle 933@item Rectangle
933A rectangle consists of the text in a given range of columns on a given 934A rectangle consists of the text in a given range of columns on a given
934range of lines. Normally you specify a rectangle by putting point at 935range of lines. Normally you specify a rectangle by putting point at
935one corner and putting the mark at the opposite corner. 936one corner and putting the mark at the diagonally opposite corner.
936@xref{Rectangles}. 937@xref{Rectangles}.
937 938
938@item Recursive Editing Level 939@item Recursive Editing Level
@@ -967,7 +968,9 @@ digits. @xref{Regexps}.
967@item Remote File 968@item Remote File
968A remote file is a file that is stored on a system other than your own. 969A remote file is a file that is stored on a system other than your own.
969Emacs can access files on other computers provided that they are 970Emacs can access files on other computers provided that they are
970connected to the same network as your machine. @xref{Remote Files}. 971connected to the same network as your machine, and (obviously) that
972you have a supported method to gain access to those files.
973@xref{Remote Files}.
971 974
972@item Repeat Count 975@item Repeat Count
973See `numeric argument.' 976See `numeric argument.'
@@ -1061,7 +1064,7 @@ name. @xref{Expressions,Sexps}.
1061 1064
1062@item Simultaneous Editing 1065@item Simultaneous Editing
1063Simultaneous editing means two users modifying the same file at once. 1066Simultaneous editing means two users modifying the same file at once.
1064Simultaneous editing if not detected can cause one user to lose his 1067Simultaneous editing, if not detected, can cause one user to lose his
1065work. Emacs detects all cases of simultaneous editing and warns one 1068work. Emacs detects all cases of simultaneous editing and warns one
1066of the users to investigate. 1069of the users to investigate.
1067@xref{Interlocking,Interlocking,Simultaneous Editing}. 1070@xref{Interlocking,Interlocking,Simultaneous Editing}.
@@ -1124,7 +1127,7 @@ Emacs does not make a termscript file unless you tell it to.
1124@xref{Bugs}. 1127@xref{Bugs}.
1125 1128
1126@item Text 1129@item Text
1127Two meanings (@pxref{Text}): 1130`Text' has two meanings (@pxref{Text}):
1128 1131
1129@itemize @bullet 1132@itemize @bullet
1130@item 1133@item
diff --git a/man/help.texi b/man/help.texi
index 66ffbf6dccc..932db38149d 100644
--- a/man/help.texi
+++ b/man/help.texi
@@ -1,5 +1,5 @@
1@c This is part of the Emacs manual. 1@c This is part of the Emacs manual.
2@c Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 2000 2@c Copyright (C) 1985, 86, 87, 93, 94, 95, 97, 2000, 2001
3@c Free Software Foundation, Inc. 3@c Free Software Foundation, Inc.
4@c See file emacs.texi for copying conditions. 4@c See file emacs.texi for copying conditions.
5@node Help, Mark, M-x, Top 5@node Help, Mark, M-x, Top
@@ -13,7 +13,7 @@
13 13
14 Emacs provides extensive help features accessible through a single 14 Emacs provides extensive help features accessible through a single
15character, @kbd{C-h}. @kbd{C-h} is a prefix key that is used only for 15character, @kbd{C-h}. @kbd{C-h} is a prefix key that is used only for
16documentation-printing commands. The characters that you can type after 16commands that display documentation. The characters that you can type after
17@kbd{C-h} are called @dfn{help options}. One help option is @kbd{C-h}; 17@kbd{C-h} are called @dfn{help options}. One help option is @kbd{C-h};
18that is how you ask for help about using @kbd{C-h}. To cancel, type 18that is how you ask for help about using @kbd{C-h}. To cancel, type
19@kbd{C-g}. The function key @key{F1} is equivalent to @kbd{C-h}. 19@kbd{C-g}. The function key @key{F1} is equivalent to @kbd{C-h}.
@@ -39,7 +39,7 @@ customization buffers and the like. @xref{Help Mode}.
39@cindex searching documentation efficiently 39@cindex searching documentation efficiently
40@cindex looking for a subject in documentation 40@cindex looking for a subject in documentation
41 If you are looking for a certain feature, but don't know where 41 If you are looking for a certain feature, but don't know where
42exactly it is documented, and aren't even sure what is the name of the 42exactly it is documented, and aren't even sure of the name of the
43related command or option, we recommend trying these methods. Usually 43related command or option, we recommend trying these methods. Usually
44it is best to start with an apropos command, then try searching the 44it is best to start with an apropos command, then try searching the
45manual index, then finally look in the FAQ and the package keywords. 45manual index, then finally look in the FAQ and the package keywords.
@@ -48,7 +48,7 @@ manual index, then finally look in the FAQ and the package keywords.
48@item C-h a @var{topic} @key{RET} 48@item C-h a @var{topic} @key{RET}
49This searches for commands whose names match @var{topic}, which should 49This searches for commands whose names match @var{topic}, which should
50be a regular expression (@pxref{Regexps}). Browse the buffer popped 50be a regular expression (@pxref{Regexps}). Browse the buffer popped
51up by Emacs, to find what you are looking for. @xref{Apropos}. 51up by Emacs to find what you are looking for. @xref{Apropos}.
52 52
53@item M-x apropos @key{RET} @var{topic} @key{RET} 53@item M-x apropos @key{RET} @var{topic} @key{RET}
54This works like @kbd{C-h a}, but it also searches for user options and 54This works like @kbd{C-h a}, but it also searches for user options and
@@ -111,7 +111,7 @@ Display a table of all key bindings in effect now, in this order: minor
111mode bindings, major mode bindings, and global bindings 111mode bindings, major mode bindings, and global bindings
112(@code{describe-bindings}). 112(@code{describe-bindings}).
113@item C-h c @var{key} 113@item C-h c @var{key}
114Print the name of the command that @var{key} runs 114Show the name of the command that will be run if @var{key} is typed
115(@code{describe-key-briefly}). Here @kbd{c} stands for ``character.'' 115(@code{describe-key-briefly}). Here @kbd{c} stands for ``character.''
116For more extensive information on @var{key}, use @kbd{C-h k}. 116For more extensive information on @var{key}, use @kbd{C-h k}.
117@item C-h f @var{function} @key{RET} 117@item C-h f @var{function} @key{RET}
@@ -133,33 +133,34 @@ Display a description of the last 100 characters you typed
133@item C-h m 133@item C-h m
134Display documentation of the current major mode (@code{describe-mode}). 134Display documentation of the current major mode (@code{describe-mode}).
135@item C-h n 135@item C-h n
136Display documentation of Emacs changes, most recent first 136Display documentation of changes to Emacs and its packages, most
137(@code{view-emacs-news}). 137recent first (@code{view-emacs-news}).
138@item C-h P 138@item C-h P
139Display info on known problems with Emacs and possible workarounds 139Display info on known problems with Emacs and possible workarounds
140(@code{view-emacs-problems}). 140(@code{view-emacs-problems}).
141@item C-h p 141@item C-h p
142Find packages by topic keyword (@code{finder-by-keyword}). 142Find packages by topic keyword (@code{finder-by-keyword}).
143@item C-h s 143@item C-h s
144Display current contents of the syntax table, plus an explanation of 144Display the current contents of the syntax table, plus an explanation of
145what they mean (@code{describe-syntax}). @xref{Syntax}. 145what they mean (@code{describe-syntax}). @xref{Syntax}.
146@item C-h t 146@item C-h t
147Enter the Emacs interactive tutorial (@code{help-with-tutorial}). 147Enter the Emacs interactive tutorial (@code{help-with-tutorial}).
148@item C-h v @var{var} @key{RET} 148@item C-h v @var{var} @key{RET}
149Display the documentation of the Lisp variable @var{var} 149Display the documentation for the Lisp variable @var{var}
150(@code{describe-variable}). 150(@code{describe-variable}).
151@item C-h w @var{command} @key{RET} 151@item C-h w @var{command} @key{RET}
152Print which keys run the command named @var{command} (@code{where-is}). 152Display the list of keys that will run the command named @var{command}
153(@code{where-is}).
153@item C-h C @var{coding} @key{RET} 154@item C-h C @var{coding} @key{RET}
154Describe coding system @var{coding} 155Describe a coding system @var{coding}
155(@code{describe-coding-system}). 156(@code{describe-coding-system}).
156@item C-h C @key{RET} 157@item C-h C @key{RET}
157Describe the coding systems currently in use. 158Describe the coding systems currently in use.
158@item C-h I @var{method} @key{RET} 159@item C-h I @var{method} @key{RET}
159Describe an input method (@code{describe-input-method}). 160Describe an input method (@code{describe-input-method}).
160@item C-h L @var{language-env} @key{RET} 161@item C-h L @var{language-env} @key{RET}
161Describe information on the character sets, coding systems and input 162Display information on the character sets, coding systems and input
162methods used for language environment @var{language-env} 163methods used for a language environment @var{language-env}
163(@code{describe-language-environment}). 164(@code{describe-language-environment}).
164@item C-h C-c 165@item C-h C-c
165Display the copying conditions for GNU Emacs. 166Display the copying conditions for GNU Emacs.
@@ -229,7 +230,7 @@ you may find that some of your favorite abbreviations that work in
229among command names yet fail to be unique when other function names are 230among command names yet fail to be unique when other function names are
230allowed. 231allowed.
231 232
232 The function name for @kbd{C-h f} to describe has a default which is 233 The name of the function that @kbd{C-h f} describes has a default which is
233used if you type @key{RET} leaving the minibuffer empty. The default is 234used if you type @key{RET} leaving the minibuffer empty. The default is
234the function called by the innermost Lisp expression in the buffer around 235the function called by the innermost Lisp expression in the buffer around
235point, @emph{provided} that is a valid, defined Lisp function name. For 236point, @emph{provided} that is a valid, defined Lisp function name. For
@@ -385,11 +386,12 @@ wp --- word processing.
385@section Help for International Language Support 386@section Help for International Language Support
386 387
387 You can use the command @kbd{C-h L} 388 You can use the command @kbd{C-h L}
388(@code{describe-language-environment}) to find out the support for a 389(@code{describe-language-environment}) to find out information about
389specific language environment. @xref{Language Environments}. This 390the support for a specific language environment. @xref{Language
390tells you which languages this language environment is useful for, and 391Environments}. This tells you which languages this language
391lists the character sets, coding systems, and input methods that go with 392environment is useful for, and lists the character sets, coding
392it. It also shows some sample text to illustrate scripts. 393systems, and input methods that go with it. It also shows some sample
394text to illustrate scripts.
393 395
394 The command @kbd{C-h h} (@code{view-hello-file}) displays the file 396 The command @kbd{C-h h} (@code{view-hello-file}) displays the file
395@file{etc/HELLO}, which shows how to say ``hello'' in many languages. 397@file{etc/HELLO}, which shows how to say ``hello'' in many languages.
@@ -405,8 +407,8 @@ the ones currently in use. @xref{Coding Systems}.
405@node Help Mode 407@node Help Mode
406@section Help Mode Commands 408@section Help Mode Commands
407 409
408 Help buffers provide the commands of View mode (@pxref{Misc File 410 Help buffers provide the same commands commands as the View mode
409Ops}), plus a few special commands of their own. 411(@pxref{Misc File Ops}), plus a few special commands of their own.
410 412
411@table @kbd 413@table @kbd
412@item @key{SPC} 414@item @key{SPC}
@@ -451,7 +453,7 @@ previous cross reference (@code{help-previous-ref}).
451@cindex on-line manuals 453@cindex on-line manuals
452 @kbd{C-h i} (@code{info}) runs the Info program, which is used for 454 @kbd{C-h i} (@code{info}) runs the Info program, which is used for
453browsing through structured documentation files. The entire Emacs manual 455browsing through structured documentation files. The entire Emacs manual
454is available within Info. Eventually all the documentation of the GNU 456is available within Info. Eventually all of the documentation of the GNU
455system will be available. Type @kbd{h} after entering Info to run 457system will be available. Type @kbd{h} after entering Info to run
456a tutorial on using Info. 458a tutorial on using Info.
457 459
@@ -499,7 +501,7 @@ mode.
499 @kbd{C-h b} (@code{describe-bindings}) and @kbd{C-h s} 501 @kbd{C-h b} (@code{describe-bindings}) and @kbd{C-h s}
500(@code{describe-syntax}) present other information about the current 502(@code{describe-syntax}) present other information about the current
501Emacs mode. @kbd{C-h b} displays a list of all the key bindings now in 503Emacs mode. @kbd{C-h b} displays a list of all the key bindings now in
502effect; the local bindings defined by the current minor modes first, 504effect, showing the local bindings defined by the current minor modes first,
503then the local bindings defined by the current major mode, and finally 505then the local bindings defined by the current major mode, and finally
504the global bindings (@pxref{Key Bindings}). @kbd{C-h s} displays the 506the global bindings (@pxref{Key Bindings}). @kbd{C-h s} displays the
505contents of the syntax table, with explanations of each character's 507contents of the syntax table, with explanations of each character's
@@ -525,7 +527,7 @@ actually @kbd{C-M-h}, which marks a defun.)
525@findex describe-project 527@findex describe-project
526@kindex C-h P 528@kindex C-h P
527@findex view-emacs-problems 529@findex view-emacs-problems
528 The other @kbd{C-h} options display various files of useful 530 The other @kbd{C-h} options display various files containing useful
529information. @kbd{C-h C-w} displays the full details on the complete 531information. @kbd{C-h C-w} displays the full details on the complete
530absence of warranty for GNU Emacs. @kbd{C-h n} (@code{view-emacs-news}) 532absence of warranty for GNU Emacs. @kbd{C-h n} (@code{view-emacs-news})
531displays the file @file{emacs/etc/NEWS}, which contains documentation on 533displays the file @file{emacs/etc/NEWS}, which contains documentation on
@@ -547,10 +549,10 @@ various situations with solutions or workarounds in many cases.
547@section Help on Active Text and Tooltips 549@section Help on Active Text and Tooltips
548 550
549@cindex tooltips 551@cindex tooltips
550@cindex ballon help 552@cindex balloon help
551When a region of text is ``active,'' so that you can select it with 553When a region of text is ``active,'' so that you can select it with
552the mouse or a key like @kbd{RET}, it often has associated help text. 554the mouse or a key like @kbd{RET}, it often has associated help text.
553Areas of the mode line are examples. This help will normally be 555Areas of the mode line are examples. This help will normally be
554printed in the echo area when you move point into the active text. In 556printed in the echo area when you move point into the active text. In
555a window system you can display the help text as a ``tooltip.'' 557a window system you can display the help text as a ``tooltip''
556@xref{Tooltips}. 558(sometimes known as ``balloon help''). @xref{Tooltips}.
diff --git a/man/indent.texi b/man/indent.texi
index a1315b042eb..deff9b9b0e8 100644
--- a/man/indent.texi
+++ b/man/indent.texi
@@ -12,22 +12,22 @@ adjust indentation.
12@c WideCommands 12@c WideCommands
13@table @kbd 13@table @kbd
14@item @key{TAB} 14@item @key{TAB}
15Indent current line ``appropriately'' in a mode-dependent fashion. 15Indent the current line ``appropriately'' in a mode-dependent fashion.
16@item @kbd{C-j} 16@item @kbd{C-j}
17Perform @key{RET} followed by @key{TAB} (@code{newline-and-indent}). 17Perform @key{RET} followed by @key{TAB} (@code{newline-and-indent}).
18@item M-^ 18@item M-^
19Merge two lines (@code{delete-indentation}). This would cancel out 19Merge the previous and the current line (@code{delete-indentation}).
20the effect of @kbd{C-j}. 20This would cancel out the effect of @kbd{C-j}.
21@item C-M-o 21@item C-M-o
22Split line at point; text on the line after point becomes a new line 22Split the line at point; text on the line after point becomes a new line
23indented to the same column that it now starts in (@code{split-line}). 23indented to the same column where point is located (@code{split-line}).
24@item M-m 24@item M-m
25Move (forward or back) to the first nonblank character on the current 25Move (forward or back) to the first nonblank character on the current
26line (@code{back-to-indentation}). 26line (@code{back-to-indentation}).
27@item C-M-\ 27@item C-M-\
28Indent several lines to same column (@code{indent-region}). 28Indent several lines to the same column (@code{indent-region}).
29@item C-x @key{TAB} 29@item C-x @key{TAB}
30Shift block of lines rigidly right or left (@code{indent-rigidly}). 30Shift a block of lines rigidly right or left (@code{indent-rigidly}).
31@item M-i 31@item M-i
32Indent from point to the next prespecified tab stop column 32Indent from point to the next prespecified tab stop column
33(@code{tab-to-tab-stop}). 33(@code{tab-to-tab-stop}).
@@ -52,8 +52,8 @@ knows about many aspects of C syntax.
52indents to the next tab stop column. You can set the tab stops with 52indents to the next tab stop column. You can set the tab stops with
53@kbd{M-x edit-tab-stops}. 53@kbd{M-x edit-tab-stops}.
54 54
55 Normally, @key{TAB} inserts a mix of tabs and spaces to indent lines. 55 Normally, @key{TAB} inserts an optimal mix of tabs and spaces to
56@xref{Just Spaces}, for how to override that. 56indent lines. @xref{Just Spaces}, for how to override that.
57 57
58@menu 58@menu
59* Indentation Commands:: Various commands and techniques for indentation. 59* Indentation Commands:: Various commands and techniques for indentation.
diff --git a/man/killing.texi b/man/killing.texi
index 7b1dc865c94..c3d6930c56c 100644
--- a/man/killing.texi
+++ b/man/killing.texi
@@ -47,11 +47,12 @@ deleting it from the buffer. When this happens, a message in the echo
47area tells you what is happening. 47area tells you what is happening.
48 48
49 The delete commands include @kbd{C-d} (@code{delete-char}) and 49 The delete commands include @kbd{C-d} (@code{delete-char}) and
50@key{DEL} (@code{delete-backward-char}), which delete only one character at 50@key{DEL} (@code{delete-backward-char}), which delete only one
51a time, and those commands that delete only spaces or newlines. Commands 51character at a time, and those commands that delete only spaces or
52that can destroy significant amounts of nontrivial data generally kill. 52newlines. Commands that can destroy significant amounts of nontrivial
53The commands' names and individual descriptions use the words @samp{kill} 53data generally do a kill operation instead. The commands' names and
54and @samp{delete} to say which they do. 54individual descriptions use the words @samp{kill} and @samp{delete} to
55say which kind of operation they perform.
55 56
56@cindex Delete Selection mode 57@cindex Delete Selection mode
57@cindex mode, Delete Selection 58@cindex mode, Delete Selection
@@ -132,7 +133,7 @@ should be.
132 133
133 Why do we say ``or it should be''? When Emacs starts up using a 134 Why do we say ``or it should be''? When Emacs starts up using a
134window system, it determines automatically which key or keys should be 135window system, it determines automatically which key or keys should be
135equivalent to @key{DEL}. So the @key{BACKSPACE} and/or @key{DELETE} 136equivalent to @key{DEL}. As a result, @key{BACKSPACE} and/or @key{DELETE}
136keys normally do the right things. But in some unusual cases Emacs 137keys normally do the right things. But in some unusual cases Emacs
137gets the wrong information from the system. If these keys don't do 138gets the wrong information from the system. If these keys don't do
138what they ought to do, you need to tell Emacs which key to use for 139what they ought to do, you need to tell Emacs which key to use for
@@ -144,7 +145,7 @@ keyboard really has, so it follows a uniform plan which may or may not
144fit your keyboard. The uniform plan is that the ASCII @key{DEL} 145fit your keyboard. The uniform plan is that the ASCII @key{DEL}
145character deletes, and the ASCII @key{BS} (backspace) character asks 146character deletes, and the ASCII @key{BS} (backspace) character asks
146for help (it is the same as @kbd{C-h}). If this is not right for your 147for help (it is the same as @kbd{C-h}). If this is not right for your
147keyboard, if you find that the key which ought to delete backwards 148keyboard, i.e.@: if you find that the key which ought to delete backwards
148enters Help instead, see @ref{DEL Gets Help}. 149enters Help instead, see @ref{DEL Gets Help}.
149 150
150@kindex M-\ 151@kindex M-\
@@ -157,7 +158,7 @@ characters: spaces, tabs and newlines. @kbd{M-\}
157characters before and after point. @kbd{M-@key{SPC}} 158characters before and after point. @kbd{M-@key{SPC}}
158(@code{just-one-space}) does likewise but leaves a single space after 159(@code{just-one-space}) does likewise but leaves a single space after
159point, regardless of the number of spaces that existed previously (even 160point, regardless of the number of spaces that existed previously (even
160zero). 161if there were none before).
161 162
162 @kbd{C-x C-o} (@code{delete-blank-lines}) deletes all blank lines 163 @kbd{C-x C-o} (@code{delete-blank-lines}) deletes all blank lines
163after the current line. If the current line is blank, it deletes all 164after the current line. If the current line is blank, it deletes all
@@ -192,7 +193,7 @@ of the line, you can be sure @kbd{C-k} will kill the newline.
192 193
193 When @kbd{C-k} is given a positive argument, it kills that many lines 194 When @kbd{C-k} is given a positive argument, it kills that many lines
194and the newlines that follow them (however, text on the current line 195and the newlines that follow them (however, text on the current line
195before point is spared). With a negative argument @minus{}@var{n}, it 196before point is not killed). With a negative argument @minus{}@var{n}, it
196kills @var{n} lines preceding the current line (together with the text 197kills @var{n} lines preceding the current line (together with the text
197on the current line before point). Thus, @kbd{C-u - 2 C-k} at the front 198on the current line before point). Thus, @kbd{C-u - 2 C-k} at the front
198of a line kills the two previous lines. 199of a line kills the two previous lines.
@@ -343,8 +344,9 @@ This is a line @point{}of sample text.
343with point shown by @point{}. If you type @kbd{M-d M-@key{DEL} M-d 344with point shown by @point{}. If you type @kbd{M-d M-@key{DEL} M-d
344M-@key{DEL}}, killing alternately forward and backward, you end up with 345M-@key{DEL}}, killing alternately forward and backward, you end up with
345@samp{a line of sample} as one entry in the kill ring, and @samp{This 346@samp{a line of sample} as one entry in the kill ring, and @samp{This
346is@ @ text.} in the buffer. (Note the double space, which you can clean 347is@ @ text.} in the buffer. (Note the double space between @samp{is}
347up with @kbd{M-@key{SPC}} or @kbd{M-q}.) 348and @samp{text}, which you can clean up with @kbd{M-@key{SPC}} or
349@kbd{M-q}.)
348 350
349 Another way to kill the same text is to move back two words with 351 Another way to kill the same text is to move back two words with
350@kbd{M-b M-b}, then kill all four words forward with @kbd{C-u M-d}. 352@kbd{M-b M-b}, then kill all four words forward with @kbd{C-u M-d}.
@@ -390,7 +392,7 @@ yank'' pointer moves to the newly made entry at the front of the ring.
390text in the buffer changes to match. Enough @kbd{M-y} commands can move 392text in the buffer changes to match. Enough @kbd{M-y} commands can move
391the pointer to any entry in the ring, so you can get any entry into the 393the pointer to any entry in the ring, so you can get any entry into the
392buffer. Eventually the pointer reaches the end of the ring; the next 394buffer. Eventually the pointer reaches the end of the ring; the next
393@kbd{M-y} moves it to the first entry again. 395@kbd{M-y} loops back around to the first entry again.
394 396
395 @kbd{M-y} moves the ``last yank'' pointer around the ring, but it does 397 @kbd{M-y} moves the ``last yank'' pointer around the ring, but it does
396not change the order of the entries in the ring, which always runs from 398not change the order of the entries in the ring, which always runs from
@@ -444,15 +446,15 @@ scattered pieces of text into a buffer or into a file.
444 446
445@table @kbd 447@table @kbd
446@item M-x append-to-buffer 448@item M-x append-to-buffer
447Append region to contents of specified buffer. 449Append region to the contents of specified buffer.
448@item M-x prepend-to-buffer 450@item M-x prepend-to-buffer
449Prepend region to contents of specified buffer. 451Prepend region to the contents of specified buffer.
450@item M-x copy-to-buffer 452@item M-x copy-to-buffer
451Copy region into specified buffer, deleting that buffer's old contents. 453Copy region into a specified buffer, deleting that buffer's old contents.
452@item M-x insert-buffer 454@item M-x insert-buffer
453Insert contents of specified buffer into current buffer at point. 455Insert the contents of specified buffer into current buffer at point.
454@item M-x append-to-file 456@item M-x append-to-file
455Append region to contents of specified file, at the end. 457Append region to the contents of specified file, at the end.
456@end table 458@end table
457 459
458 To accumulate text into a buffer, use @kbd{M-x append-to-buffer}. 460 To accumulate text into a buffer, use @kbd{M-x append-to-buffer}.
@@ -461,7 +463,7 @@ buffer specified. If you specify a nonexistent buffer,
461@code{append-to-buffer} creates the buffer. The text is inserted 463@code{append-to-buffer} creates the buffer. The text is inserted
462wherever point is in that buffer. If you have been using the buffer for 464wherever point is in that buffer. If you have been using the buffer for
463editing, the copied text goes into the middle of the text of the buffer, 465editing, the copied text goes into the middle of the text of the buffer,
464wherever point happens to be in it. 466starting from wherever point happens to be at that moment.
465 467
466 Point in that buffer is left at the end of the copied text, so 468 Point in that buffer is left at the end of the copied text, so
467successive uses of @code{append-to-buffer} accumulate the text in the 469successive uses of @code{append-to-buffer} accumulate the text in the
@@ -474,7 +476,7 @@ a buffer, then point is always at the end.
474 @kbd{M-x prepend-to-buffer} is just like @code{append-to-buffer} 476 @kbd{M-x prepend-to-buffer} is just like @code{append-to-buffer}
475except that point in the other buffer is left before the copied text, so 477except that point in the other buffer is left before the copied text, so
476successive prependings add text in reverse order. @kbd{M-x 478successive prependings add text in reverse order. @kbd{M-x
477copy-to-buffer} is similar except that any existing text in the other 479copy-to-buffer} is similar, except that any existing text in the other
478buffer is deleted, so the buffer is left containing just the text newly 480buffer is deleted, so the buffer is left containing just the text newly
479copied into it. 481copied into it.
480 482
@@ -512,7 +514,7 @@ text into or out of such formats.
512 When you must specify a rectangle for a command to work on, you do it 514 When you must specify a rectangle for a command to work on, you do it
513by putting the mark at one corner and point at the opposite corner. The 515by putting the mark at one corner and point at the opposite corner. The
514rectangle thus specified is called the @dfn{region-rectangle} because 516rectangle thus specified is called the @dfn{region-rectangle} because
515you control it in about the same way the region is controlled. But 517you control it in much the same way as the region is controlled. But
516remember that a given combination of point and mark values can be 518remember that a given combination of point and mark values can be
517interpreted either as a region or as a rectangle, depending on the 519interpreted either as a region or as a rectangle, depending on the
518command that uses them. 520command that uses them.
@@ -548,8 +550,8 @@ Replace rectangle contents with @var{string} on each line.
548Insert @var{string} on each line of the rectangle. 550Insert @var{string} on each line of the rectangle.
549@end table 551@end table
550 552
551 The rectangle operations fall into two classes: commands deleting and 553 The rectangle operations fall into two classes: commands for
552inserting rectangles, and commands for blank rectangles. 554deleting and inserting rectangles, and commands for blank rectangles.
553 555
554@kindex C-x r k 556@kindex C-x r k
555@kindex C-x r d 557@kindex C-x r d
@@ -560,7 +562,7 @@ discard the text (delete it) or save it as the ``last killed''
560rectangle. The commands for these two ways are @kbd{C-x r d} 562rectangle. The commands for these two ways are @kbd{C-x r d}
561(@code{delete-rectangle}) and @kbd{C-x r k} (@code{kill-rectangle}). In 563(@code{delete-rectangle}) and @kbd{C-x r k} (@code{kill-rectangle}). In
562either case, the portion of each line that falls inside the rectangle's 564either case, the portion of each line that falls inside the rectangle's
563boundaries is deleted, causing following text (if any) on the line to 565boundaries is deleted, causing any following text on the line to
564move left into the gap. 566move left into the gap.
565 567
566 Note that ``killing'' a rectangle is not killing in the usual sense; the 568 Note that ``killing'' a rectangle is not killing in the usual sense; the
@@ -575,9 +577,9 @@ commands have to be used and yank-popping is hard to make sense of.
575(@code{yank-rectangle}). Yanking a rectangle is the opposite of killing 577(@code{yank-rectangle}). Yanking a rectangle is the opposite of killing
576one. Point specifies where to put the rectangle's upper left corner. 578one. Point specifies where to put the rectangle's upper left corner.
577The rectangle's first line is inserted there, the rectangle's second 579The rectangle's first line is inserted there, the rectangle's second
578line is inserted at a position one line vertically down, and so on. The 580line is inserted at the same horizontal, but one line vertically down,
579number of lines affected is determined by the height of the saved 581and so on. The number of lines affected is determined by the height of
580rectangle. 582the saved rectangle.
581 583
582 You can convert single-column lists into double-column lists using 584 You can convert single-column lists into double-column lists using
583rectangle killing and yanking; kill the second half of the list as a 585rectangle killing and yanking; kill the second half of the list as a
diff --git a/man/major.texi b/man/major.texi
index 3de14ec90ab..d9f5039117e 100644
--- a/man/major.texi
+++ b/man/major.texi
@@ -31,16 +31,17 @@ how comments are to be delimited. Many major modes redefine the
31syntactical properties of characters appearing in the buffer. 31syntactical properties of characters appearing in the buffer.
32@xref{Syntax}. 32@xref{Syntax}.
33 33
34 The major modes fall into three major groups. Lisp mode (which has 34 The major modes fall into three major groups. The first group
35several variants), C mode, Fortran mode and others are for specific 35contains Lisp mode (which has several variants), C mode, Fortran mode
36programming languages. Text mode, Nroff mode, SGML mode, @TeX{} mode 36and others. These modes are for specific programming languages. The
37and Outline mode are for normal text, plain or marked up. The remaining 37second group contains Text mode, Nroff mode, SGML mode, @TeX{} mode
38major modes are not intended for use on users' files; they are used in 38and Outline mode. These modes are for normal text, plain or marked
39buffers created for specific purposes by Emacs, such as Dired mode for 39up. The remaining major modes are not intended for use on users'
40buffers made by Dired (@pxref{Dired}), Mail mode for buffers made by 40files; they are used in buffers created for specific purposes by
41@kbd{C-x m} (@pxref{Sending Mail}), and Shell mode for buffers used for 41Emacs, such as Dired mode for buffers made by Dired (@pxref{Dired}),
42communicating with an inferior shell process (@pxref{Interactive 42Mail mode for buffers made by @kbd{C-x m} (@pxref{Sending Mail}), and
43Shell}). 43Shell mode for buffers used for communicating with an inferior shell
44process (@pxref{Interactive Shell}).
44 45
45 Most programming-language major modes specify that only blank lines 46 Most programming-language major modes specify that only blank lines
46separate paragraphs. This is to make the paragraph commands useful. 47separate paragraphs. This is to make the paragraph commands useful.
@@ -88,8 +89,8 @@ or this form,
88For example, one element normally found in the list has the form 89For example, one element normally found in the list has the form
89@code{(@t{"\\.c\\'"} . c-mode)}, and it is responsible for selecting C 90@code{(@t{"\\.c\\'"} . c-mode)}, and it is responsible for selecting C
90mode for files whose names end in @file{.c}. (Note that @samp{\\} is 91mode for files whose names end in @file{.c}. (Note that @samp{\\} is
91needed in Lisp syntax to include a @samp{\} in the string, which is 92needed in Lisp syntax to include a @samp{\} in the string, which must
92needed to suppress the special meaning of @samp{.} in regexps.) If the 93be used to suppress the special meaning of @samp{.} in regexps.) If the
93element has the form @code{(@var{regexp} @var{mode-function} 94element has the form @code{(@var{regexp} @var{mode-function}
94@var{flag})} and @var{flag} is non-@code{nil}, then after calling 95@var{flag})} and @var{flag} is non-@code{nil}, then after calling
95@var{mode-function}, the suffix that matched @var{regexp} is discarded 96@var{mode-function}, the suffix that matched @var{regexp} is discarded
@@ -106,7 +107,7 @@ mode name should appear in this line both preceded and followed by
106 107
107@noindent 108@noindent
108tells Emacs to use Lisp mode. Such an explicit specification overrides 109tells Emacs to use Lisp mode. Such an explicit specification overrides
109any defaulting based on the file name. Note how the semicolon is used 110any defaults based on the file name. Note how the semicolon is used
110to make Lisp treat this line as a comment. 111to make Lisp treat this line as a comment.
111 112
112 Another format of mode specification is 113 Another format of mode specification is
@@ -158,7 +159,7 @@ mode is taken from the previously current buffer.
158mode Emacs would choose automatically: use the command @kbd{M-x 159mode Emacs would choose automatically: use the command @kbd{M-x
159normal-mode} to do this. This is the same function that 160normal-mode} to do this. This is the same function that
160@code{find-file} calls to choose the major mode. It also processes 161@code{find-file} calls to choose the major mode. It also processes
161the file's local variables list if any. 162the file's local variables list (if any).
162 163
163@vindex change-major-mode-with-file-name 164@vindex change-major-mode-with-file-name
164 The commands @kbd{C-x C-w} and @code{set-visited-file-name} change to 165 The commands @kbd{C-x C-w} and @code{set-visited-file-name} change to
diff --git a/man/mark.texi b/man/mark.texi
index c9268ecfea5..fbc93466c7e 100644
--- a/man/mark.texi
+++ b/man/mark.texi
@@ -95,7 +95,7 @@ use keyboard commands to set the mark. @xref{Mouse Commands}.
95@findex exchange-point-and-mark 95@findex exchange-point-and-mark
96 Ordinary terminals have only one cursor, so there is no way for Emacs 96 Ordinary terminals have only one cursor, so there is no way for Emacs
97to show you where the mark is located. You have to remember. The usual 97to show you where the mark is located. You have to remember. The usual
98solution to this problem is to set the mark and then use it soon, before 98solution to this problem is to set the mark and then use it before
99you forget where it is. Alternatively, you can see where the mark is 99you forget where it is. Alternatively, you can see where the mark is
100with the command @kbd{C-x C-x} (@code{exchange-point-and-mark}) which 100with the command @kbd{C-x C-x} (@code{exchange-point-and-mark}) which
101puts the mark where point was and point where the mark was. The extent 101puts the mark where point was and point where the mark was. The extent
@@ -106,7 +106,7 @@ reactivates the mark.
106 @kbd{C-x C-x} is also useful when you are satisfied with the position 106 @kbd{C-x C-x} is also useful when you are satisfied with the position
107of point but want to move the other end of the region (where the mark 107of point but want to move the other end of the region (where the mark
108is); do @kbd{C-x C-x} to put point at that end of the region, and then 108is); do @kbd{C-x C-x} to put point at that end of the region, and then
109move it. A second use of @kbd{C-x C-x}, if necessary, puts the mark at 109move it. Using @kbd{C-x C-x} a second time, if necessary, puts the mark at
110the new position with point back at its original position. 110the new position with point back at its original position.
111 111
112 For more facilities that allow you to go to previously set marks, see 112 For more facilities that allow you to go to previously set marks, see
@@ -155,8 +155,8 @@ the mode.
155@itemize @bullet 155@itemize @bullet
156@item 156@item
157To set the mark, type @kbd{C-@key{SPC}} (@code{set-mark-command}). 157To set the mark, type @kbd{C-@key{SPC}} (@code{set-mark-command}).
158This makes the mark active; as you move point, you will see the region 158This makes the mark active; as you move point, you will see the
159highlighting grow and shrink. 159highlighted region grow and shrink.
160 160
161@item 161@item
162The mouse commands for specifying the mark also make it active. So do 162The mouse commands for specifying the mark also make it active. So do
@@ -175,8 +175,8 @@ on a region will get an error and refuse to operate. You can make the
175region active again by typing @kbd{C-x C-x}. 175region active again by typing @kbd{C-x C-x}.
176 176
177@item 177@item
178Commands like @kbd{M->} and @kbd{C-s} that ``leave the mark behind'' in 178Commands like @kbd{M->} and @kbd{C-s} that ``leave the mark behind'', in
179addition to some other primary purpose do not activate the new mark. 179addition to some other primary purpose, do not activate the new mark.
180You can activate the new region by executing @kbd{C-x C-x} 180You can activate the new region by executing @kbd{C-x C-x}
181(@code{exchange-point-and-mark}). 181(@code{exchange-point-and-mark}).
182 182
@@ -195,9 +195,9 @@ when there is a region. Outside Transient Mark mode, you must type
195in their own documentation. 195in their own documentation.
196@end itemize 196@end itemize
197 197
198 Highlighting of the region uses the @code{region} face; you can 198 The highlighting of the region uses the @code{region} face; you can
199customize how the region is highlighted by changing this face. 199customize the appearance of the highlighted region by changing this
200@xref{Face Customization}. 200face. @xref{Face Customization}.
201 201
202@vindex highlight-nonselected-windows 202@vindex highlight-nonselected-windows
203 When multiple windows show the same buffer, they can have different 203 When multiple windows show the same buffer, they can have different
@@ -206,7 +206,7 @@ all share one common mark position). Ordinarily, only the selected
206window highlights its region (@pxref{Windows}). However, if the 206window highlights its region (@pxref{Windows}). However, if the
207variable @code{highlight-nonselected-windows} is non-@code{nil}, then 207variable @code{highlight-nonselected-windows} is non-@code{nil}, then
208each window highlights its own region (provided that Transient Mark mode 208each window highlights its own region (provided that Transient Mark mode
209is enabled and the window's buffer's mark is active). 209is enabled and the mark in the buffer's window is active).
210 210
211 When Transient Mark mode is not enabled, every command that sets the 211 When Transient Mark mode is not enabled, every command that sets the
212mark also activates it, and nothing ever deactivates it. 212mark also activates it, and nothing ever deactivates it.
@@ -249,8 +249,8 @@ Print hardcopy with @kbd{M-x print-region} (@pxref{Hardcopy}).
249Evaluate it as Lisp code with @kbd{M-x eval-region} (@pxref{Lisp Eval}). 249Evaluate it as Lisp code with @kbd{M-x eval-region} (@pxref{Lisp Eval}).
250@end itemize 250@end itemize
251 251
252 Most commands that operate on the text in the 252 Most commands that operate on text in the region have the word
253region have the word @code{region} in their names. 253@code{region} in their names.
254 254
255@node Marking Objects 255@node Marking Objects
256@section Commands to Mark Textual Objects 256@section Commands to Mark Textual Objects
@@ -261,18 +261,18 @@ object such as a word, list, paragraph or page.
261 261
262@table @kbd 262@table @kbd
263@item M-@@ 263@item M-@@
264Set mark after end of next word (@code{mark-word}). This command and 264Set mark after the end of next word (@code{mark-word}). This command and
265the following one do not move point. 265the following one do not move point.
266@item C-M-@@ 266@item C-M-@@
267Set mark after end of following balanced expression (@code{mark-sexp}). 267Set mark after the end of following balanced expression (@code{mark-sexp}).
268@item M-h 268@item M-h
269Put region around current paragraph (@code{mark-paragraph}). 269Put region around the current paragraph (@code{mark-paragraph}).
270@item C-M-h 270@item C-M-h
271Put region around current defun (@code{mark-defun}). 271Put region around the current defun (@code{mark-defun}).
272@item C-x h 272@item C-x h
273Put region around entire buffer (@code{mark-whole-buffer}). 273Put region around the entire buffer (@code{mark-whole-buffer}).
274@item C-x C-p 274@item C-x C-p
275Put region around current page (@code{mark-page}). 275Put region around the current page (@code{mark-page}).
276@end table 276@end table
277 277
278@kbd{M-@@} (@code{mark-word}) puts the mark at the end of the next 278@kbd{M-@@} (@code{mark-word}) puts the mark at the end of the next
@@ -288,8 +288,8 @@ the beginning of the paragraph that surrounds or follows point, and puts
288the mark at the end of that paragraph (@pxref{Paragraphs}). It prepares 288the mark at the end of that paragraph (@pxref{Paragraphs}). It prepares
289the region so you can indent, case-convert, or kill a whole paragraph. 289the region so you can indent, case-convert, or kill a whole paragraph.
290 290
291 @kbd{C-M-h} (@code{mark-defun}) similarly puts point before and the 291 @kbd{C-M-h} (@code{mark-defun}) similarly puts point before, and the
292mark after the current or following major top-level definition, or 292mark after, the current or following major top-level definition, or
293defun (@pxref{Moving by Defuns}). @kbd{C-x C-p} (@code{mark-page}) 293defun (@pxref{Moving by Defuns}). @kbd{C-x C-p} (@code{mark-page})
294puts point before the current page, and mark at the end 294puts point before the current page, and mark at the end
295(@pxref{Pages}). The mark goes after the terminating page delimiter 295(@pxref{Pages}). The mark goes after the terminating page delimiter
@@ -315,7 +315,7 @@ remembering a spot that you may want to go back to. To make this
315feature more useful, each buffer remembers 16 previous locations of the 315feature more useful, each buffer remembers 16 previous locations of the
316mark, in the @dfn{mark ring}. Commands that set the mark also push the 316mark, in the @dfn{mark ring}. Commands that set the mark also push the
317old mark onto this ring. To return to a marked location, use @kbd{C-u 317old mark onto this ring. To return to a marked location, use @kbd{C-u
318C-@key{SPC}} (or @kbd{C-u C-@@}); this is the command 318C-@key{SPC}} (or @kbd{C-u C-@@}); this is the same as the command
319@code{set-mark-command} given a numeric argument. It moves point to 319@code{set-mark-command} given a numeric argument. It moves point to
320where the mark was, and restores the mark from the ring of former 320where the mark was, and restores the mark from the ring of former
321marks. Thus, repeated use of this command moves point to all of the old 321marks. Thus, repeated use of this command moves point to all of the old
@@ -341,7 +341,7 @@ Registers}).
341@vindex mark-ring-max 341@vindex mark-ring-max
342 The variable @code{mark-ring-max} specifies the maximum number of 342 The variable @code{mark-ring-max} specifies the maximum number of
343entries to keep in the mark ring. If that many entries exist and 343entries to keep in the mark ring. If that many entries exist and
344another one is pushed, the last one in the list is discarded. Repeating 344another one is pushed, the earliest one in the list is discarded. Repeating
345@kbd{C-u C-@key{SPC}} cycles through the positions currently in the 345@kbd{C-u C-@key{SPC}} cycles through the positions currently in the
346ring. 346ring.
347 347
diff --git a/man/mini.texi b/man/mini.texi
index 8f901019777..eb4250bec7d 100644
--- a/man/mini.texi
+++ b/man/mini.texi
@@ -23,7 +23,7 @@ command that the argument is for. The prompt normally ends with a colon.
23@cindex default argument 23@cindex default argument
24 Sometimes a @dfn{default argument} appears in parentheses after the 24 Sometimes a @dfn{default argument} appears in parentheses after the
25colon; it too is part of the prompt. The default will be used as the 25colon; it too is part of the prompt. The default will be used as the
26argument value if you enter an empty argument (for example, just type 26argument value if you enter an empty argument (that is, just type
27@key{RET}). For example, commands that read buffer names always show a 27@key{RET}). For example, commands that read buffer names always show a
28default, which is the name of the buffer that will be used if you type 28default, which is the name of the buffer that will be used if you type
29just @key{RET}. 29just @key{RET}.
@@ -146,13 +146,14 @@ minibuffer window. But you can make it taller in the normal fashion
146with @kbd{C-x ^}. 146with @kbd{C-x ^}.
147 147
148@vindex resize-mini-windows 148@vindex resize-mini-windows
149 The minibuffer window expands vertically as necessary to hold the text 149 The minibuffer window expands vertically as necessary to hold the
150that you put in the minibuffer if @code{resize-mini-windows} is 150text that you put in the minibuffer if @code{resize-mini-windows} is
151non-@code{nil}. If @code{resize-mini-windows} is @code{t}, the window 151non-@code{nil}. If @code{resize-mini-windows} is @code{t}, the window
152is always resized to fit the size of the text it displays. If 152is always resized to fit the size of the text it displays. If
153@code{resize-mini-windows} is the symbol @code{grow-only}, the window 153@code{resize-mini-windows} is the symbol @code{grow-only}, the window
154is enlarged only, until it becomes empty again, at which point it 154is enlarged when the size of displayed text grows, but never shrinked
155shrinks to its normal size again. 155until it becomes empty, at which point it shrinks back to its normal
156size.
156 157
157@vindex max-mini-window-height 158@vindex max-mini-window-height
158 The variable @code{max-mini-window-height} controls the maximum 159 The variable @code{max-mini-window-height} controls the maximum
@@ -164,7 +165,7 @@ window automatically. The default value is 0.25.
164 If while in the minibuffer you issue a command that displays help text 165 If while in the minibuffer you issue a command that displays help text
165of any sort in another window, you can use the @kbd{C-M-v} command while 166of any sort in another window, you can use the @kbd{C-M-v} command while
166in the minibuffer to scroll the help text. This lasts until you exit 167in the minibuffer to scroll the help text. This lasts until you exit
167the minibuffer. This feature is especially useful if a completing 168the minibuffer. This feature is especially useful if the
168minibuffer gives you a list of possible completions. @xref{Other Window}. 169minibuffer gives you a list of possible completions. @xref{Other Window}.
169 170
170@vindex enable-recursive-minibuffers 171@vindex enable-recursive-minibuffers
@@ -265,7 +266,7 @@ next hyphen or space. If you have @samp{auto-f} in the minibuffer and
265type @key{SPC}, it finds that the completion is @samp{auto-fill-mode}, 266type @key{SPC}, it finds that the completion is @samp{auto-fill-mode},
266but it stops completing after @samp{fill-}. This gives 267but it stops completing after @samp{fill-}. This gives
267@samp{auto-fill-}. Another @key{SPC} at this point completes all the 268@samp{auto-fill-}. Another @key{SPC} at this point completes all the
268way to @samp{auto-fill-mode}. @key{SPC} in the minibuffer when 269way to @samp{auto-fill-mode}. Typing @key{SPC} in the minibuffer when
269completion is available runs the command 270completion is available runs the command
270@code{minibuffer-complete-word}. 271@code{minibuffer-complete-word}.
271 272
@@ -277,7 +278,7 @@ window that displays a list of completions:
277@item Mouse-2 278@item Mouse-2
278Clicking mouse button 2 on a completion in the list of possible 279Clicking mouse button 2 on a completion in the list of possible
279completions chooses that completion (@code{mouse-choose-completion}). 280completions chooses that completion (@code{mouse-choose-completion}).
280You normally use this command while point is in the minibuffer; but you 281You normally use this command while point is in the minibuffer, but you
281must click in the list of completions, not in the minibuffer itself. 282must click in the list of completions, not in the minibuffer itself.
282 283
283@findex switch-to-completions 284@findex switch-to-completions
@@ -365,10 +366,11 @@ strings, then they are not ignored. Ignored extensions do not apply to
365lists of completions---those always mention all possible completions. 366lists of completions---those always mention all possible completions.
366 367
367@vindex completion-auto-help 368@vindex completion-auto-help
368 Normally, a completion command that finds the next character is undetermined 369 Normally, a completion command that finds that the next character is
369automatically displays a list of all possible completions. If the variable 370undetermined automatically displays a list of all possible
370@code{completion-auto-help} is set to @code{nil}, this does not happen, 371completions. If the variable @code{completion-auto-help} is set to
371and you must type @kbd{?} to display the possible completions. 372@code{nil}, this does not happen, and you must type @kbd{?} to display
373the possible completions.
372 374
373@cindex Partial Completion mode 375@cindex Partial Completion mode
374@vindex partial-completion-mode 376@vindex partial-completion-mode
diff --git a/man/picture.texi b/man/picture.texi
index f16d5007d9a..e792878ae46 100644
--- a/man/picture.texi
+++ b/man/picture.texi
@@ -223,7 +223,7 @@ commands may also be useful (@pxref{Rectangles}).
223Clear out the region-rectangle with spaces 223Clear out the region-rectangle with spaces
224(@code{picture-clear-rectangle}). With argument, delete the text. 224(@code{picture-clear-rectangle}). With argument, delete the text.
225@item C-c C-w @var{r} 225@item C-c C-w @var{r}
226Similar but save rectangle contents in register @var{r} first 226Similar, but save rectangle contents in register @var{r} first
227(@code{picture-clear-rectangle-to-register}). 227(@code{picture-clear-rectangle-to-register}).
228@item C-c C-y 228@item C-c C-y
229Copy last killed rectangle into the buffer by overwriting, with upper 229Copy last killed rectangle into the buffer by overwriting, with upper
@@ -255,9 +255,9 @@ rectangle for @kbd{C-c C-y}.
255@findex picture-yank-rectangle 255@findex picture-yank-rectangle
256@findex picture-yank-rectangle-from-register 256@findex picture-yank-rectangle-from-register
257 The Picture mode commands for yanking rectangles differ from the 257 The Picture mode commands for yanking rectangles differ from the
258standard ones in overwriting instead of inserting. This is the same way 258standard ones in that they overwrite instead of inserting. This is
259that Picture mode insertion of other text differs from other modes. 259the same way that Picture mode insertion of other text differs from
260@kbd{C-c C-y} (@code{picture-yank-rectangle}) inserts (by overwriting) 260other modes. @kbd{C-c C-y} (@code{picture-yank-rectangle}) inserts
261the rectangle that was most recently killed, while @kbd{C-c C-x} 261(by overwriting) the rectangle that was most recently killed, while
262(@code{picture-yank-rectangle-from-register}) does likewise for the 262@kbd{C-c C-x} (@code{picture-yank-rectangle-from-register}) does
263rectangle found in a specified register. 263likewise for the rectangle found in a specified register.
diff --git a/man/sending.texi b/man/sending.texi
index 05c77aa72b8..4d8e857206d 100644
--- a/man/sending.texi
+++ b/man/sending.texi
@@ -198,7 +198,7 @@ variable @env{REPLYTO} is set, @code{mail-default-reply-to} is
198initialized from that environment variable. 198initialized from that environment variable.
199 199
200@item In-reply-to 200@item In-reply-to
201This field contains a piece of text describing a message you are 201This field contains a piece of text describing the message you are
202replying to. Some mail systems can use this information to correlate 202replying to. Some mail systems can use this information to correlate
203related pieces of mail. Normally this field is filled in by Rmail 203related pieces of mail. Normally this field is filled in by Rmail
204when you reply to a message in Rmail, and you never need to 204when you reply to a message in Rmail, and you never need to
@@ -380,8 +380,8 @@ word commands to edit mail addresses.
380 380
381 Mail mode is normally used in buffers set up automatically by the 381 Mail mode is normally used in buffers set up automatically by the
382@code{mail} command and related commands. However, you can also switch 382@code{mail} command and related commands. However, you can also switch
383to Mail mode in a file-visiting buffer. That is a useful thing to do if 383to Mail mode in a file-visiting buffer. This is a useful thing to do if
384you have saved draft message text in a file. 384you have saved the text of a draft message in a file.
385 385
386@menu 386@menu
387* Mail Sending:: Commands to send the message. 387* Mail Sending:: Commands to send the message.
@@ -488,7 +488,7 @@ the full name, and what style to use, as in @code{mail-from-style}
488 488
489 For completion purposes, the valid mailing addresses are taken to be 489 For completion purposes, the valid mailing addresses are taken to be
490the local users' names plus your personal mail aliases. You can 490the local users' names plus your personal mail aliases. You can
491specify additional sources of valid addresses; look at customization 491specify additional sources of valid addresses; look at the customization
492group @samp{mailalias} to see the options for this 492group @samp{mailalias} to see the options for this
493(@pxref{Customization Groups}). 493(@pxref{Customization Groups}).
494 494
@@ -564,7 +564,7 @@ Insert the file @file{~/.signature} at the end of the message text
564Insert the contents of @var{file} at the end of the outgoing message 564Insert the contents of @var{file} at the end of the outgoing message
565(@code{mail-attach-file}). 565(@code{mail-attach-file}).
566@item M-x ispell-message 566@item M-x ispell-message
567Do spelling correction on the message text, but not on citations from 567Perform spelling correction on the message text, but not on citations from
568other messages. 568other messages.
569@end table 569@end table
570 570
@@ -580,7 +580,7 @@ separator line---that is, to the beginning of the message body text.
580the end of the message to say more about who you are. The text comes 580the end of the message to say more about who you are. The text comes
581from the file @file{~/.signature} in your home directory. To insert 581from the file @file{~/.signature} in your home directory. To insert
582your signature automatically, set the variable @code{mail-signature} to 582your signature automatically, set the variable @code{mail-signature} to
583@code{t}; then starting a mail message automatically inserts the 583@code{t}; after that, starting a mail message automatically inserts the
584contents of your @file{~/.signature} file. If you want to omit your 584contents of your @file{~/.signature} file. If you want to omit your
585signature from a particular message, delete it from the buffer before 585signature from a particular message, delete it from the buffer before
586you send the message. 586you send the message.
@@ -620,7 +620,7 @@ that hook. @xref{Hooks}.
620 The main difference between these hooks is just when they are 620 The main difference between these hooks is just when they are
621invoked. Whenever you type @kbd{M-x mail}, @code{mail-mode-hook} runs 621invoked. Whenever you type @kbd{M-x mail}, @code{mail-mode-hook} runs
622as soon as the @samp{*mail*} buffer is created. Then the 622as soon as the @samp{*mail*} buffer is created. Then the
623@code{mail-setup} function puts in the default contents of the buffer. 623@code{mail-setup} function inserts the default contents of the buffer.
624After these default contents are inserted, @code{mail-setup-hook} runs. 624After these default contents are inserted, @code{mail-setup-hook} runs.
625 625
626@node Mail Amusements 626@node Mail Amusements
@@ -672,7 +672,7 @@ MH-E and Message mode, not documented in this manual.
672@xref{MH-E,,,mh-e, The Emacs Interface to MH}. @xref{Message,,,message, 672@xref{MH-E,,,mh-e, The Emacs Interface to MH}. @xref{Message,,,message,
673Message Manual}. You can choose any of them as your preferred method. 673Message Manual}. You can choose any of them as your preferred method.
674The commands @code{C-x m}, @code{C-x 4 m} and @code{C-x 5 m} use 674The commands @code{C-x m}, @code{C-x 4 m} and @code{C-x 5 m} use
675whichever agent you have specified. So do various other Emacs commands 675whichever agent you have specified, as do various other Emacs commands
676and facilities that send mail. 676and facilities that send mail.
677 677
678@vindex mail-user-agent 678@vindex mail-user-agent