aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorRichard M. Stallman2006-02-02 04:35:19 +0000
committerRichard M. Stallman2006-02-02 04:35:19 +0000
commita3053e277ed439b34565288a3dc04bb6f4799e06 (patch)
treedb81b5f31522a8cb9e101b94360e09f7a4c0c0de
parent54b6e2d15f651ddb54aabf81f9607d042a62d69c (diff)
downloademacs-a3053e277ed439b34565288a3dc04bb6f4799e06.tar.gz
emacs-a3053e277ed439b34565288a3dc04bb6f4799e06.zip
Minor clarifications.
-rw-r--r--man/buffers.texi49
-rw-r--r--man/indent.texi24
-rw-r--r--man/major.texi8
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
91name you want (@pxref{Completion}). An empty argument to @kbd{C-x b} 91name (@pxref{Completion}). An empty argument to @kbd{C-x b}
92specifies the buffer that was current most recently among those not 92specifies the buffer that was current most recently among those not
93now displayed in any window. 93now 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
129addition, if the value of @code{display-buffer-reuse-frames} is 129addition, if the value of @code{display-buffer-reuse-frames} is
130non-@code{nil}, and the buffer you want to switch to is already 130non-@code{nil}, and the buffer you want to switch to is already
131displayed in some frame, Emacs will raise that frame. 131displayed 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
134want to display some text, but you can also create a buffer explicitly 134want 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.
177The buffers are listed in the order that they were current; the 177The buffers are listed in the order that they were current; the
178buffers that were current most recently come first. 178buffers 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
181If 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 182some with @kbd{C-x s} (@pxref{Save Commands}). @samp{%} indicates a
183current buffer. Here is an example of a buffer list:@refill 183read-only buffer. @samp{.} marks the current buffer. Here is an
184example of a buffer list:@refill
184 185
185@smallexample 186@smallexample
186CRM Buffer Size Mode File 187CRM Buffer Size Mode File
@@ -199,7 +200,7 @@ CRM Buffer Size Mode File
199Note that the buffer @samp{*Help*} was made by a help request; it is 200Note that the buffer @samp{*Help*} was made by a help request; it is
200not visiting any file. The buffer @code{src} was made by Dired on the 201not visiting any file. The buffer @code{src} was made by Dired on the
201directory @file{~/cvs/emacs/src/}. You can list only buffers that are 202directory @file{~/cvs/emacs/src/}. You can list only buffers that are
202visiting files by giving the command a prefix; for instance, by typing 203visiting 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
243Control}. 244Control}.
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
247the new name as a minibuffer argument. There is no default. If you 248specify the new name as a minibuffer argument; there is no default.
248specify a name that is in use for some other buffer, an error happens and 249If you specify a name that is in use for some other buffer, an error
249no renaming is done. 250happens 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}
276can be used to copy text from one buffer to another. @xref{Accumulating 277can be used to copy text from one buffer to another. @xref{Accumulating
277Text}.@refill 278Text}.
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
470the buffer list manually, you can use all of the commands described 471the buffer list manually, you can use all of the commands described
471here. 472here.
472 473
473 Normally, the buffer @samp{*Buffer List*} is not updated automatically when 474 Normally, the buffer @samp{*Buffer List*} is not updated
474buffers are created and killed; its contents are just text. If you have 475automatically when buffers are created and killed; its contents are
475created, deleted or renamed buffers, the way to update @samp{*Buffer 476just text. If you have created, deleted or renamed buffers, the way
476List*} to show what you have done is to type @kbd{g} 477to 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 479every @code{auto-revert-interval} seconds if you enable Auto Revert
479 The @samp{*Buffer List*} buffer does automatically update every 480mode 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 481Auto Revert mode applies to the @samp{*Buffer List*} buffer only if
481it. (As long as it is not marked modified.) Global Auto Revert mode 482@code{global-auto-revert-non-file-buffers} is non-@code{nil}.
482does not update the @samp{*Buffer List*} buffer by default, but it
483does 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}.
589name is not very important if you are going to @emph{look} at the 588name is not very important if you are going to @emph{look} at the
590buffer names before you type one. But as an experienced user, if you 589buffer names before you type one. But as an experienced user, if you
591know the rule, you won't have to look. And then you may find that one 590know the rule, you won't have to look. And then you may find that one
592rule or another is easier for you to remember and utilize fast. 591rule 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
46A tab character is displayed as a stretch of whitespace which extends 46A tab character is displayed as a stretch of whitespace which extends
47to the next display tab stop position, and the default width of a tab 47to the next display tab stop position, and the default width of a tab
48stop is eight. @xref{Display Custom}, for more details. 48stop is eight. @xref{Text Display}, for more details.
49 49
50@item 50@item
51Insert whitespace up to the next tab stop. You can set tab stops at 51Insert 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
118front of the current line, and the line boundary as well, replacing them 118the front of the current line, and the line boundary as well,
119with a single space. As a special case (useful for Lisp code) the 119replacing them with a single space. As a special case (useful for
120single space is omitted if the characters to be joined are consecutive 120Lisp code) the single space is omitted if the characters to be joined
121open parentheses or closing parentheses, or if the junction follows 121are consecutive open parentheses or closing parentheses, or if the
122another newline. To delete just the indentation of a line, go to the 122junction follows another newline. To delete just the indentation of a
123beginning of the line and use @kbd{M-\} 123line, 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
125around the cursor. 125around the cursor.
126 126
@@ -140,12 +140,12 @@ shifted left or right so that its first nonblank character appears in
140that column. @kbd{C-x @key{TAB}} (@code{indent-rigidly}) moves all of 140that column. @kbd{C-x @key{TAB}} (@code{indent-rigidly}) moves all of
141the lines in the region right by its argument (left, for negative 141the lines in the region right by its argument (left, for negative
142arguments). The whole group of lines moves rigidly sideways, which is 142arguments). The whole group of lines moves rigidly sideways, which is
143how the command gets its name.@refill 143how 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,
147region, invoke @kbd{C-x @key{TAB}} with a large negative argument, 147invoke @kbd{C-x @key{TAB}} with a large negative argument, such as
148such 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
65most of the time Emacs determines which mode to use based on the file 65most of the time Emacs determines which mode to use based on the file
66name or on special text in the file. 66name 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.
69From the name of a major mode, add @code{-mode} to get the name of a 69Take the name of a major mode and add @code{-mode} to get the name of
70command to select that mode. Thus, you can enter Lisp mode by executing 70the command to select that mode. Thus, you can enter Lisp mode by
71@kbd{M-x lisp-mode}. 71executing @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