Fix markup in dired-x.texi

* doc/misc/dired-x.texi (Omitting Variables)
(Local Variables, Shell Command Guessing)
(Advanced Cleaning Variables, Special Marking Function): Fix
markup and indexing.  (Bug#14212)

doc/misc/dired-x.texi

@@ -127,7 +127,7 @@ original @file{dired-x.el}).
 
 @node Features
 @section Features
-@cindex Features
+@cindex Dired-x features
 
 Some features provided by Dired Extra:
 
@@ -159,7 +159,7 @@ respectively (@pxref{Find File At Point}).
 
 @node Technical Details
 @section Technical Details
-@cindex Modified functions
+@cindex modified functions
 @cindex @file{dired-aux.el}
 
 When @file{dired-x.el} is loaded, some standard Dired functions from
@@ -214,7 +214,7 @@ when you first type @kbd{C-x d}).
 @node Optional Installation Dired Jump
 @section Optional Installation Dired Jump
 
-@cindex Autoloading @code{dired-jump} and @code{dired-jump-other-window}
+@cindex autoloading @code{dired-jump} and @code{dired-jump-other-window}
 
 In order to have @code{dired-jump} and @code{dired-jump-other-window}
 (@pxref{Miscellaneous Commands}) work @emph{before} @code{dired} and
@@ -235,7 +235,7 @@ for these functions.  In your @file{.emacs} file put
 @node Optional Installation File At Point
 @section Optional Installation File At Point
 
-@cindex Binding @code{dired-x-find-file}
+@cindex binding @code{dired-x-find-file}
 If you choose to have @file{dired-x.el} bind @code{dired-x-find-file} over
 @code{find-file} (@pxref{Find File At Point}), then you will need to set
 @code{dired-x-hands-off-my-keys}.  To do this, either set it
@@ -254,8 +254,8 @@ or call @code{dired-x-bind-find-file} after changing the value.
 @node Omitting Files in Dired
 @chapter Omitting Files in Dired
 
-@cindex Omitting Files in Dired
+@cindex omitting Files in Dired
-@cindex Uninteresting files
+@cindex uninteresting files
 @dfn{Omitting} a file means removing it from the directory listing.  Omitting
 is useful for keeping Dired buffers free of ``uninteresting'' files (for
 instance, auto-save, auxiliary, backup, and revision control files) so that
@@ -310,18 +310,13 @@ inside @code{dired-load-hook} (@pxref{Installation}) and then evaluate
 @node Omitting Variables
 @section Omitting Variables
 
-@cindex Customizing file omitting
+@cindex customizing file omitting
 The following variables can be used to customize omitting.
 
-@table @code
+@cindex how to make omitting the default in Dired
-
+@defvar dired-omit-mode
-@vindex dired-omit-mode
-@item dired-omit-mode
-
-Default: @code{nil}
-
-@cindex How to make omitting the default in Dired
 If non-@code{nil}, ``uninteresting'' files are not listed.
+The default is @code{nil}.
 Uninteresting files are files whose names match regexp
 @code{dired-omit-files}, plus files whose names end with extension in
 @code{dired-omit-extensions}.  @kbd{C-x M-o} (@code{dired-omit-mode})
@@ -347,56 +342,49 @@ a directory local setting
 @noindent
 to a @file{.dir-locals.el} file in that directory.  You can use the
 command @code{add-dir-local-variable} to do this.
+@end defvar
 
-@vindex dired-omit-files
+@defvar dired-omit-files
-@item dired-omit-files
+This buffer-local variable's value is a regexp, a string.  Files whose
-
+names match this regexp will not be displayed.  This only has effect
-Default: @code{"^#\\|\\.$"}
+when @code{dired-omit-mode}'s value is @code{t}.
-
-Files whose names match this buffer-local regexp will not be displayed.
-This only has effect when @code{dired-omit-mode}'s value is @code{t}.
 
 The default value omits the special directories @file{.} and @file{..}  and
 autosave files (plus other files ending in @file{.}) (@pxref{Omitting Examples}).
+@end defvar
 
-@vindex dired-omit-extensions
+@defvar dired-omit-extensions
-@item dired-omit-extensions
+If non-@code{nil}, this variable's value is a list of extensions
-
+(strings) to omit from Dired listings.  Its format is the same as that
-Default: The elements of @code{completion-ignored-extensions},
+of @code{completion-ignored-extensions}.  The default value is the
-@code{dired-latex-unclean-extensions}, @code{dired-bibtex-unclean-extensions}
+elements of @code{completion-ignored-extensions},
-and @code{dired-texinfo-unclean-extensions}.
+@code{dired-latex-unclean-extensions},
-
+@code{dired-bibtex-unclean-extensions} and
-If non-@code{nil}, a list of extensions (strings) to omit from Dired listings.
+@code{dired-texinfo-unclean-extensions}.
-Its format is the same as that of @code{completion-ignored-extensions}.
+@end defvar
-
-@vindex dired-omit-case-fold
-@item dired-omit-case-fold
 
+@defvar dired-omit-case-fold
 Default:  @code{filesystem}
-
+This variable controls whether file-name matching is case-insensitive.
 By default, when @code{dired-omit-case-fold} is set to @code{filesystem},
 @code{dired-omit-mode} will match filenames and extensions
 case-sensitively on Dired buffers visiting case-sensitive filesystems,
 and case-insensitively on case-insensitive filesystems.  Set it to
 @code{nil} to be always case-sensitive, and to @code{t} to be always
 case-insensitive.
+@end defvar
 
-@vindex dired-omit-localp
+@defvar dired-omit-localp
-@item dired-omit-localp
+This variable determines the @var{localp} argument
-
+@code{dired-omit-expunge} passes to @code{dired-get-filename}.  If it
-Default:  @code{no-dir}
+is @code{no-dir}, teh default, omitting is much faster, but you can
-
+only match against the non-directory part of the file name.  Set it to
-The @var{localp} argument @code{dired-omit-expunge} passes to
+@code{nil} if you need to match the whole file name or @code{t} to
-@code{dired-get-filename}.  If it is @code{no-dir}, omitting is much faster,
+match the file name relative to the buffer's top-level directory.
-but you can only match against the non-directory part of the file name.  Set it
+@end defvar
-to @code{nil} if you need to match the whole file name or @code{t} to match the
-file name relative to the buffer's top-level directory.
-
-@item dired-omit-marker-char
-@vindex dired-omit-marker-char
-@cindex Omitting additional files
-Default: @kbd{C-o}
 
+@cindex omitting additional files
+@defvar dired-omit-marker-char
 Temporary marker used by Dired to implement omitting.  Should never be used
 as marker by the user or other packages.  There is one exception to this rule:
 by adding
@@ -412,8 +400,8 @@ to your @file{~/.emacs}, you can bind the @kbd{C-o} key to insert a
 @kbd{C-o} marker, thus causing these files to be omitted in addition to the
 usually omitted files.  Unfortunately the files you omitted manually this way
 will show up again after reverting the buffer, unlike the others.
-
+The default value is @kbd{C-o}.
-@end table
+@end defvar
 
 @node Omitting Examples
 @section Examples of Omitting Various File Types
@@ -422,7 +410,7 @@ will show up again after reverting the buffer, unlike the others.
 
 @item
 @cindex RCS files, how to omit them in Dired
-@cindex Omitting RCS files in Dired
+@cindex omitting RCS files in Dired
 If you wish to avoid seeing RCS files and the @file{RCS} directory, then put
 
 @example
@@ -438,8 +426,8 @@ in the @code{dired-load-hook} (@pxref{Installation}).  This assumes
 @code{^} in the regexp.
 
 @item
-@cindex Tib files, how to omit them in Dired
+@cindex tib files, how to omit them in Dired
-@cindex Omitting tib files in Dired
+@cindex omitting tib files in Dired
 If you use @code{tib}, the bibliography program for use with @TeX{} and
 @LaTeX{}, and you
 want to omit the @file{INDEX} and the @file{*-t.tex} files, then put
@@ -453,8 +441,8 @@ want to omit the @file{INDEX} and the @file{*-t.tex} files, then put
 in the @code{dired-load-hook} (@pxref{Installation}).
 
 @item
-@cindex Dot files, how to omit them in Dired
+@cindex dot files, how to omit them in Dired
-@cindex Omitting dot files in Dired
+@cindex omitting dot files in Dired
 If you do not wish to see @samp{dot} files (files starting with a @file{.}),
 then put
 
@@ -480,8 +468,8 @@ in your @code{dired-mode-hook}.
 
 @node Local Variables
 @chapter Local Variables for Dired Directories
+@cindex local Variables for Dired Directories
 
-@cindex Local Variables for Dired Directories
 @vindex dired-local-variables-file
 @vindex dired-enable-local-variables
 @noindent
@@ -530,28 +518,24 @@ Files,emacs,The GNU Emacs Manual}.
 @noindent
 The following variables affect Dired Local Variables
 
-@table @code
+@defvar dired-local-variables-file
-@vindex dired-local-variables-file
+If non-@code{nil}, this variable specifies the file name for local
-@item dired-local-variables-file
+variables for Dired.  If Dired finds a file with that name in the
-Default: @code{".dired"}
+current directory, it will temporarily insert it into the Dired buffer
+and run @code{hack-local-variables}.  The default is @file{.dired}.
+@end defvar
 
-If non-@code{nil}, file name for local variables for Dired.  If Dired finds a
+@defvar dired-enable-local-variables
-file with that name in the current directory, it will temporarily insert it
+This variable controls the use of local-variables lists in Dired.  It
-into the Dired buffer and run @code{hack-local-variables}.
-
-@vindex dired-enable-local-variables
-@item dired-enable-local-variables
-Default: @code{t}
-
-Controls the use of local-variables lists in Dired.  This variable
 temporarily overrides the value of @code{enable-local-variables} when
-the Dired Local Variables are hacked.  It takes the same values as that
+the Dired Local Variables are hacked.  It takes the same values as
-variable.  A value of @code{nil} means to ignore any Dired Local Variables.
+that variable.  A value of @code{nil} means to ignore any Dired Local
-@end table
+Variables.  The default is @code{t}.
+@end defvar
 
 @node Shell Command Guessing
 @chapter Shell Command Guessing
-@cindex Guessing shell commands for files.
+@cindex guessing shell commands for files.
 
 Based upon the name of a file, Dired tries to guess what shell
 command you might want to apply to it.  For example, if you have point
@@ -568,19 +552,22 @@ file, e.g., @samp{xtex} and @samp{dvips} for a @file{.dvi} file, you can type
 Dired only tries to guess a command for a single file, never for a list
 of marked files.
 
-@table @code
+The following variables control guessing of shell commands:
-@item dired-guess-shell-alist-default
-@vindex dired-guess-shell-alist-default
-Predefined rules for shell commands.  Set this to @code{nil} to turn guessing off.
-The elements of @code{dired-guess-shell-alist-user} (defined by the
-user) will override these rules.
 
-@item dired-guess-shell-alist-user
+@defvar dired-guess-shell-alist-default
-@vindex dired-guess-shell-alist-user
+This variable specifies the predefined rules for guessing shell
-If non-@code{nil}, a user-defined alist of file regexps and their suggested
+commands suitable for certain files.  Set this to @code{nil} to turn
-commands.  These rules take precedence over the predefined rules in the
+guessing off.  The elements of @code{dired-guess-shell-alist-user}
-variable @code{dired-guess-shell-alist-default} (to which they are prepended)
+(defined by the user) will override these rules.
-when @code{dired-do-shell-command} is run).
+@end defvar
+
+@defvar dired-guess-shell-alist-user
+If non-@code{nil}, this variables specifies the user-defined alist of
+file regexps and their suggested commands.  These rules take
+precedence over the predefined rules in the variable
+@code{dired-guess-shell-alist-default} (to which they are prepended)
+when @code{dired-do-shell-command} is run).  The default is
+@code{nil}.
 
 Each element of the alist looks like
 
@@ -613,54 +600,50 @@ to add rules for @samp{.foo} and @samp{.bar} file extensions, write
 
 @noindent
 This will override any predefined rules for the same extensions.
+@end defvar
 
-@item dired-guess-shell-case-fold-search
+@defvar dired-guess-shell-case-fold-search
-@vindex dired-guess-shell-case-fold-search
+If this variable is non-@code{nil},
-Default: @code{t}
+@code{dired-guess-shell-alist-default} and
-
-Non-@code{nil} means @code{dired-guess-shell-alist-default} and
 @code{dired-guess-shell-alist-user} are matched case-insensitively.
+The default is @code{t}.
+@end defvar
 
-@item dired-guess-shell-gnutar
+@cindex passing GNU Tar its @samp{z} switch.
-@vindex dired-guess-shell-gnutar
+@defvar dired-guess-shell-gnutar
-@cindex Passing GNU Tar its @samp{z} switch.
+If this variable is non-@code{nil}, it specifies the name of the GNU
-Default: @code{nil}
+Tar executable (e.g., @file{tar} or @file{gnutar}).  GNU Tar's
+@samp{z} switch is used for compressed archives.  If you don't have
+GNU Tar, set this to @code{nil}: a pipe using @command{zcat} is then
+used instead.  The default is @code{nil}.
+@end defvar
 
-If non-@code{nil}, this is the name of the GNU Tar executable (e.g.,
-@samp{tar} or @samp{gnutar}).  GNU Tar's @samp{z} switch is used for
-compressed tar files.
-If you don't have GNU tar, set this to @code{nil}: a pipe using @samp{zcat} is
-then used.
-
-@item dired-guess-shell-gzip-quiet
-@vindex dired-guess-shell-gzip-quiet
 @cindex @code{gzip}
-Default: @code{t}
+@defvar dired-guess-shell-gzip-quiet
+A non-@code{nil} value of this variable means that @samp{-q} is passed
+to @command{gzip}, possibly overriding a verbose option in the @env{GZIP}
+environment variable.  The default is @code{t}.
+@end defvar
 
-A non-@code{nil} value means that @samp{-q} is passed to @code{gzip}
-overriding a verbose option in the @env{GZIP} environment variable.
-
-@item dired-guess-shell-znew-switches nil
-@vindex dired-guess-shell-znew-switches
 @cindex @code{znew}
-Default: @code{nil}
+@defvar dired-guess-shell-znew-switches nil
+This variable specifies a string of switches passed to @command{znew}.
+An example is @samp{-K} which will make @command{znew} keep a @file{.Z}
+file when it is smaller than the @file{.gz} file.  The default is
+@code{nil}: no additional switches are passed to @command{znew}.
+@end defvar
 
-A string of switches passed to @code{znew}.  An example is
+@defvar dired-shell-command-history nil
-@samp{-K} which will make @code{znew} keep a @file{.Z} file when it is
+This variable holds the history list for commands that read
-smaller than the @file{.gz} file.
+dired-shell commands.
-
+@end defvar
-@item dired-shell-command-history nil
-@vindex dired-shell-command-history
-
-History list for commands that read dired-shell commands.
-@end table
 
 @node Virtual Dired
 @chapter Virtual Dired
 
-@cindex Virtual Dired
+@cindex virtual Dired
-@cindex Perusing @code{ls} listings
+@cindex perusing @code{ls} listings
-@cindex @code{ls} listings, how to peruse them in Dired
+@cindex @command{ls} listings, how to peruse them in Dired
 Using @dfn{Virtual Dired} means putting a buffer with Dired-like
 contents in Dired mode.  The files described by the buffer contents need
 not actually exist.  This is useful if you want to peruse an @samp{ls -lR}
@@ -702,8 +685,8 @@ local-variable files.
 @table @kbd
 @item F
 @kindex F
-@cindex Visiting several files at once
+@cindex visiting several files at once
-@cindex Simultaneous visiting of several files
+@cindex simultaneous visiting of several files
 @findex dired-do-find-marked-files
 (@code{dired-do-find-marked-files}) Find all marked files at once displaying
 them simultaneously.  If optional @var{noselect} is non-@code{nil} then just
@@ -791,41 +774,36 @@ and @file{*.dvi} files for deletion.
 @node Advanced Cleaning Variables
 @section Advanced Cleaning Variables
 
-@noindent Variables used by the above cleaning commands (and in the default value for
+Variables used by the above cleaning commands (and in the default value for
-variable @code{dired-omit-extensions}, @pxref{Omitting Variables})
+variable @code{dired-omit-extensions}, @pxref{Omitting Variables}):
 
-@table @code
+@defvar dired-patch-unclean-extensions
-@item dired-patch-unclean-extensions
+This variable specifies the list of extensions of dispensable files
-@vindex dired-patch-unclean-extensions
+created by the @samp{patch} program.  The default is @w{@code{(".rej"
-Default: @code{(".rej" ".orig")}
+".orig")}}.
+@end defvar
 
-List of extensions of dispensable files created by the @samp{patch} program.
+@defvar dired-tex-unclean-extensions
+This variable specifies the list of extensions of dispensable files
+created by @TeX{}.  The default is @w{@code{(".toc" ".log" ".aux")}}.
+@end defvar
 
-@item dired-tex-unclean-extensions
+@defvar dired-texinfo-unclean-extensions
-@vindex dired-tex-unclean-extensions
+This variable holds the list of extensions of dispensable files
-Default:  @code{(".toc" ".log" ".aux")}
+created by @samp{texinfo}.  The default is @w{@code{(".cp" ".cps" ".fn"
+".fns" ".ky" ".kys"} @code{".pg" ".pgs" ".tp" ".tps" ".vr" ".vrs")}}
+@end defvar
 
-List of extensions of dispensable files created by @TeX{}.
+@defvar dired-latex-unclean-extensions
+This variable specifies the list of extensions of dispensable files
+created by @LaTeX{}.  The default is @w{@code{(".idx" ".lof" ".lot"
+".glo")}}.
+@end defvar
 
-@item dired-texinfo-unclean-extensions
+@defvar dired-bibtex-unclean-extensions
-@vindex dired-texinfo-unclean-extensions
+This variable specifies the list of extensions of dispensable files
-Default: @code{(".cp" ".cps" ".fn" ".fns" ".ky" ".kys"}
+created by Bib@TeX{}.  The default is @w{@code{(".blg" ".bbl")}}.
-@code{".pg" ".pgs" ".tp" ".tps" ".vr" ".vrs")}
+@end defvar
-
-List of extensions of dispensable files created by @samp{texinfo}.
-
-@item dired-latex-unclean-extensions
-@vindex dired-latex-unclean-extensions
-Default: @code{(".idx" ".lof" ".lot" ".glo")}
-
-List of extensions of dispensable files created by @LaTeX{}.
-
-@item dired-bibtex-unclean-extensions
-@vindex dired-bibtex-unclean-extensions
-Default:  @code{(".blg" ".bbl")}
-
-List of extensions of dispensable files created by Bib@TeX{}.
-@end table
 
 @node Special Marking Function
 @section Special Marking Function
@@ -834,10 +812,11 @@ List of extensions of dispensable files created by Bib@TeX{}.
 @item M-(
 @kindex M-(
 @findex dired-mark-sexp
-@cindex Lisp expression, marking files with in Dired
+@cindex lisp expression, marking files with in Dired
-@cindex Mark file by Lisp expression
+@cindex mark file by Lisp expression
-(@code{dired-mark-sexp}) Mark files for which @var{predicate} returns
+Mark files for which @var{predicate} returns non-@code{nil}
-non-@code{nil}.  With a prefix argument, unflag those files instead.
+(@code{dired-mark-sexp}).  With a prefix argument, unflag those files
+instead.
 
 The @var{predicate} is a Lisp expression that can refer to the following
 symbols:
@@ -886,8 +865,8 @@ to mark all @file{.el} files without a corresponding @file{.elc} file.
 @node Multiple Dired Directories
 @chapter Multiple Dired Directories and Non-Dired Commands
 
-@cindex Multiple Dired directories
+@cindex multiple Dired directories
-@cindex Working directory
+@cindex working directory
 An Emacs buffer can have but one working directory, stored in the
 buffer-local variable @code{default-directory}.  A Dired buffer may have
 several subdirectories inserted, but it still has only one working
@@ -905,8 +884,8 @@ Dired buffers, is like @code{shell-command}, but it runs with
 
 @node Find File At Point
 @chapter Find File At Point
-@cindex Visiting a file mentioned in a buffer
+@cindex visiting a file mentioned in a buffer
-@cindex Finding a file at point
+@cindex finding a file at point
 
 @file{dired-x} provides a method of visiting or editing a file mentioned in
 the buffer you are viewing (e.g., a mail buffer, a news article, a
@@ -1014,7 +993,7 @@ inserted subdirectories.
 @item dired-jump
 @findex dired-jump
 @kindex C-x C-j
-@cindex Jumping to Dired listing containing file.
+@cindex jumping to Dired listing containing file.
 Bound to @kbd{C-x C-j}.  Jump back to Dired: If in a file, edit the current
 directory and move to file's line.  If in Dired already, pop up a level and
 go to old directory's line.  In case the proper Dired file line cannot be
@@ -1034,7 +1013,7 @@ bound to @kbd{C-x C-j} and @code{dired-jump-other-window} will not be bound to
 @kbd{C-x 4 C-j}.
 
 @item dired-vm
-@cindex Reading mail.
+@cindex reading mail.
 @kindex V
 @findex dired-vm
 Bound to @kbd{V} if @code{dired-bind-vm} is @code{t}.  Run VM on this
@@ -1054,14 +1033,14 @@ If the variable @code{dired-bind-vm} is @code{t}, @code{dired-vm} will be bound
 to @kbd{V}.  Otherwise, @code{dired-bind-rmail} will be bound.
 
 @item dired-rmail
-@cindex Reading mail.
+@cindex reading mail.
 @findex dired-rmail
 Bound to @kbd{V} if @code{dired-bind-vm} is @code{nil}.  Run Rmail on this
 file (assumed to be mail folder in Rmail format).
 
 @item dired-info
 @kindex I
-@cindex Running info.
+@cindex running info.
 @findex dired-info
 Bound to @kbd{I}.  Run Info on this file (assumed to be a file in Info
 format).
@@ -1071,7 +1050,7 @@ If the variable @code{dired-bind-info} is @code{nil}, @code{dired-info} will
 not be bound to @kbd{I}.
 
 @item dired-man
-@cindex Running man.
+@cindex running man.
 @kindex N
 @findex dired-man
 Bound to @kbd{N}.  Run man on this file (assumed to be a file in @code{nroff}
@@ -1082,7 +1061,7 @@ If the variable @code{dired-bind-man} is @code{nil}, @code{dired-man} will not
 be bound to @kbd{N}.
 
 @item dired-do-relsymlink
-@cindex Relative symbolic links.
+@cindex relative symbolic links.
 @kindex Y
 @findex dired-do-relsymlink
 Bound to @kbd{Y}.  Relative symlink all marked (or next ARG) files into a
@@ -1111,7 +1090,7 @@ info.
 
 @node Bugs
 @chapter Bugs
-@cindex Bugs
+@cindex bugs
 
 @noindent
 If you encounter a bug in this package, or wish to suggest an