From 2a90dfca8e7493d05768e3926eaeb295b8338734 Mon Sep 17 00:00:00 2001 From: Dani Moncayo Date: Fri, 27 Jan 2012 16:19:19 +0800 Subject: [PATCH] Doc fixes for buffers.texi and text.texi in Emacs manual. * doc/emacs/buffers.texi (Select Buffer): Clarify explanation of switching to new buffers. Fix description of next-buffer and previous-buffer (Bug#10334). (Misc Buffer): Add xref to View Mode. * doc/emacs/text.texi (Fill Commands): Fix description of sentence-end-double-space. --- doc/emacs/ChangeLog | 10 ++++++++++ doc/emacs/buffers.texi | 31 ++++++++++++++++--------------- doc/emacs/text.texi | 10 +++++----- 3 files changed, 31 insertions(+), 20 deletions(-) diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog index 9aa4899e591..5c56720a40e 100644 --- a/doc/emacs/ChangeLog +++ b/doc/emacs/ChangeLog @@ -1,3 +1,13 @@ +2012-01-27 Dani Moncayo + + * buffers.texi (Select Buffer): Clarify explanation of switching + to new buffers. Fix description of next-buffer and + previous-buffer (Bug#10334). + (Misc Buffer): Add xref to View Mode. + + * text.texi (Fill Commands): Fix description of + sentence-end-double-space. + 2012-01-23 Chong Yidong * anti.texi (Antinews): Add Emacs 23 antinews. diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi index fb71e04c184..0b471ca5027 100644 --- a/doc/emacs/buffers.texi +++ b/doc/emacs/buffers.texi @@ -90,9 +90,7 @@ selected buffer other than the current buffer. name using the minibuffer. Then it makes that buffer current, and displays it in the currently-selected window. An empty input specifies the buffer that was current most recently among those not -now displayed in any window. If you specify a buffer that does not -exist, @kbd{C-x b} creates a new, empty buffer that is not visiting -any file, and selects it for editing. +now displayed in any window. While entering the buffer name, you can use the usual completion and history commands (@pxref{Minibuffer}). Note that @kbd{C-x b}, and @@ -102,21 +100,24 @@ completing up to a nonexistent buffer name, Emacs prints @samp{[Confirm]} and you must type a second @key{RET} to submit that buffer name. @xref{Completion Exit}, for details. - One reason to create a new buffer is to use it for making temporary -notes. If you try to save it, Emacs asks for the file name to use. -The default value of the variable @code{major-mode} determines the new -buffer's major mode; the default value is Fundamental mode. @xref{Major -Modes}. + If you specify a buffer that does not exist, @kbd{C-x b} creates a +new, empty buffer that is not visiting any file, and selects it for +editing. The default value of the variable @code{major-mode} +determines the new buffer's major mode; the default value is +Fundamental mode. @xref{Major Modes}. One reason to create a new +buffer is to use it for making temporary notes. If you try to save +it, Emacs asks for the file name to use. @kindex C-x @key{LEFT} @kindex C-x @key{RIGHT} @findex next-buffer @findex previous-buffer For conveniently switching between a few buffers, use the commands -@kbd{C-x @key{LEFT}} and @kbd{C-x @key{RIGHT}}. @kbd{C-x @key{RIGHT}} -(@code{previous-buffer}) selects the previous buffer (following the order -of most recent selection in the current frame), while @kbd{C-x @key{LEFT}} -(@code{next-buffer}) moves through buffers in the reverse direction. +@kbd{C-x @key{LEFT}} and @kbd{C-x @key{RIGHT}}. @kbd{C-x @key{LEFT}} +(@code{previous-buffer}) selects the previous buffer (following the +order of most recent selection in the current frame), while @kbd{C-x +@key{RIGHT}} (@code{next-buffer}) moves through buffers in the reverse +direction. @kindex C-x 4 b @findex switch-to-buffer-other-window @@ -215,7 +216,7 @@ Change the name of the current buffer. @item M-x rename-uniquely Rename the current buffer by adding @samp{<@var{number}>} to the end. @item M-x view-buffer @key{RET} @var{buffer} @key{RET} -Scroll through buffer @var{buffer}. +Scroll through buffer @var{buffer}. @xref{View Mode}. @end table @kindex C-x C-q @@ -256,8 +257,8 @@ switch to some other buffer before using the command, in order for it to make a different buffer.) The commands @kbd{M-x append-to-buffer} and @kbd{M-x insert-buffer} -can be used to copy text from one buffer to another. @xref{Accumulating -Text}. +can also be used to copy text from one buffer to another. +@xref{Accumulating Text}. @node Kill Buffer @section Killing Buffers diff --git a/doc/emacs/text.texi b/doc/emacs/text.texi index ccc546fb0a1..591ca80f27c 100644 --- a/doc/emacs/text.texi +++ b/doc/emacs/text.texi @@ -546,11 +546,11 @@ made by Text mode and is available only in that and related modes newline as the end of a sentence; a period followed by just one space indicates an abbreviation, not the end of a sentence. Accordingly, the fill commands will not break a line after a period followed by -just one space. If you change the variable -@code{sentence-end-double-space} to a non-@code{nil} value, the fill -commands will break a line after a period followed by one space, and -put just one space after each period. @xref{Sentences}, for other -effects and possible drawbacks of this. +just one space. If you set the variable +@code{sentence-end-double-space} to @code{nil}, the fill commands will +break a line after a period followed by one space, and put just one +space after each period. @xref{Sentences}, for other effects and +possible drawbacks of this. @vindex colon-double-space If the variable @code{colon-double-space} is non-@code{nil}, the -- 2.11.4.GIT