@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,
+++
*** 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.