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

doc/emacs/ChangeLog

+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

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.