procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

More minor changes in the manual

Browse source 
* doc/emacs/display.texi (Useless Whitespace): Don't upcase "TAB"
and "SPC" when alluding to characters.  Suggested by Richard
Stallman <rms@gnu.org>.

* doc/emacs/buffers.texi (Misc Buffer): Clarify what "read-only"
means for buffers.
(Buffers): Define and describe "buffer contents".  Suggested by
Richard Stallman <rms@gnu.org>.  (Bug#30685)
This commit is contained in:
Eli Zaretskii 2018-03-08 17:53:09 +02:00
parent 685175404f
commit 7e26d8356a
2 changed files with 17 additions and 9 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
doc/emacs/buffers.texi
View file

@ -32,6 +32,13 @@ buffer. When there is only one Emacs window, the buffer displayed in
that window is current. When there are multiple windows, the buffer that window is current. When there are multiple windows, the buffer
displayed in the @dfn{selected window} is current. @xref{Windows}. displayed in the @dfn{selected window} is current. @xref{Windows}.
@cindex buffer contents
@cindex contents of a buffer
A buffer's @dfn{contents} consist of a series of characters, each of
which optionally carries a set of text properties
(@pxref{International Chars, Text properties}) that can specify more
information about that character.
Aside from its textual contents, each buffer records several pieces Aside from its textual contents, each buffer records several pieces
of information, such as what file it is visiting (if any), whether it of information, such as what file it is visiting (if any), whether it
is modified, and what major mode and minor modes are in effect is modified, and what major mode and minor modes are in effect
@ -231,13 +238,14 @@ Scroll through buffer @var{buffer}. @xref{View Mode}.
@kindex C-x C-q @kindex C-x C-q
@vindex buffer-read-only @vindex buffer-read-only
@cindex read-only buffer @cindex read-only buffer
A buffer can be @dfn{read-only}, which means that commands to change A buffer can be @dfn{read-only}, which means that commands to insert
its contents are not allowed. The mode line indicates read-only or delete its text are not allowed. (However, other commands, like
buffers with @samp{%%} or @samp{%*} near the left margin. @xref{Mode @kbd{C-x @key{RET} f}, can still mark it as modified, @pxref{Text
Line}. Read-only buffers are usually made by subsystems such as Dired Coding}). The mode line indicates read-only buffers with @samp{%%} or
and Rmail that have special commands to operate on the text. Visiting @samp{%*} near the left margin. @xref{Mode Line}. Read-only buffers
a file whose access control says you cannot write it also makes the are usually made by subsystems such as Dired and Rmail that have
buffer read-only. special commands to operate on the text. Visiting a file whose access
control says you cannot write it also makes the buffer read-only.
@findex read-only-mode @findex read-only-mode
@vindex view-read-only @vindex view-read-only

4
doc/emacs/display.texi
View file

@ -1258,7 +1258,7 @@ Highlight empty lines.
@item big-indent @item big-indent
@vindex whitespace-big-indent-regexp @vindex whitespace-big-indent-regexp
Highlight too-deep indentation. By default any sequence of at least 4 Highlight too-deep indentation. By default any sequence of at least 4
consecutive TAB characters or 32 consecutive SPC characters is consecutive tab characters or 32 consecutive space characters is
highlighted. To change that, customize the regular expression highlighted. To change that, customize the regular expression
@code{whitespace-big-indent-regexp}. @code{whitespace-big-indent-regexp}.
@ -1266,7 +1266,7 @@ highlighted. To change that, customize the regular expression
Draw SPC and non-breaking characters with a special glyph. Draw SPC and non-breaking characters with a special glyph.
@item tab-mark @item tab-mark
Draw TAB characters with a special glyph. Draw tab characters with a special glyph.
@item newline-mark @item newline-mark
Draw newline characters with a special glyph. Draw newline characters with a special glyph.