diff options
| author | Eli Zaretskii | 2001-07-17 10:50:35 +0000 |
|---|---|---|
| committer | Eli Zaretskii | 2001-07-17 10:50:35 +0000 |
| commit | 58fa012dac718ff7097828ba99aabea688c96ea8 (patch) | |
| tree | 4c19295641407f32e8a24265dbb781b7a4168030 | |
| parent | 12de6e2620330e1d42286a9673b9253369812432 (diff) | |
| download | emacs-58fa012dac718ff7097828ba99aabea688c96ea8.tar.gz emacs-58fa012dac718ff7097828ba99aabea688c96ea8.zip | |
Proofreading fixes from Chris Green <chris_e_green@yahoo.com>.
| -rw-r--r-- | man/abbrevs.texi | 10 | ||||
| -rw-r--r-- | man/building.texi | 33 | ||||
| -rw-r--r-- | man/glossary.texi | 33 | ||||
| -rw-r--r-- | man/help.texi | 56 | ||||
| -rw-r--r-- | man/indent.texi | 18 | ||||
| -rw-r--r-- | man/killing.texi | 54 | ||||
| -rw-r--r-- | man/major.texi | 29 | ||||
| -rw-r--r-- | man/mark.texi | 44 | ||||
| -rw-r--r-- | man/mini.texi | 26 | ||||
| -rw-r--r-- | man/picture.texi | 14 | ||||
| -rw-r--r-- | man/sending.texi | 16 |
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. |
| 125 | When the abbrev has a prior definition, the abbrev definition commands | 125 | When the abbrev has a prior definition, the abbrev definition commands |
| 126 | ask for confirmation for replacing it. | 126 | ask 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 |
| 129 | definition command: @kbd{C-u - C-x a g} or @kbd{C-u - C-x a l}. The | 129 | definition 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 |
| 215 | Display a list of all abbrev definitions. With numeric argument, list | 215 | Display a list of all abbrev definitions. With a numeric argument, list |
| 216 | only local abbrevs. | 216 | only local abbrevs. |
| 217 | @item M-x edit-abbrevs | 217 | @item M-x edit-abbrevs |
| 218 | Edit a list of abbrevs; you can add, alter or remove definitions. | 218 | Edit 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 |
| 390 | this search; if @code{nil}, the word and the expansion must match in | 390 | this search; if it is @code{nil}, the word and the expansion must match |
| 391 | case. If the value of @code{dabbrev-case-fold-search} is | 391 | in 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 |
| 394 | for expansions. | 394 | for 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 |
| 403 | the case pattern of the abbrev. If it is @code{t}, the abbrev's case | 403 | the case pattern of the abbrev. If it is @code{t}, the abbrev's case |
| 404 | pattern is preserved in most cases; if @code{nil}, the expansion is | 404 | pattern is preserved in most cases; if it is @code{nil}, the expansion is |
| 405 | always copied verbatim. If the value of @code{dabbrev-case-replace} is | 405 | always 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 |
| 45 | Run a compiler asynchronously under Emacs, with error messages going to | 45 | Run a compiler asynchronously under Emacs, with error messages going to |
| 46 | @samp{*compilation*} buffer. | 46 | the @samp{*compilation*} buffer. |
| 47 | @item M-x grep | 47 | @item M-x grep |
| 48 | Run @code{grep} asynchronously under Emacs, with matching lines | 48 | Run @code{grep} asynchronously under Emacs, with matching lines |
| 49 | listed in the buffer named @samp{*grep*}. | 49 | listed 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 |
| 164 | point in @samp{*compilation*} to that error message and typing @key{RET} | 164 | point in the @samp{*compilation*} buffer to that error message and |
| 165 | (@code{compile-goto-error}). Or click @kbd{Mouse-2} on the error message; | 165 | typing @key{RET} (@code{compile-goto-error}). Alternatively, you can |
| 166 | you need not switch to the @samp{*compilation*} buffer first. | 166 | click @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 |
| 287 | Run GDB as a subprocess of Emacs. This command creates a buffer for | 288 | This command runs GDB as a subprocess of Emacs. It creates a buffer |
| 288 | input and output to GDB, and switches to it. If a GDB buffer already | 289 | for input and output to GDB, and switches to it. If a GDB buffer |
| 289 | exists, it just switches to that buffer. | 290 | already 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 |
| 293 | Similar, but run DBX instead of GDB. | 294 | Similar, 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 |
| 298 | Similar, but run XDB instead of GDB. Use the variable | 299 | Similar, 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 |
| 300 | files. | 301 | files. |
| 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 |
| 304 | Similar, but run SDB instead of GDB. | 305 | Similar, 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 |
| 307 | messages. When you use them, you need to have a valid tags table | 308 | messages. 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 | |||
| 345 | this buffer does not move the arrow. | 346 | this 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 |
| 348 | that were made to display them. The arrow is not part of the file's | 349 | that display them. The arrow is not part of the file's |
| 349 | text; it appears only on the screen. If you do modify a source file, | 350 | text; it appears only on the screen. If you do modify a source file, |
| 350 | keep in mind that inserting or deleting lines will throw off the arrow's | 351 | keep in mind that inserting or deleting lines will throw off the arrow's |
| 351 | positioning; GUD has no way of figuring out which line corresponded | 352 | positioning; GUD has no way of figuring out which line corresponded |
| @@ -368,9 +369,9 @@ selecting stack frames, and for stepping through the program. These | |||
| 368 | commands are available both in the GUD buffer and globally, but with | 369 | commands are available both in the GUD buffer and globally, but with |
| 369 | different key bindings. | 370 | different 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, |
| 372 | because that is the way to specify where to set or clear the breakpoint. | 373 | because that is the easiest way to specify where to set or clear the |
| 373 | Here's the global command to set a breakpoint: | 374 | breakpoint. 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 |
| 516 | string @var{docstring}. You can use the command thus defined in any | 517 | string @var{docstring}. You can then use the command thus defined in any |
| 517 | buffer. If @var{binding} is non-@code{nil}, @code{gud-def} also binds | 518 | buffer. If @var{binding} is non-@code{nil}, @code{gud-def} also binds |
| 518 | the command to @kbd{C-c @var{binding}} in the GUD buffer's mode and to | 519 | the 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 | |||
| 748 | region as one or more Lisp expressions, evaluating them one by one. | 749 | region 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 |
| 750 | buffer. This is a reasonable way to install the contents of a file of | 751 | buffer. This is a reasonable way to install the contents of a file of |
| 751 | Lisp code that you are just ready to test. Later, as you find bugs and | 752 | Lisp code that you are ready to test. Later, as you find bugs and |
| 752 | change individual functions, use @kbd{C-M-x} on each function that you | 753 | change individual functions, use @kbd{C-M-x} on each function that you |
| 753 | change. This keeps the Lisp world in step with the source file. | 754 | change. 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 |
| 127 | A button down event is the kind of input event generated right away when | 127 | A button down event is the kind of input event generated right away when |
| 128 | you press a mouse button. @xref{Mouse Buttons}. | 128 | you press down on a mouse button. @xref{Mouse Buttons}. |
| 129 | 129 | ||
| 130 | @item By Default | 130 | @item By Default |
| 131 | See `default.' | 131 | See `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 |
| 257 | The current paragraph is the paragraph that point is in. If point is | 257 | The current paragraph is the paragraph that point is in. If point is |
| 258 | between paragraphs, the current paragraph is the one that follows point. | 258 | between two paragraphs, the current paragraph is the one that follows |
| 259 | @xref{Paragraphs}. | 259 | point. @xref{Paragraphs}. |
| 260 | 260 | ||
| 261 | @item Current Defun | 261 | @item Current Defun |
| 262 | The current defun is a defun (q.v.@:) that point is in. If point is | 262 | The current defun is the defun (q.v.@:) that point is in. If point is |
| 263 | between defuns, the current defun is the one that follows point. | 263 | between 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 |
| 316 | Deleting a message means flagging it to be eliminated from your mail | 316 | Deleting a message means flagging it to be eliminated from your mail |
| 317 | file. Until you expunge (q.v.@:) the Rmail file, you can still undelete | 317 | file. Until you expunge (q.v.@:) the Rmail file, you can still undelete |
| 318 | the messages you have deleted. @xref{Rmail Deletion}. | 318 | the messages you have flagged to be deleted. @xref{Rmail Deletion}. |
| 319 | 319 | ||
| 320 | @item Deletion of Windows | 320 | @item Deletion of Windows |
| 321 | Deleting a window means eliminating it from the screen. Other windows | 321 | Deleting 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 | |||
| 369 | more newlines in addition to self-insertion. | 369 | more newlines in addition to self-insertion. |
| 370 | 370 | ||
| 371 | @item End Of Line | 371 | @item End Of Line |
| 372 | End of line is a character or characters which signal an end of a text | 372 | End of line is a character or characters which signal the end of a text |
| 373 | line. On GNU and Unix systems, this is a newline (q.v.@:), but other | 373 | line. On GNU and Unix systems, this is a newline (q.v.@:), but other |
| 374 | systems have other conventions. @xref{Coding Systems,end-of-line}. | 374 | systems have other conventions. @xref{Coding Systems,end-of-line}. |
| 375 | Emacs can recognize several end-of-line conventions in files and convert | 375 | Emacs 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 |
| 521 | Global substitution means replacing each occurrence of one string by | 521 | Global substitution means replacing each occurrence of one string by |
| 522 | another string through a large amount of text. @xref{Replace}. | 522 | another string throughout a large amount of text. @xref{Replace}. |
| 523 | 523 | ||
| 524 | @item Global Variable | 524 | @item Global Variable |
| 525 | The global value of a variable (q.v.@:) takes effect in all buffers | 525 | The global value of a variable (q.v.@:) takes effect in all buffers |
| @@ -616,8 +616,9 @@ that someone else is already editing. | |||
| 616 | See `incremental search.' | 616 | See `incremental search.' |
| 617 | 617 | ||
| 618 | @item Justification | 618 | @item Justification |
| 619 | Justification means adding extra spaces to lines of text to make them | 619 | Justification means adding extra spaces within lines of text to make |
| 620 | come exactly to a specified width. @xref{Filling,Justification}. | 620 | them align exactly to a specified width. |
| 621 | @xref{Filling,Justification}. | ||
| 621 | 622 | ||
| 622 | @item Keyboard Macro | 623 | @item Keyboard Macro |
| 623 | Keyboard macros are a way of defining new Emacs commands from | 624 | Keyboard 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 |
| 656 | Killing means erasing text and saving it on the kill ring so it can be | 657 | Killing means erasing text and saving it on the kill ring so it can be |
| 657 | yanked (q.v.@:) later. Some other systems call this ``cutting.'' | 658 | yanked (q.v.@:) later. Some other systems call this ``cutting.'' |
| 658 | Most Emacs commands to erase text do killing, as opposed to deletion | 659 | Most Emacs commands that erase text perform killing, as opposed to |
| 659 | (q.v.@:). @xref{Killing}. | 660 | deletion (q.v.@:). @xref{Killing}. |
| 660 | 661 | ||
| 661 | @item Killing a Job | 662 | @item Killing a Job |
| 662 | Killing a job (such as, an invocation of Emacs) means making it cease | 663 | Killing 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 |
| 933 | A rectangle consists of the text in a given range of columns on a given | 934 | A rectangle consists of the text in a given range of columns on a given |
| 934 | range of lines. Normally you specify a rectangle by putting point at | 935 | range of lines. Normally you specify a rectangle by putting point at |
| 935 | one corner and putting the mark at the opposite corner. | 936 | one 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 |
| 968 | A remote file is a file that is stored on a system other than your own. | 969 | A remote file is a file that is stored on a system other than your own. |
| 969 | Emacs can access files on other computers provided that they are | 970 | Emacs can access files on other computers provided that they are |
| 970 | connected to the same network as your machine. @xref{Remote Files}. | 971 | connected to the same network as your machine, and (obviously) that |
| 972 | you have a supported method to gain access to those files. | ||
| 973 | @xref{Remote Files}. | ||
| 971 | 974 | ||
| 972 | @item Repeat Count | 975 | @item Repeat Count |
| 973 | See `numeric argument.' | 976 | See `numeric argument.' |
| @@ -1061,7 +1064,7 @@ name. @xref{Expressions,Sexps}. | |||
| 1061 | 1064 | ||
| 1062 | @item Simultaneous Editing | 1065 | @item Simultaneous Editing |
| 1063 | Simultaneous editing means two users modifying the same file at once. | 1066 | Simultaneous editing means two users modifying the same file at once. |
| 1064 | Simultaneous editing if not detected can cause one user to lose his | 1067 | Simultaneous editing, if not detected, can cause one user to lose his |
| 1065 | work. Emacs detects all cases of simultaneous editing and warns one | 1068 | work. Emacs detects all cases of simultaneous editing and warns one |
| 1066 | of the users to investigate. | 1069 | of 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 |
| 1127 | Two 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 |
| 15 | character, @kbd{C-h}. @kbd{C-h} is a prefix key that is used only for | 15 | character, @kbd{C-h}. @kbd{C-h} is a prefix key that is used only for |
| 16 | documentation-printing commands. The characters that you can type after | 16 | commands 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}; |
| 18 | that is how you ask for help about using @kbd{C-h}. To cancel, type | 18 | that 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 |
| 42 | exactly it is documented, and aren't even sure what is the name of the | 42 | exactly it is documented, and aren't even sure of the name of the |
| 43 | related command or option, we recommend trying these methods. Usually | 43 | related command or option, we recommend trying these methods. Usually |
| 44 | it is best to start with an apropos command, then try searching the | 44 | it is best to start with an apropos command, then try searching the |
| 45 | manual index, then finally look in the FAQ and the package keywords. | 45 | manual 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} |
| 49 | This searches for commands whose names match @var{topic}, which should | 49 | This searches for commands whose names match @var{topic}, which should |
| 50 | be a regular expression (@pxref{Regexps}). Browse the buffer popped | 50 | be a regular expression (@pxref{Regexps}). Browse the buffer popped |
| 51 | up by Emacs, to find what you are looking for. @xref{Apropos}. | 51 | up 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} |
| 54 | This works like @kbd{C-h a}, but it also searches for user options and | 54 | This 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 | |||
| 111 | mode bindings, major mode bindings, and global bindings | 111 | mode 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} |
| 114 | Print the name of the command that @var{key} runs | 114 | Show 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.'' |
| 116 | For more extensive information on @var{key}, use @kbd{C-h k}. | 116 | For 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 |
| 134 | Display documentation of the current major mode (@code{describe-mode}). | 134 | Display documentation of the current major mode (@code{describe-mode}). |
| 135 | @item C-h n | 135 | @item C-h n |
| 136 | Display documentation of Emacs changes, most recent first | 136 | Display documentation of changes to Emacs and its packages, most |
| 137 | (@code{view-emacs-news}). | 137 | recent first (@code{view-emacs-news}). |
| 138 | @item C-h P | 138 | @item C-h P |
| 139 | Display info on known problems with Emacs and possible workarounds | 139 | Display 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 |
| 142 | Find packages by topic keyword (@code{finder-by-keyword}). | 142 | Find packages by topic keyword (@code{finder-by-keyword}). |
| 143 | @item C-h s | 143 | @item C-h s |
| 144 | Display current contents of the syntax table, plus an explanation of | 144 | Display the current contents of the syntax table, plus an explanation of |
| 145 | what they mean (@code{describe-syntax}). @xref{Syntax}. | 145 | what they mean (@code{describe-syntax}). @xref{Syntax}. |
| 146 | @item C-h t | 146 | @item C-h t |
| 147 | Enter the Emacs interactive tutorial (@code{help-with-tutorial}). | 147 | Enter 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} |
| 149 | Display the documentation of the Lisp variable @var{var} | 149 | Display 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} |
| 152 | Print which keys run the command named @var{command} (@code{where-is}). | 152 | Display 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} |
| 154 | Describe coding system @var{coding} | 155 | Describe 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} |
| 157 | Describe the coding systems currently in use. | 158 | Describe the coding systems currently in use. |
| 158 | @item C-h I @var{method} @key{RET} | 159 | @item C-h I @var{method} @key{RET} |
| 159 | Describe an input method (@code{describe-input-method}). | 160 | Describe 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} |
| 161 | Describe information on the character sets, coding systems and input | 162 | Display information on the character sets, coding systems and input |
| 162 | methods used for language environment @var{language-env} | 163 | methods 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 |
| 165 | Display the copying conditions for GNU Emacs. | 166 | Display the copying conditions for GNU Emacs. |
| @@ -229,7 +230,7 @@ you may find that some of your favorite abbreviations that work in | |||
| 229 | among command names yet fail to be unique when other function names are | 230 | among command names yet fail to be unique when other function names are |
| 230 | allowed. | 231 | allowed. |
| 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 |
| 233 | used if you type @key{RET} leaving the minibuffer empty. The default is | 234 | used if you type @key{RET} leaving the minibuffer empty. The default is |
| 234 | the function called by the innermost Lisp expression in the buffer around | 235 | the function called by the innermost Lisp expression in the buffer around |
| 235 | point, @emph{provided} that is a valid, defined Lisp function name. For | 236 | point, @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 |
| 389 | specific language environment. @xref{Language Environments}. This | 390 | the support for a specific language environment. @xref{Language |
| 390 | tells you which languages this language environment is useful for, and | 391 | Environments}. This tells you which languages this language |
| 391 | lists the character sets, coding systems, and input methods that go with | 392 | environment is useful for, and lists the character sets, coding |
| 392 | it. It also shows some sample text to illustrate scripts. | 393 | systems, and input methods that go with it. It also shows some sample |
| 394 | text 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 |
| 409 | Ops}), 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 |
| 453 | browsing through structured documentation files. The entire Emacs manual | 455 | browsing through structured documentation files. The entire Emacs manual |
| 454 | is available within Info. Eventually all the documentation of the GNU | 456 | is available within Info. Eventually all of the documentation of the GNU |
| 455 | system will be available. Type @kbd{h} after entering Info to run | 457 | system will be available. Type @kbd{h} after entering Info to run |
| 456 | a tutorial on using Info. | 458 | a 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 |
| 501 | Emacs mode. @kbd{C-h b} displays a list of all the key bindings now in | 503 | Emacs mode. @kbd{C-h b} displays a list of all the key bindings now in |
| 502 | effect; the local bindings defined by the current minor modes first, | 504 | effect, showing the local bindings defined by the current minor modes first, |
| 503 | then the local bindings defined by the current major mode, and finally | 505 | then the local bindings defined by the current major mode, and finally |
| 504 | the global bindings (@pxref{Key Bindings}). @kbd{C-h s} displays the | 506 | the global bindings (@pxref{Key Bindings}). @kbd{C-h s} displays the |
| 505 | contents of the syntax table, with explanations of each character's | 507 | contents 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 |
| 529 | information. @kbd{C-h C-w} displays the full details on the complete | 531 | information. @kbd{C-h C-w} displays the full details on the complete |
| 530 | absence of warranty for GNU Emacs. @kbd{C-h n} (@code{view-emacs-news}) | 532 | absence of warranty for GNU Emacs. @kbd{C-h n} (@code{view-emacs-news}) |
| 531 | displays the file @file{emacs/etc/NEWS}, which contains documentation on | 533 | displays 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 |
| 551 | When a region of text is ``active,'' so that you can select it with | 553 | When a region of text is ``active,'' so that you can select it with |
| 552 | the mouse or a key like @kbd{RET}, it often has associated help text. | 554 | the mouse or a key like @kbd{RET}, it often has associated help text. |
| 553 | Areas of the mode line are examples. This help will normally be | 555 | Areas of the mode line are examples. This help will normally be |
| 554 | printed in the echo area when you move point into the active text. In | 556 | printed in the echo area when you move point into the active text. In |
| 555 | a window system you can display the help text as a ``tooltip.'' | 557 | a 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} |
| 15 | Indent current line ``appropriately'' in a mode-dependent fashion. | 15 | Indent the current line ``appropriately'' in a mode-dependent fashion. |
| 16 | @item @kbd{C-j} | 16 | @item @kbd{C-j} |
| 17 | Perform @key{RET} followed by @key{TAB} (@code{newline-and-indent}). | 17 | Perform @key{RET} followed by @key{TAB} (@code{newline-and-indent}). |
| 18 | @item M-^ | 18 | @item M-^ |
| 19 | Merge two lines (@code{delete-indentation}). This would cancel out | 19 | Merge the previous and the current line (@code{delete-indentation}). |
| 20 | the effect of @kbd{C-j}. | 20 | This would cancel out the effect of @kbd{C-j}. |
| 21 | @item C-M-o | 21 | @item C-M-o |
| 22 | Split line at point; text on the line after point becomes a new line | 22 | Split the line at point; text on the line after point becomes a new line |
| 23 | indented to the same column that it now starts in (@code{split-line}). | 23 | indented to the same column where point is located (@code{split-line}). |
| 24 | @item M-m | 24 | @item M-m |
| 25 | Move (forward or back) to the first nonblank character on the current | 25 | Move (forward or back) to the first nonblank character on the current |
| 26 | line (@code{back-to-indentation}). | 26 | line (@code{back-to-indentation}). |
| 27 | @item C-M-\ | 27 | @item C-M-\ |
| 28 | Indent several lines to same column (@code{indent-region}). | 28 | Indent several lines to the same column (@code{indent-region}). |
| 29 | @item C-x @key{TAB} | 29 | @item C-x @key{TAB} |
| 30 | Shift block of lines rigidly right or left (@code{indent-rigidly}). | 30 | Shift a block of lines rigidly right or left (@code{indent-rigidly}). |
| 31 | @item M-i | 31 | @item M-i |
| 32 | Indent from point to the next prespecified tab stop column | 32 | Indent 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. | |||
| 52 | indents to the next tab stop column. You can set the tab stops with | 52 | indents 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. | 56 | indent 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 | |||
| 47 | area tells you what is happening. | 47 | area 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 |
| 51 | a time, and those commands that delete only spaces or newlines. Commands | 51 | character at a time, and those commands that delete only spaces or |
| 52 | that can destroy significant amounts of nontrivial data generally kill. | 52 | newlines. Commands that can destroy significant amounts of nontrivial |
| 53 | The commands' names and individual descriptions use the words @samp{kill} | 53 | data generally do a kill operation instead. The commands' names and |
| 54 | and @samp{delete} to say which they do. | 54 | individual descriptions use the words @samp{kill} and @samp{delete} to |
| 55 | say 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 |
| 134 | window system, it determines automatically which key or keys should be | 135 | window system, it determines automatically which key or keys should be |
| 135 | equivalent to @key{DEL}. So the @key{BACKSPACE} and/or @key{DELETE} | 136 | equivalent to @key{DEL}. As a result, @key{BACKSPACE} and/or @key{DELETE} |
| 136 | keys normally do the right things. But in some unusual cases Emacs | 137 | keys normally do the right things. But in some unusual cases Emacs |
| 137 | gets the wrong information from the system. If these keys don't do | 138 | gets the wrong information from the system. If these keys don't do |
| 138 | what they ought to do, you need to tell Emacs which key to use for | 139 | what 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 | |||
| 144 | fit your keyboard. The uniform plan is that the ASCII @key{DEL} | 145 | fit your keyboard. The uniform plan is that the ASCII @key{DEL} |
| 145 | character deletes, and the ASCII @key{BS} (backspace) character asks | 146 | character deletes, and the ASCII @key{BS} (backspace) character asks |
| 146 | for help (it is the same as @kbd{C-h}). If this is not right for your | 147 | for help (it is the same as @kbd{C-h}). If this is not right for your |
| 147 | keyboard, if you find that the key which ought to delete backwards | 148 | keyboard, i.e.@: if you find that the key which ought to delete backwards |
| 148 | enters Help instead, see @ref{DEL Gets Help}. | 149 | enters 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-\} | |||
| 157 | characters before and after point. @kbd{M-@key{SPC}} | 158 | characters 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 |
| 159 | point, regardless of the number of spaces that existed previously (even | 160 | point, regardless of the number of spaces that existed previously (even |
| 160 | zero). | 161 | if 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 |
| 163 | after the current line. If the current line is blank, it deletes all | 164 | after 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 |
| 194 | and the newlines that follow them (however, text on the current line | 195 | and the newlines that follow them (however, text on the current line |
| 195 | before point is spared). With a negative argument @minus{}@var{n}, it | 196 | before point is not killed). With a negative argument @minus{}@var{n}, it |
| 196 | kills @var{n} lines preceding the current line (together with the text | 197 | kills @var{n} lines preceding the current line (together with the text |
| 197 | on the current line before point). Thus, @kbd{C-u - 2 C-k} at the front | 198 | on the current line before point). Thus, @kbd{C-u - 2 C-k} at the front |
| 198 | of a line kills the two previous lines. | 199 | of a line kills the two previous lines. |
| @@ -343,8 +344,9 @@ This is a line @point{}of sample text. | |||
| 343 | with point shown by @point{}. If you type @kbd{M-d M-@key{DEL} M-d | 344 | with point shown by @point{}. If you type @kbd{M-d M-@key{DEL} M-d |
| 344 | M-@key{DEL}}, killing alternately forward and backward, you end up with | 345 | M-@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 |
| 346 | is@ @ text.} in the buffer. (Note the double space, which you can clean | 347 | is@ @ text.} in the buffer. (Note the double space between @samp{is} |
| 347 | up with @kbd{M-@key{SPC}} or @kbd{M-q}.) | 348 | and @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. | |||
| 390 | text in the buffer changes to match. Enough @kbd{M-y} commands can move | 392 | text in the buffer changes to match. Enough @kbd{M-y} commands can move |
| 391 | the pointer to any entry in the ring, so you can get any entry into the | 393 | the pointer to any entry in the ring, so you can get any entry into the |
| 392 | buffer. Eventually the pointer reaches the end of the ring; the next | 394 | buffer. 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 |
| 396 | not change the order of the entries in the ring, which always runs from | 398 | not 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 |
| 447 | Append region to contents of specified buffer. | 449 | Append region to the contents of specified buffer. |
| 448 | @item M-x prepend-to-buffer | 450 | @item M-x prepend-to-buffer |
| 449 | Prepend region to contents of specified buffer. | 451 | Prepend region to the contents of specified buffer. |
| 450 | @item M-x copy-to-buffer | 452 | @item M-x copy-to-buffer |
| 451 | Copy region into specified buffer, deleting that buffer's old contents. | 453 | Copy region into a specified buffer, deleting that buffer's old contents. |
| 452 | @item M-x insert-buffer | 454 | @item M-x insert-buffer |
| 453 | Insert contents of specified buffer into current buffer at point. | 455 | Insert the contents of specified buffer into current buffer at point. |
| 454 | @item M-x append-to-file | 456 | @item M-x append-to-file |
| 455 | Append region to contents of specified file, at the end. | 457 | Append 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 |
| 462 | wherever point is in that buffer. If you have been using the buffer for | 464 | wherever point is in that buffer. If you have been using the buffer for |
| 463 | editing, the copied text goes into the middle of the text of the buffer, | 465 | editing, the copied text goes into the middle of the text of the buffer, |
| 464 | wherever point happens to be in it. | 466 | starting 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 |
| 467 | successive uses of @code{append-to-buffer} accumulate the text in the | 469 | successive 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} |
| 475 | except that point in the other buffer is left before the copied text, so | 477 | except that point in the other buffer is left before the copied text, so |
| 476 | successive prependings add text in reverse order. @kbd{M-x | 478 | successive prependings add text in reverse order. @kbd{M-x |
| 477 | copy-to-buffer} is similar except that any existing text in the other | 479 | copy-to-buffer} is similar, except that any existing text in the other |
| 478 | buffer is deleted, so the buffer is left containing just the text newly | 480 | buffer is deleted, so the buffer is left containing just the text newly |
| 479 | copied into it. | 481 | copied 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 |
| 513 | by putting the mark at one corner and point at the opposite corner. The | 515 | by putting the mark at one corner and point at the opposite corner. The |
| 514 | rectangle thus specified is called the @dfn{region-rectangle} because | 516 | rectangle thus specified is called the @dfn{region-rectangle} because |
| 515 | you control it in about the same way the region is controlled. But | 517 | you control it in much the same way as the region is controlled. But |
| 516 | remember that a given combination of point and mark values can be | 518 | remember that a given combination of point and mark values can be |
| 517 | interpreted either as a region or as a rectangle, depending on the | 519 | interpreted either as a region or as a rectangle, depending on the |
| 518 | command that uses them. | 520 | command that uses them. |
| @@ -548,8 +550,8 @@ Replace rectangle contents with @var{string} on each line. | |||
| 548 | Insert @var{string} on each line of the rectangle. | 550 | Insert @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 |
| 552 | inserting rectangles, and commands for blank rectangles. | 554 | deleting 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'' | |||
| 560 | rectangle. The commands for these two ways are @kbd{C-x r d} | 562 | rectangle. 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 |
| 562 | either case, the portion of each line that falls inside the rectangle's | 564 | either case, the portion of each line that falls inside the rectangle's |
| 563 | boundaries is deleted, causing following text (if any) on the line to | 565 | boundaries is deleted, causing any following text on the line to |
| 564 | move left into the gap. | 566 | move 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 |
| 576 | one. Point specifies where to put the rectangle's upper left corner. | 578 | one. Point specifies where to put the rectangle's upper left corner. |
| 577 | The rectangle's first line is inserted there, the rectangle's second | 579 | The rectangle's first line is inserted there, the rectangle's second |
| 578 | line is inserted at a position one line vertically down, and so on. The | 580 | line is inserted at the same horizontal, but one line vertically down, |
| 579 | number of lines affected is determined by the height of the saved | 581 | and so on. The number of lines affected is determined by the height of |
| 580 | rectangle. | 582 | the 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 |
| 583 | rectangle killing and yanking; kill the second half of the list as a | 585 | rectangle 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 | |||
| 31 | syntactical properties of characters appearing in the buffer. | 31 | syntactical 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 |
| 35 | several variants), C mode, Fortran mode and others are for specific | 35 | contains Lisp mode (which has several variants), C mode, Fortran mode |
| 36 | programming languages. Text mode, Nroff mode, SGML mode, @TeX{} mode | 36 | and others. These modes are for specific programming languages. The |
| 37 | and Outline mode are for normal text, plain or marked up. The remaining | 37 | second group contains Text mode, Nroff mode, SGML mode, @TeX{} mode |
| 38 | major modes are not intended for use on users' files; they are used in | 38 | and Outline mode. These modes are for normal text, plain or marked |
| 39 | buffers created for specific purposes by Emacs, such as Dired mode for | 39 | up. The remaining major modes are not intended for use on users' |
| 40 | buffers made by Dired (@pxref{Dired}), Mail mode for buffers made by | 40 | files; 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 | 41 | Emacs, such as Dired mode for buffers made by Dired (@pxref{Dired}), |
| 42 | communicating with an inferior shell process (@pxref{Interactive | 42 | Mail mode for buffers made by @kbd{C-x m} (@pxref{Sending Mail}), and |
| 43 | Shell}). | 43 | Shell mode for buffers used for communicating with an inferior shell |
| 44 | process (@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 |
| 46 | separate paragraphs. This is to make the paragraph commands useful. | 47 | separate paragraphs. This is to make the paragraph commands useful. |
| @@ -88,8 +89,8 @@ or this form, | |||
| 88 | For example, one element normally found in the list has the form | 89 | For 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 |
| 90 | mode for files whose names end in @file{.c}. (Note that @samp{\\} is | 91 | mode for files whose names end in @file{.c}. (Note that @samp{\\} is |
| 91 | needed in Lisp syntax to include a @samp{\} in the string, which is | 92 | needed in Lisp syntax to include a @samp{\} in the string, which must |
| 92 | needed to suppress the special meaning of @samp{.} in regexps.) If the | 93 | be used to suppress the special meaning of @samp{.} in regexps.) If the |
| 93 | element has the form @code{(@var{regexp} @var{mode-function} | 94 | element 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 |
| 108 | tells Emacs to use Lisp mode. Such an explicit specification overrides | 109 | tells Emacs to use Lisp mode. Such an explicit specification overrides |
| 109 | any defaulting based on the file name. Note how the semicolon is used | 110 | any defaults based on the file name. Note how the semicolon is used |
| 110 | to make Lisp treat this line as a comment. | 111 | to 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. | |||
| 158 | mode Emacs would choose automatically: use the command @kbd{M-x | 159 | mode Emacs would choose automatically: use the command @kbd{M-x |
| 159 | normal-mode} to do this. This is the same function that | 160 | normal-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 |
| 161 | the file's local variables list if any. | 162 | the 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 |
| 97 | to show you where the mark is located. You have to remember. The usual | 97 | to show you where the mark is located. You have to remember. The usual |
| 98 | solution to this problem is to set the mark and then use it soon, before | 98 | solution to this problem is to set the mark and then use it before |
| 99 | you forget where it is. Alternatively, you can see where the mark is | 99 | you forget where it is. Alternatively, you can see where the mark is |
| 100 | with the command @kbd{C-x C-x} (@code{exchange-point-and-mark}) which | 100 | with the command @kbd{C-x C-x} (@code{exchange-point-and-mark}) which |
| 101 | puts the mark where point was and point where the mark was. The extent | 101 | puts 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 |
| 107 | of point but want to move the other end of the region (where the mark | 107 | of point but want to move the other end of the region (where the mark |
| 108 | is); do @kbd{C-x C-x} to put point at that end of the region, and then | 108 | is); do @kbd{C-x C-x} to put point at that end of the region, and then |
| 109 | move it. A second use of @kbd{C-x C-x}, if necessary, puts the mark at | 109 | move it. Using @kbd{C-x C-x} a second time, if necessary, puts the mark at |
| 110 | the new position with point back at its original position. | 110 | the 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 |
| 157 | To set the mark, type @kbd{C-@key{SPC}} (@code{set-mark-command}). | 157 | To set the mark, type @kbd{C-@key{SPC}} (@code{set-mark-command}). |
| 158 | This makes the mark active; as you move point, you will see the region | 158 | This makes the mark active; as you move point, you will see the |
| 159 | highlighting grow and shrink. | 159 | highlighted region grow and shrink. |
| 160 | 160 | ||
| 161 | @item | 161 | @item |
| 162 | The mouse commands for specifying the mark also make it active. So do | 162 | The 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 | |||
| 175 | region active again by typing @kbd{C-x C-x}. | 175 | region active again by typing @kbd{C-x C-x}. |
| 176 | 176 | ||
| 177 | @item | 177 | @item |
| 178 | Commands like @kbd{M->} and @kbd{C-s} that ``leave the mark behind'' in | 178 | Commands like @kbd{M->} and @kbd{C-s} that ``leave the mark behind'', in |
| 179 | addition to some other primary purpose do not activate the new mark. | 179 | addition to some other primary purpose, do not activate the new mark. |
| 180 | You can activate the new region by executing @kbd{C-x C-x} | 180 | You 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 | |||
| 195 | in their own documentation. | 195 | in 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 |
| 199 | customize how the region is highlighted by changing this face. | 199 | customize the appearance of the highlighted region by changing this |
| 200 | @xref{Face Customization}. | 200 | face. @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 | |||
| 206 | window highlights its region (@pxref{Windows}). However, if the | 206 | window highlights its region (@pxref{Windows}). However, if the |
| 207 | variable @code{highlight-nonselected-windows} is non-@code{nil}, then | 207 | variable @code{highlight-nonselected-windows} is non-@code{nil}, then |
| 208 | each window highlights its own region (provided that Transient Mark mode | 208 | each window highlights its own region (provided that Transient Mark mode |
| 209 | is enabled and the window's buffer's mark is active). | 209 | is 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 |
| 212 | mark also activates it, and nothing ever deactivates it. | 212 | mark also activates it, and nothing ever deactivates it. |
| @@ -249,8 +249,8 @@ Print hardcopy with @kbd{M-x print-region} (@pxref{Hardcopy}). | |||
| 249 | Evaluate it as Lisp code with @kbd{M-x eval-region} (@pxref{Lisp Eval}). | 249 | Evaluate 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 |
| 253 | region 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-@@ |
| 264 | Set mark after end of next word (@code{mark-word}). This command and | 264 | Set mark after the end of next word (@code{mark-word}). This command and |
| 265 | the following one do not move point. | 265 | the following one do not move point. |
| 266 | @item C-M-@@ | 266 | @item C-M-@@ |
| 267 | Set mark after end of following balanced expression (@code{mark-sexp}). | 267 | Set mark after the end of following balanced expression (@code{mark-sexp}). |
| 268 | @item M-h | 268 | @item M-h |
| 269 | Put region around current paragraph (@code{mark-paragraph}). | 269 | Put region around the current paragraph (@code{mark-paragraph}). |
| 270 | @item C-M-h | 270 | @item C-M-h |
| 271 | Put region around current defun (@code{mark-defun}). | 271 | Put region around the current defun (@code{mark-defun}). |
| 272 | @item C-x h | 272 | @item C-x h |
| 273 | Put region around entire buffer (@code{mark-whole-buffer}). | 273 | Put region around the entire buffer (@code{mark-whole-buffer}). |
| 274 | @item C-x C-p | 274 | @item C-x C-p |
| 275 | Put region around current page (@code{mark-page}). | 275 | Put 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 | |||
| 288 | the mark at the end of that paragraph (@pxref{Paragraphs}). It prepares | 288 | the mark at the end of that paragraph (@pxref{Paragraphs}). It prepares |
| 289 | the region so you can indent, case-convert, or kill a whole paragraph. | 289 | the 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 |
| 292 | mark after the current or following major top-level definition, or | 292 | mark after, the current or following major top-level definition, or |
| 293 | defun (@pxref{Moving by Defuns}). @kbd{C-x C-p} (@code{mark-page}) | 293 | defun (@pxref{Moving by Defuns}). @kbd{C-x C-p} (@code{mark-page}) |
| 294 | puts point before the current page, and mark at the end | 294 | puts 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 | |||
| 315 | feature more useful, each buffer remembers 16 previous locations of the | 315 | feature more useful, each buffer remembers 16 previous locations of the |
| 316 | mark, in the @dfn{mark ring}. Commands that set the mark also push the | 316 | mark, in the @dfn{mark ring}. Commands that set the mark also push the |
| 317 | old mark onto this ring. To return to a marked location, use @kbd{C-u | 317 | old mark onto this ring. To return to a marked location, use @kbd{C-u |
| 318 | C-@key{SPC}} (or @kbd{C-u C-@@}); this is the command | 318 | C-@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 |
| 320 | where the mark was, and restores the mark from the ring of former | 320 | where the mark was, and restores the mark from the ring of former |
| 321 | marks. Thus, repeated use of this command moves point to all of the old | 321 | marks. 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 |
| 343 | entries to keep in the mark ring. If that many entries exist and | 343 | entries to keep in the mark ring. If that many entries exist and |
| 344 | another one is pushed, the last one in the list is discarded. Repeating | 344 | another 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 |
| 346 | ring. | 346 | ring. |
| 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 |
| 25 | colon; it too is part of the prompt. The default will be used as the | 25 | colon; it too is part of the prompt. The default will be used as the |
| 26 | argument value if you enter an empty argument (for example, just type | 26 | argument 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 |
| 28 | default, which is the name of the buffer that will be used if you type | 28 | default, which is the name of the buffer that will be used if you type |
| 29 | just @key{RET}. | 29 | just @key{RET}. |
| @@ -146,13 +146,14 @@ minibuffer window. But you can make it taller in the normal fashion | |||
| 146 | with @kbd{C-x ^}. | 146 | with @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 |
| 150 | that you put in the minibuffer if @code{resize-mini-windows} is | 150 | text that you put in the minibuffer if @code{resize-mini-windows} is |
| 151 | non-@code{nil}. If @code{resize-mini-windows} is @code{t}, the window | 151 | non-@code{nil}. If @code{resize-mini-windows} is @code{t}, the window |
| 152 | is always resized to fit the size of the text it displays. If | 152 | is 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 |
| 154 | is enlarged only, until it becomes empty again, at which point it | 154 | is enlarged when the size of displayed text grows, but never shrinked |
| 155 | shrinks to its normal size again. | 155 | until it becomes empty, at which point it shrinks back to its normal |
| 156 | size. | ||
| 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 |
| 165 | of any sort in another window, you can use the @kbd{C-M-v} command while | 166 | of any sort in another window, you can use the @kbd{C-M-v} command while |
| 166 | in the minibuffer to scroll the help text. This lasts until you exit | 167 | in the minibuffer to scroll the help text. This lasts until you exit |
| 167 | the minibuffer. This feature is especially useful if a completing | 168 | the minibuffer. This feature is especially useful if the |
| 168 | minibuffer gives you a list of possible completions. @xref{Other Window}. | 169 | minibuffer 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 | |||
| 265 | type @key{SPC}, it finds that the completion is @samp{auto-fill-mode}, | 266 | type @key{SPC}, it finds that the completion is @samp{auto-fill-mode}, |
| 266 | but it stops completing after @samp{fill-}. This gives | 267 | but 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 |
| 268 | way to @samp{auto-fill-mode}. @key{SPC} in the minibuffer when | 269 | way to @samp{auto-fill-mode}. Typing @key{SPC} in the minibuffer when |
| 269 | completion is available runs the command | 270 | completion 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 |
| 278 | Clicking mouse button 2 on a completion in the list of possible | 279 | Clicking mouse button 2 on a completion in the list of possible |
| 279 | completions chooses that completion (@code{mouse-choose-completion}). | 280 | completions chooses that completion (@code{mouse-choose-completion}). |
| 280 | You normally use this command while point is in the minibuffer; but you | 281 | You normally use this command while point is in the minibuffer, but you |
| 281 | must click in the list of completions, not in the minibuffer itself. | 282 | must 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 | |||
| 365 | lists of completions---those always mention all possible completions. | 366 | lists 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 |
| 369 | automatically displays a list of all possible completions. If the variable | 370 | undetermined automatically displays a list of all possible |
| 370 | @code{completion-auto-help} is set to @code{nil}, this does not happen, | 371 | completions. If the variable @code{completion-auto-help} is set to |
| 371 | and you must type @kbd{?} to display the possible completions. | 372 | @code{nil}, this does not happen, and you must type @kbd{?} to display |
| 373 | the 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}). | |||
| 223 | Clear out the region-rectangle with spaces | 223 | Clear 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} |
| 226 | Similar but save rectangle contents in register @var{r} first | 226 | Similar, 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 |
| 229 | Copy last killed rectangle into the buffer by overwriting, with upper | 229 | Copy 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 |
| 258 | standard ones in overwriting instead of inserting. This is the same way | 258 | standard ones in that they overwrite instead of inserting. This is |
| 259 | that Picture mode insertion of other text differs from other modes. | 259 | the same way that Picture mode insertion of other text differs from |
| 260 | @kbd{C-c C-y} (@code{picture-yank-rectangle}) inserts (by overwriting) | 260 | other modes. @kbd{C-c C-y} (@code{picture-yank-rectangle}) inserts |
| 261 | the 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 |
| 263 | rectangle found in a specified register. | 263 | likewise 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 | |||
| 198 | initialized from that environment variable. | 198 | initialized from that environment variable. |
| 199 | 199 | ||
| 200 | @item In-reply-to | 200 | @item In-reply-to |
| 201 | This field contains a piece of text describing a message you are | 201 | This field contains a piece of text describing the message you are |
| 202 | replying to. Some mail systems can use this information to correlate | 202 | replying to. Some mail systems can use this information to correlate |
| 203 | related pieces of mail. Normally this field is filled in by Rmail | 203 | related pieces of mail. Normally this field is filled in by Rmail |
| 204 | when you reply to a message in Rmail, and you never need to | 204 | when 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 |
| 383 | to Mail mode in a file-visiting buffer. That is a useful thing to do if | 383 | to Mail mode in a file-visiting buffer. This is a useful thing to do if |
| 384 | you have saved draft message text in a file. | 384 | you 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 |
| 490 | the local users' names plus your personal mail aliases. You can | 490 | the local users' names plus your personal mail aliases. You can |
| 491 | specify additional sources of valid addresses; look at customization | 491 | specify additional sources of valid addresses; look at the customization |
| 492 | group @samp{mailalias} to see the options for this | 492 | group @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 | |||
| 564 | Insert the contents of @var{file} at the end of the outgoing message | 564 | Insert 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 |
| 567 | Do spelling correction on the message text, but not on citations from | 567 | Perform spelling correction on the message text, but not on citations from |
| 568 | other messages. | 568 | other 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. | |||
| 580 | the end of the message to say more about who you are. The text comes | 580 | the end of the message to say more about who you are. The text comes |
| 581 | from the file @file{~/.signature} in your home directory. To insert | 581 | from the file @file{~/.signature} in your home directory. To insert |
| 582 | your signature automatically, set the variable @code{mail-signature} to | 582 | your 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 |
| 584 | contents of your @file{~/.signature} file. If you want to omit your | 584 | contents of your @file{~/.signature} file. If you want to omit your |
| 585 | signature from a particular message, delete it from the buffer before | 585 | signature from a particular message, delete it from the buffer before |
| 586 | you send the message. | 586 | you 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 |
| 621 | invoked. Whenever you type @kbd{M-x mail}, @code{mail-mode-hook} runs | 621 | invoked. Whenever you type @kbd{M-x mail}, @code{mail-mode-hook} runs |
| 622 | as soon as the @samp{*mail*} buffer is created. Then the | 622 | as 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. |
| 624 | After these default contents are inserted, @code{mail-setup-hook} runs. | 624 | After 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, |
| 673 | Message Manual}. You can choose any of them as your preferred method. | 673 | Message Manual}. You can choose any of them as your preferred method. |
| 674 | The commands @code{C-x m}, @code{C-x 4 m} and @code{C-x 5 m} use | 674 | The commands @code{C-x m}, @code{C-x 4 m} and @code{C-x 5 m} use |
| 675 | whichever agent you have specified. So do various other Emacs commands | 675 | whichever agent you have specified, as do various other Emacs commands |
| 676 | and facilities that send mail. | 676 | and facilities that send mail. |
| 677 | 677 | ||
| 678 | @vindex mail-user-agent | 678 | @vindex mail-user-agent |