master 1904296: Minor documentation copyedits

[Eli Zaretskii]

branch: master
commit 19042966f2ddab190936154ca67c41db1c36a9f6
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>

    Minor documentation copyedits
    
    * etc/NEWS:
    * doc/emacs/dired.texi (Dired Enter): Fix wording, punctuation,
    and typos in doc of 'dired-switches-in-mode-line'.
---
 doc/emacs/dired.texi | 18 +++++++++---------
 etc/NEWS             |  7 ++++---
 2 files changed, 13 insertions(+), 12 deletions(-)

diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index 22fec13..fdc4703 100644
--- a/doc/emacs/dired.texi
+++ b/doc/emacs/dired.texi
@@ -130,15 +130,15 @@ options (starting with @samp{--}) whose arguments are 
specified with
 @samp{=}.
 
 @vindex dired-switches-in-mode-line
-  Dired will display an indication of what the @command{ls} switches
-are in the mode line.  By default, Dired will try to determine whether
-the switches indicate sorting by name or date, and say so in the mode
-line.  If the @code{dired-switches-in-mode-line} variable is
-@code{as-is}, the switches will be shown verbatim.  If this variable
-in an integer, the switch display will be truncated to that length.
-This variable can also be a function, which will be passed
-@code{dired-actual-switches} as the only parameter and should return a
-string.
+  Dired displays in the mode line an indication of what were the
+switches used to invoke @command{ls}.  By default, Dired will try to
+determine whether the switches indicate sorting by name or date, and
+will say so in the mode line.  If the @code{dired-switches-in-mode-line}
+variable is @code{as-is}, the switches will be shown verbatim.  If
+this variable's value is an integer, the switch display will be
+truncated to that length.  This variable can also be a function, which
+will be called with @code{dired-actual-switches} as the only
+parameter, and should return a string to display in the mode line.
 
 @vindex dired-use-ls-dired
   If your @command{ls} program supports the @samp{--dired} option,
diff --git a/etc/NEWS b/etc/NEWS
index 975207c..b4f29ab 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -320,9 +320,10 @@ time zones will use a form like "+0100" instead of "CET".
 
 +++
 *** New user option 'dired-switches-in-mode-line'.
-This variable controls how "ls" switches is displayed, and allows
-truncating or showing them as they are, in addition to "by name" and
-"by date".
+This variable controls how 'ls' switches are displayed in the mode
+line, and allows truncating them (to preserve space on the mode line)
+or showing them literally, either instead of, or in addition to,
+displaying "by name" or "by date" sort order.
 
 ---
 *** Broken and circular links are shown with the 'dired-broken-symlink' face.