From: Glenn Morris <rgm@gnu.org>
Date: Wed, 13 Jul 2011 17:55:04 +0000 (-0400)
Subject: * doc/emacs/dired.texi (Dired Enter): Mention --dired.  (Bug#9039)
X-Git-Tag: emacs-pretest-24.0.90~104^2~311
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=90a6258b05e00c6e47acc4e85edabf6e92ea1e84;p=emacs.git

* doc/emacs/dired.texi (Dired Enter): Mention --dired.  (Bug#9039)
---

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index ce2a5e998e3..0102e028d49 100644
--- a/doc/emacs/ChangeLog
+++ b/doc/emacs/ChangeLog
@@ -1,3 +1,7 @@
+2011-07-13  Glenn Morris  <rgm@gnu.org>
+
+	* dired.texi (Dired Enter): Mention --dired.  (Bug#9039)
+
 2011-07-13  Lars Magne Ingebrigtsen  <larsi@gnus.org>
 
 	* mark.texi (Mark Ring): Clarify how many locations are saved
diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index fb3521e4316..501c4152e6a 100644
--- a/doc/emacs/dired.texi
+++ b/doc/emacs/dired.texi
@@ -81,6 +81,13 @@ specified, the @code{ls} switches can include short options (that is,
 single characters) requiring no arguments, and long options (starting
 with @samp{--}) whose arguments are specified with @samp{=}.
 
+@vindex dired-use-ls-dired
+  Note that Dired automatically adds the option @samp{--dired}, if
+your @code{ls} program supports it, unless you explicitly set
+the variable @code{dired-use-ls-dired} to @code{nil}.  Without this
+option, Dired will have trouble parsing some @samp{unusual} file-names.
+See the documentation of @code{dired-use-ls-dired} for more details.
+
   On MS-Windows and MS-DOS systems, Emacs @emph{emulates} @code{ls};
 see @ref{ls in Lisp}, for options and peculiarities of that emulation.