Fix documentation of a recent change in Dired

* etc/NEWS:
* doc/emacs/dired.texi (Dired Enter): Fix the text describing
'dired-maybe-use-globstar'.

* lisp/dired.el (dired-maybe-use-globstar): Add :version.

1 files changed, 14 insertions, 9 deletions

diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index 39caab086c2..19aaca962da 100644
--- a/doc/emacs/dired.texi
+++ b/doc/emacs/dired.texi
@@ -79,23 +79,28 @@ The former lists all the files with extension @samp{.el} in directory
 @samp{foo}.  The latter lists the files with extension @samp{.el}
 in all the subdirectories of @samp{foo}.
 
-When the system shell supports globstar and it's enabled, then you
-can use recursive globbing:
+@cindex globstar, in Dired
+On Posix systems, when the system shell supports @dfn{globstar}, a
+recursive globbing feature, and that support is enabled, you can use
+recursive globbing in Dired:
 
 @example
 C-x d  ~/foo/**/*.el  @key{RET}
 @end example
 
-This command lists all the files with extension @samp{.el} descending
-recursively in all the subdirectories of @samp{foo}.  Note that there
-are small differences in the implementation of globstar between shells.
-Check your shell manual to know the expected behavior.
+This command produces a directory listing with all the files with
+extension @samp{.el}, descending recursively in all the subdirectories
+of @samp{foo}.  Note that there are small differences in the
+implementation of globstar between different shells.  Check your shell
+manual to know the expected behavior.
 
 @vindex dired-maybe-use-globstar
 @vindex dired-enable-globstar-in-shell
-If the shell supports globstar and disables it by default, you
-can still enable this feature with @code{dired-maybe-use-globstar} if
-the shell is included in @code{dired-enable-globstar-in-shell}.
+If the shell supports globstar, but that support is disabled by
+default, you can still let Dired use this feature by customizing
+@code{dired-maybe-use-globstar} to a non-@code{nil} value; then Dired
+will enable globstar for those shells for which it knows how (see
+@code{dired-enable-globstar-in-shell} for the list of those shells).
 
 The usual history and completion commands can be used in the minibuffer;
 in particular, @kbd{M-n} puts the name of the visited file (if any) in