From: Eli Zaretskii <eliz@gnu.org>
Date: Wed, 30 Sep 2020 16:38:55 +0000 (+0300)
Subject: Minor documentation copyedits
X-Git-Tag: emacs-28.0.90~5806
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=19042966f2ddab190936154ca67c41db1c36a9f6;p=emacs.git

Minor documentation copyedits

* etc/NEWS:
* doc/emacs/dired.texi (Dired Enter): Fix wording, punctuation,
and typos in doc of 'dired-switches-in-mode-line'.
---

diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index 22fec134baf..fdc4703e86f 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 975207c8771..b4f29ab783b 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.