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

diff --git a/doc/emacs/ChangeLog b/doc/emacs/ChangeLog
index ce2a5e998e3206f646794416147452c1857e3c7b..0102e028d4950365cd9266cdba837e3baf8e7ad0 100644 (file)
--- 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 fb3521e4316114d64ef7efaa51cbf43fb2009a96..501c4152e6ada1d305ae79afb2b4a315febb946a 100644 (file)
--- 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.