Re: dired-ls-sorting-switches

[era]

On Sun, 19 Oct 2003 16:40:31 +0200, Andreas Schwab <schwab@suse.de>
posted to gmane.emacs.bugs:
 > era@iki.fi writes:
 >> (defvar dired-ls-sorting-switches "SXU"
 >> -  "String of `ls' switches (single letters) except `t' that influence 
 >> sorting.")
 >> +  "String of switches \(single letters\) except `t' which when present
 > The first line of a doc string should be a complete sentence, *note
 > (elisp)Documentation Tips::.

Okay, how's this then?

/* era */

? diff
Index: dired.el
===================================================================
RCS file: /cvsroot/emacs/emacs/lisp/dired.el,v
retrieving revision 1.269
diff -u -r1.269 dired.el
--- emacs/emacs/lisp/dired.el   30 Sep 2003 20:46:04 -0000      1.269
+++ emacs/emacs/lisp/dired.el   19 Oct 2003 16:01:56 -0000
@@ -2770,7 +2770,13 @@
 ;; So anything that does not contain these is sort "by name".
 
 (defvar dired-ls-sorting-switches "SXU"
-  "String of `ls' switches (single letters) except `t' that influence 
sorting.")
+  "String of `ls'switches \(single letters\) except `t' that influence sorting.
+This indicates to Dired which option switches to watch out for because they
+will change the sorting order behavior of `ls'.
+
+To change the default sorting order \(e.g. add a `-v' option\), see the
+variable `dired-listing-switches'. To temporarily override the listing
+format, use Dired with a prefix argument.")
 
 (defvar dired-sort-by-date-regexp
   (concat "^-[^" dired-ls-sorting-switches

-- 
The email address era     the contact information   Just for kicks, imagine
at iki dot fi is heavily  link on my home page at   what it's like to get
spam filtered.  If you    <http://www.iki.fi/era/>  500 pieces of spam for
want to reach me, see     instead.                  each wanted message.