diff options
| author | Richard M. Stallman | 2006-02-02 04:35:19 +0000 |
|---|---|---|
| committer | Richard M. Stallman | 2006-02-02 04:35:19 +0000 |
| commit | a3053e277ed439b34565288a3dc04bb6f4799e06 (patch) | |
| tree | db81b5f31522a8cb9e101b94360e09f7a4c0c0de | |
| parent | 54b6e2d15f651ddb54aabf81f9607d042a62d69c (diff) | |
| download | emacs-a3053e277ed439b34565288a3dc04bb6f4799e06.tar.gz emacs-a3053e277ed439b34565288a3dc04bb6f4799e06.zip | |
Minor clarifications.
| -rw-r--r-- | man/buffers.texi | 49 | ||||
| -rw-r--r-- | man/indent.texi | 24 | ||||
| -rw-r--r-- | man/major.texi | 8 |
3 files changed, 40 insertions, 41 deletions
diff --git a/man/buffers.texi b/man/buffers.texi index 3e4b311bd50..a8e23086f79 100644 --- a/man/buffers.texi +++ b/man/buffers.texi | |||
| @@ -87,8 +87,8 @@ selected buffer other than the current buffer. | |||
| 87 | @findex switch-to-buffer | 87 | @findex switch-to-buffer |
| 88 | To select the buffer named @var{bufname}, type @kbd{C-x b @var{bufname} | 88 | To select the buffer named @var{bufname}, type @kbd{C-x b @var{bufname} |
| 89 | @key{RET}}. This runs the command @code{switch-to-buffer} with argument | 89 | @key{RET}}. This runs the command @code{switch-to-buffer} with argument |
| 90 | @var{bufname}. You can use completion on an abbreviation for the buffer | 90 | @var{bufname}. You can use completion to enter the buffer |
| 91 | name you want (@pxref{Completion}). An empty argument to @kbd{C-x b} | 91 | name (@pxref{Completion}). An empty argument to @kbd{C-x b} |
| 92 | specifies the buffer that was current most recently among those not | 92 | specifies the buffer that was current most recently among those not |
| 93 | now displayed in any window. | 93 | now displayed in any window. |
| 94 | 94 | ||
| @@ -128,7 +128,7 @@ customizing the variables @code{special-display-buffer-names}, | |||
| 128 | @ref{Special Buffer Frames}, for more about these variables. In | 128 | @ref{Special Buffer Frames}, for more about these variables. In |
| 129 | addition, if the value of @code{display-buffer-reuse-frames} is | 129 | addition, if the value of @code{display-buffer-reuse-frames} is |
| 130 | non-@code{nil}, and the buffer you want to switch to is already | 130 | non-@code{nil}, and the buffer you want to switch to is already |
| 131 | displayed in some frame, Emacs will raise that frame. | 131 | displayed in some frame, Emacs will just raise that frame. |
| 132 | 132 | ||
| 133 | Most buffers are created by visiting files, or by Emacs commands that | 133 | Most buffers are created by visiting files, or by Emacs commands that |
| 134 | want to display some text, but you can also create a buffer explicitly | 134 | want to display some text, but you can also create a buffer explicitly |
| @@ -177,10 +177,11 @@ line in the list shows one buffer's name, major mode and visited file. | |||
| 177 | The buffers are listed in the order that they were current; the | 177 | The buffers are listed in the order that they were current; the |
| 178 | buffers that were current most recently come first. | 178 | buffers that were current most recently come first. |
| 179 | 179 | ||
| 180 | @samp{*} in the first field of a line indicates the buffer is ``modified.'' | 180 | @samp{*} in the first field of a line indicates the buffer is |
| 181 | If several buffers are modified, it may be time to save some with @kbd{C-x s} | 181 | ``modified.'' If several buffers are modified, it may be time to save |
| 182 | (@pxref{Save Commands}). @samp{%} indicates a read-only buffer. @samp{.} marks the | 182 | some with @kbd{C-x s} (@pxref{Save Commands}). @samp{%} indicates a |
| 183 | current buffer. Here is an example of a buffer list:@refill | 183 | read-only buffer. @samp{.} marks the current buffer. Here is an |
| 184 | example of a buffer list:@refill | ||
| 184 | 185 | ||
| 185 | @smallexample | 186 | @smallexample |
| 186 | CRM Buffer Size Mode File | 187 | CRM Buffer Size Mode File |
| @@ -199,7 +200,7 @@ CRM Buffer Size Mode File | |||
| 199 | Note that the buffer @samp{*Help*} was made by a help request; it is | 200 | Note that the buffer @samp{*Help*} was made by a help request; it is |
| 200 | not visiting any file. The buffer @code{src} was made by Dired on the | 201 | not visiting any file. The buffer @code{src} was made by Dired on the |
| 201 | directory @file{~/cvs/emacs/src/}. You can list only buffers that are | 202 | directory @file{~/cvs/emacs/src/}. You can list only buffers that are |
| 202 | visiting files by giving the command a prefix; for instance, by typing | 203 | visiting files by giving the command a prefix argument, as in |
| 203 | @kbd{C-u C-x C-b}. | 204 | @kbd{C-u C-x C-b}. |
| 204 | 205 | ||
| 205 | @code{list-buffers} omits buffers whose names begin with a space, | 206 | @code{list-buffers} omits buffers whose names begin with a space, |
| @@ -243,10 +244,10 @@ flag, but it also checks the file in or out. @xref{Version | |||
| 243 | Control}. | 244 | Control}. |
| 244 | 245 | ||
| 245 | @findex rename-buffer | 246 | @findex rename-buffer |
| 246 | @kbd{M-x rename-buffer} changes the name of the current buffer. Specify | 247 | @kbd{M-x rename-buffer} changes the name of the current buffer. You |
| 247 | the new name as a minibuffer argument. There is no default. If you | 248 | specify the new name as a minibuffer argument; there is no default. |
| 248 | specify a name that is in use for some other buffer, an error happens and | 249 | If you specify a name that is in use for some other buffer, an error |
| 249 | no renaming is done. | 250 | happens and no renaming is done. |
| 250 | 251 | ||
| 251 | @findex rename-uniquely | 252 | @findex rename-uniquely |
| 252 | @kbd{M-x rename-uniquely} renames the current buffer to a similar | 253 | @kbd{M-x rename-uniquely} renames the current buffer to a similar |
| @@ -274,7 +275,7 @@ your perusal remain in effect. | |||
| 274 | 275 | ||
| 275 | The commands @kbd{M-x append-to-buffer} and @kbd{M-x insert-buffer} | 276 | The commands @kbd{M-x append-to-buffer} and @kbd{M-x insert-buffer} |
| 276 | can be used to copy text from one buffer to another. @xref{Accumulating | 277 | can be used to copy text from one buffer to another. @xref{Accumulating |
| 277 | Text}.@refill | 278 | Text}. |
| 278 | 279 | ||
| 279 | @node Kill Buffer | 280 | @node Kill Buffer |
| 280 | @section Killing Buffers | 281 | @section Killing Buffers |
| @@ -470,17 +471,15 @@ you run @code{list-buffers} (that is, type @kbd{C-x C-b}) and select | |||
| 470 | the buffer list manually, you can use all of the commands described | 471 | the buffer list manually, you can use all of the commands described |
| 471 | here. | 472 | here. |
| 472 | 473 | ||
| 473 | Normally, the buffer @samp{*Buffer List*} is not updated automatically when | 474 | Normally, the buffer @samp{*Buffer List*} is not updated |
| 474 | buffers are created and killed; its contents are just text. If you have | 475 | automatically when buffers are created and killed; its contents are |
| 475 | created, deleted or renamed buffers, the way to update @samp{*Buffer | 476 | just text. If you have created, deleted or renamed buffers, the way |
| 476 | List*} to show what you have done is to type @kbd{g} | 477 | to update @samp{*Buffer List*} to show what you have done is to type |
| 477 | (@code{revert-buffer}) or repeat the @code{buffer-menu} command. | 478 | @kbd{g} (@code{revert-buffer}). You can make this happen regularly |
| 478 | 479 | every @code{auto-revert-interval} seconds if you enable Auto Revert | |
| 479 | The @samp{*Buffer List*} buffer does automatically update every | 480 | mode in this buffer, as long as it is not marked modified. Global |
| 480 | @code{auto-revert-interval} seconds if you enable Auto Revert mode in | 481 | Auto Revert mode applies to the @samp{*Buffer List*} buffer only if |
| 481 | it. (As long as it is not marked modified.) Global Auto Revert mode | 482 | @code{global-auto-revert-non-file-buffers} is non-@code{nil}. |
| 482 | does not update the @samp{*Buffer List*} buffer by default, but it | ||
| 483 | does if @code{global-auto-revert-non-file-buffers} is non-@code{nil}. | ||
| 484 | @inforef{Autorevert,, emacs-xtra}, for details. | 483 | @inforef{Autorevert,, emacs-xtra}, for details. |
| 485 | 484 | ||
| 486 | The command @code{buffer-menu-other-window} works the same as | 485 | The command @code{buffer-menu-other-window} works the same as |
| @@ -589,7 +588,7 @@ forward order after the file name, as in @samp{file|top/middle}. | |||
| 589 | name is not very important if you are going to @emph{look} at the | 588 | name is not very important if you are going to @emph{look} at the |
| 590 | buffer names before you type one. But as an experienced user, if you | 589 | buffer names before you type one. But as an experienced user, if you |
| 591 | know the rule, you won't have to look. And then you may find that one | 590 | know the rule, you won't have to look. And then you may find that one |
| 592 | rule or another is easier for you to remember and utilize fast. | 591 | rule or another is easier for you to remember and apply quickly. |
| 593 | 592 | ||
| 594 | @node Iswitchb | 593 | @node Iswitchb |
| 595 | @subsection Switching Between Buffers using Substrings | 594 | @subsection Switching Between Buffers using Substrings |
diff --git a/man/indent.texi b/man/indent.texi index c748f5010b1..ad0ef315fe8 100644 --- a/man/indent.texi +++ b/man/indent.texi | |||
| @@ -45,7 +45,7 @@ Insert a tab character. You can type @kbd{C-q @key{TAB}} to do this. | |||
| 45 | 45 | ||
| 46 | A tab character is displayed as a stretch of whitespace which extends | 46 | A tab character is displayed as a stretch of whitespace which extends |
| 47 | to the next display tab stop position, and the default width of a tab | 47 | to the next display tab stop position, and the default width of a tab |
| 48 | stop is eight. @xref{Display Custom}, for more details. | 48 | stop is eight. @xref{Text Display}, for more details. |
| 49 | 49 | ||
| 50 | @item | 50 | @item |
| 51 | Insert whitespace up to the next tab stop. You can set tab stops at | 51 | Insert whitespace up to the next tab stop. You can set tab stops at |
| @@ -114,13 +114,13 @@ regard, @kbd{C-M-o} resembles @kbd{C-o}. | |||
| 114 | @kindex M-^ | 114 | @kindex M-^ |
| 115 | @findex delete-indentation | 115 | @findex delete-indentation |
| 116 | To join two lines cleanly, use the @kbd{M-^} | 116 | To join two lines cleanly, use the @kbd{M-^} |
| 117 | (@code{delete-indentation}) command. It deletes the indentation at the | 117 | (@code{delete-indentation}) command. It deletes the indentation at |
| 118 | front of the current line, and the line boundary as well, replacing them | 118 | the front of the current line, and the line boundary as well, |
| 119 | with a single space. As a special case (useful for Lisp code) the | 119 | replacing them with a single space. As a special case (useful for |
| 120 | single space is omitted if the characters to be joined are consecutive | 120 | Lisp code) the single space is omitted if the characters to be joined |
| 121 | open parentheses or closing parentheses, or if the junction follows | 121 | are consecutive open parentheses or closing parentheses, or if the |
| 122 | another newline. To delete just the indentation of a line, go to the | 122 | junction follows another newline. To delete just the indentation of a |
| 123 | beginning of the line and use @kbd{M-\} | 123 | line, go to the beginning of the line and use @kbd{M-\} |
| 124 | (@code{delete-horizontal-space}), which deletes all spaces and tabs | 124 | (@code{delete-horizontal-space}), which deletes all spaces and tabs |
| 125 | around the cursor. | 125 | around the cursor. |
| 126 | 126 | ||
| @@ -140,12 +140,12 @@ shifted left or right so that its first nonblank character appears in | |||
| 140 | that column. @kbd{C-x @key{TAB}} (@code{indent-rigidly}) moves all of | 140 | that column. @kbd{C-x @key{TAB}} (@code{indent-rigidly}) moves all of |
| 141 | the lines in the region right by its argument (left, for negative | 141 | the lines in the region right by its argument (left, for negative |
| 142 | arguments). The whole group of lines moves rigidly sideways, which is | 142 | arguments). The whole group of lines moves rigidly sideways, which is |
| 143 | how the command gets its name.@refill | 143 | how the command gets its name. |
| 144 | 144 | ||
| 145 | @cindex remove indentation | 145 | @cindex remove indentation |
| 146 | If you want to remove all indentation from all of the line in the | 146 | To remove all indentation from all of the lines in the region, |
| 147 | region, invoke @kbd{C-x @key{TAB}} with a large negative argument, | 147 | invoke @kbd{C-x @key{TAB}} with a large negative argument, such as |
| 148 | such as -1000. | 148 | -1000. |
| 149 | 149 | ||
| 150 | @findex indent-relative | 150 | @findex indent-relative |
| 151 | @kbd{M-x indent-relative} indents at point based on the previous line | 151 | @kbd{M-x indent-relative} indents at point based on the previous line |
diff --git a/man/major.texi b/man/major.texi index 74613a24321..5bff7146ebe 100644 --- a/man/major.texi +++ b/man/major.texi | |||
| @@ -65,10 +65,10 @@ because most lines in a program are usually indented | |||
| 65 | most of the time Emacs determines which mode to use based on the file | 65 | most of the time Emacs determines which mode to use based on the file |
| 66 | name or on special text in the file. | 66 | name or on special text in the file. |
| 67 | 67 | ||
| 68 | Explicit selection of a new major mode is done with a @kbd{M-x} command. | 68 | To explicitly select a new major, you use an @kbd{M-x} command. |
| 69 | From the name of a major mode, add @code{-mode} to get the name of a | 69 | Take the name of a major mode and add @code{-mode} to get the name of |
| 70 | command to select that mode. Thus, you can enter Lisp mode by executing | 70 | the command to select that mode. Thus, you can enter Lisp mode by |
| 71 | @kbd{M-x lisp-mode}. | 71 | executing @kbd{M-x lisp-mode}. |
| 72 | 72 | ||
| 73 | @vindex auto-mode-alist | 73 | @vindex auto-mode-alist |
| 74 | When you visit a file, Emacs usually chooses the right major mode based | 74 | When you visit a file, Emacs usually chooses the right major mode based |