[Emacs-diffs] emacs-26 7e26d83: More minor changes in the manual

[Eli Zaretskii]

branch: emacs-26
commit 7e26d8356aad20d62b54a6fd649ba577ae9a48a8
Author: Eli Zaretskii <address@hidden>
Commit: Eli Zaretskii <address@hidden>

    More minor changes in the manual
    
    * doc/emacs/display.texi (Useless Whitespace): Don't upcase "TAB"
    and "SPC" when alluding to characters.  Suggested by Richard
    Stallman <address@hidden>.
    
    * doc/emacs/buffers.texi (Misc Buffer): Clarify what "read-only"
    means for buffers.
    (Buffers): Define and describe "buffer contents".  Suggested by
    Richard Stallman <address@hidden>.  (Bug#30685)
---
 doc/emacs/buffers.texi | 22 +++++++++++++++-------
 doc/emacs/display.texi |  4 ++--
 2 files changed, 17 insertions(+), 9 deletions(-)

diff --git a/doc/emacs/buffers.texi b/doc/emacs/buffers.texi
index f8c1856..dd7a653 100644
--- a/doc/emacs/buffers.texi
+++ b/doc/emacs/buffers.texi
@@ -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
 displayed in the @dfn{selected window} is current.  @xref{Windows}.
 
address@hidden buffer contents
address@hidden 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
 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
@@ -231,13 +238,14 @@ Scroll through buffer @var{buffer}.  @xref{View Mode}.
 @kindex C-x C-q
 @vindex buffer-read-only
 @cindex read-only buffer
-  A buffer can be @dfn{read-only}, which means that commands to change
-its contents are not allowed.  The mode line indicates read-only
-buffers with @samp{%%} or @samp{%*} near the left margin.  @xref{Mode
-Line}.  Read-only buffers are usually made by subsystems such as Dired
-and Rmail that have special commands to operate on the text.  Visiting
-a file whose access control says you cannot write it also makes the
-buffer read-only.
+  A buffer can be @dfn{read-only}, which means that commands to insert
+or delete its text are not allowed.  (However, other commands, like
address@hidden @key{RET} f}, can still mark it as modified, @pxref{Text
+Coding}).  The mode line indicates read-only buffers with @samp{%%} or
address@hidden near the left margin.  @xref{Mode Line}.  Read-only buffers
+are usually made by subsystems such as Dired and Rmail that have
+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
 @vindex view-read-only
diff --git a/doc/emacs/display.texi b/doc/emacs/display.texi
index 3a0116a..ad32214 100644
--- a/doc/emacs/display.texi
+++ b/doc/emacs/display.texi
@@ -1258,7 +1258,7 @@ Highlight empty lines.
 @item big-indent
 @vindex whitespace-big-indent-regexp
 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
 @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.
 
 @item tab-mark
-Draw TAB characters with a special glyph.
+Draw tab characters with a special glyph.
 
 @item newline-mark
 Draw newline characters with a special glyph.