; Minor fixes in documentation

* doc/emacs/xresources.texi (Table of Resources):
* doc/emacs/cmdargs.texi (Misc X):
* etc/NEWS: Fix recent changes in documentation.

3 files changed, 19 insertions, 18 deletions

diff --git a/doc/emacs/cmdargs.texi b/doc/emacs/cmdargs.texi
index fa28c3eabcb..b3d9af0baf9 100644
--- a/doc/emacs/cmdargs.texi
+++ b/doc/emacs/cmdargs.texi
@@ -1238,7 +1238,7 @@ Disable the blinking cursor on graphical displays.
 @itemx --basic-display
 @opindex --basic-display
 Disable the menu-bar, the tool-bar, the scroll-bars, tool tips, and
-font-lock-mode, and turn off the blinking cursor.  This can be useful
+turn off font-lock-mode and the blinking cursor.  This can be useful
 for making a test case that simplifies debugging of display problems.
 @end table
 
diff --git a/doc/emacs/xresources.texi b/doc/emacs/xresources.texi
index e349d40333f..3b9448f8a8f 100644
--- a/doc/emacs/xresources.texi
+++ b/doc/emacs/xresources.texi
@@ -223,12 +223,12 @@ Width of the internal frame border, in pixels.
 @end ifnottex
 
 @item @code{lineSpacing} (class @code{LineSpacing})
-@cindex line spacing
+@cindex line spacing (X resource)
 Additional space between lines, in pixels.
 
 @ifnottex
 @item @code{menuBackground} (class @code{Background})
-@cindex background for menus
+@cindex background for menus (X resource)
 The background color of the menus in non-toolkit versions of Emacs.
 (For toolkit versions, see @ref{Lucid Resources}, also see @ref{Motif
 Resources}, and see @ref{GTK resources}.)
@@ -245,13 +245,13 @@ If @samp{none}, Emacs will not make a minibuffer in this frame; it
 will use a separate minibuffer frame instead.
 
 @item @code{paneFont} (class @code{Font})
-@cindex font for menus
+@cindex font for menus (X resource)
 Font name for menu pane titles, in non-toolkit versions of Emacs.
 (For toolkit versions, see @ref{Lucid Resources}, also see @ref{Motif
 Resources}, and see @ref{GTK resources}.)
 
 @item @code{paneForeground} (class @code{Foreground})
-@cindex foreground for menus
+@cindex foreground for menus (X resource)
 Foreground color for menu pane titles, in non-toolkit versions of
 Emacs.  (For toolkit versions, see @ref{Lucid Resources}, also see
 @ref{Motif Resources}, and see @ref{GTK resources}.)
@@ -272,17 +272,17 @@ Switch foreground and background default colors if @samp{on}, use colors as
 specified if @samp{off}.
 
 @item @code{screenGamma} (class @code{ScreenGamma})
-@cindex gamma correction
+@cindex gamma correction (X resource)
 Gamma correction for colors, equivalent to the frame parameter
 @code{screen-gamma}.
 
 @item @code{scrollBar} (class @code{ScrollBar})
-@cindex scroll bar
+@cindex scroll bar (X resource)
 If the value of this resource is @samp{off} or @samp{false} or
 @samp{0}, Emacs disables Scroll Bar mode at startup (@pxref{Scroll Bars}).
 
 @item @code{scrollBarWidth} (class @code{ScrollBarWidth})
-@cindex scrollbar width
+@cindex scrollbar width (X resource)
 The scroll bar width in pixels, equivalent to the frame parameter
 @code{scroll-bar-width}.  Do not set this resource if Emacs is
 compiled with GTK+ support.
@@ -315,18 +315,18 @@ useful for debugging X problems.
 Name to display in the title bar of the initial Emacs frame.
 
 @item @code{toolBar} (class @code{ToolBar})
-@cindex tool bar
+@cindex tool bar (X resource)
 If the value of this resource is @samp{off} or @samp{false} or
 @samp{0}, Emacs disables Tool Bar mode at startup (@pxref{Tool Bars}).
 
 @item @code{tabBar} (class @code{TabBar})
-@cindex tab bar
+@cindex tab bar (X resource)
 If the value of this resource is @samp{on} or @samp{yes} or
 @samp{1}, Emacs enables Tab Bar mode at startup (@pxref{Tab Bars}).
 
 @item @code{useXIM} (class @code{UseXIM})
-@cindex XIM
-@cindex X input methods
+@cindex XIM (X resource)
+@cindex X input methods (X resource)
 @cindex input methods, X
 Disable use of X input methods (XIM) if @samp{false} or @samp{off}.
 This is only relevant if your Emacs is built with XIM support.  It
diff --git a/etc/NEWS b/etc/NEWS
index 63ab33bdd4a..34925c1af7c 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -454,7 +454,8 @@ Note that this key binding will not work on MS-Windows systems if
 * Editing Changes in Emacs 27.1
 
 +++
-** 'zap-to-char' uses the new 'read-char-with-history' function to allow
+** 'zap-to-char' now uses history of characters you used to zap to.
+'zap-to-char' uses the new 'read-char-with-history' function to allow
 navigating through the history of characters that have been input.
 This is mostly useful for characters that have complex input methods
 where inputting the character again may involve many keystrokes.
@@ -764,8 +765,8 @@ remapped to these, respectively.
 ** Dired
 
 ---
-*** On systems that support it, Dired now font-locks the permissions
-of suid/guid files specially with the 'dired-set-id' face.
+*** On systems that support suid/guid files, Dired now fontifies the
+permissions of such files with a special face 'dired-set-id'.
 
 +++
 *** New command 'dired-create-empty-file'.
@@ -2387,9 +2388,9 @@ scrolling.
 
 * Lisp Changes in Emacs 27.1
 
-** There is a new function 'read-char-with-history' that works like
-'read-char', but maintains a history that can be navigated via the
-'M-p'/'M-n' keystrokes.
+** New function 'read-char-with-history'.
+This function works like 'read-char', but maintains a history that can
+be navigated via the 'M-p'/'M-n' keystrokes.
 
 ** 'setq-local' can now set an arbitrary number of variables, which
 makes the syntax more like 'setq'.