[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Emacs-diffs] Changes to dired-x.texi
|
From: |
Glenn Morris |
|
Subject: |
[Emacs-diffs] Changes to dired-x.texi |
|
Date: |
Thu, 06 Sep 2007 04:59:08 +0000 |
CVSROOT: /sources/emacs
Module name: emacs
Changes by: Glenn Morris <gm> 07/09/06 04:59:08
Index: dired-x.texi
===================================================================
RCS file: dired-x.texi
diff -N dired-x.texi
--- /dev/null 1 Jan 1970 00:00:00 -0000
+++ dired-x.texi 6 Sep 2007 04:59:08 -0000 1.1
@@ -0,0 +1,1275 @@
+\input texinfo @comment -*-texinfo-*-
+
address@hidden dired-x.texi --- Sebastian Kremer's Extra DIRED hacked up for
GNU Emacs19
address@hidden
address@hidden Author: Sebastian Kremer <address@hidden>
address@hidden Lawrence R. Dodd <address@hidden>
address@hidden [Dodd's address no longer valid.]
address@hidden Version: 2.53
address@hidden Date: 2001/02/25 14:05:46
address@hidden Keywords: dired extensions
address@hidden dired-x.el REVISION NUMBER: 2
+
address@hidden State: Released
address@hidden Ident: dired-x.texi,v 2.53 2001/02/25 14:05:46 dodd Released
+
address@hidden %**start of header (This is for running Texinfo on a region.)
address@hidden FOR GNU EMACS USE ../info/dired-x BELOW
address@hidden ../info/dired-x
address@hidden dired-x.el REVISION NUMBER
address@hidden Dired Extra Version 2 User's Manual
address@hidden
address@hidden
address@hidden iftex
address@hidden @setchapternewpage odd % For book style double sided
manual.
address@hidden %**end of header (This is for running Texinfo on a region.)
+
address@hidden
+Copyright @copyright{} 1994, 1995, 1999, 2001, 2002, 2003, 2004,
+2005, 2006, 2007 Free Software Foundation, Inc.
+
address@hidden
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with the
+Invariant Sections being ``The GNU Manifesto'', ``Distribution'' and
+``GNU GENERAL PUBLIC LICENSE'', with the Front-Cover texts being ``A GNU
+Manual'', and with the Back-Cover Texts as in (a) below. A copy of the
+license is included in the section entitled ``GNU Free Documentation
+License'' in the Emacs manual.
+
+(a) The FSF's Back-Cover Text is: ``You have freedom to copy and modify
+this GNU Manual, like GNU software. Copies published by the Free
+Software Foundation raise funds for GNU development.''
+
+This document is part of a collection distributed under the GNU Free
+Documentation License. If you want to distribute this document
+separately from the collection, you can do so by adding a copy of the
+license to the document, as described in section 6 of the license.
address@hidden quotation
address@hidden copying
+
address@hidden Emacs
address@hidden
+* Dired-X: (dired-x). Dired Extra Features.
address@hidden direntry
+
address@hidden @smallbook
address@hidden
+\overfullrule=0pt
+%\global\baselineskip 30pt % For printing in double spaces
address@hidden tex
+
address@hidden
address@hidden 6
address@hidden dired-x.el REVISION NUMBER
address@hidden @titlefont{Dired Extra Version 2}
address@hidden 2
address@hidden @titlefont{For The GNU Emacs}
address@hidden 1
address@hidden @titlefont{Directory Editor}
address@hidden 4
address@hidden Lawrence address@hidden Dodd
address@hidden @center @t{dodd@@roebling.poly.edu}
address@hidden 5
address@hidden (Based on @file{dired.texi} by Sebastian Kremer
<sk@@thp.uni-koeln.de>)
address@hidden
address@hidden 0pt plus 1filll
address@hidden
address@hidden titlepage
+
address@hidden
+
address@hidden
+
address@hidden Top
address@hidden node-name, next, previous, up
+
address@hidden
+This documents the ``extra'' features for Dired Mode for GNU Emacs that are
+provided by the file @file{dired-x.el}.
+
address@hidden @bullet
+
address@hidden
+Based on @file{dired.texi} by Sebastian Kremer <sk@@thp.uni-koeln.de>
+
address@hidden dired-x.el REVISION NUMBER
address@hidden
+For @file{dired-x.el} revision 2
+
address@hidden @item
address@hidden Revision of this manual: 2.53 (2001/02/25 14:05:46)
+
address@hidden @item
address@hidden Bugs to Lawrence R. Dodd <dodd@@roebling.poly.edu>.
@emph{Please} type
address@hidden @kbd{M-x dired-x-submit-report} to submit a bug report
(@pxref{Bugs}).
+
address@hidden @item
address@hidden You can obtain a copy of this package via anonymous ftp in
address@hidden @t{/roebling.poly.edu:/pub/packages/dired-x.tar.gz}
+
address@hidden itemize
+
address@hidden
+* Introduction::
+* Installation::
+* Omitting Files in Dired::
+* Local Variables::
+* Shell Command Guessing::
+* Virtual Dired::
+* Advanced Mark Commands::
+* Multiple Dired Directories::
+* Find File At Point::
+* Miscellaneous Commands::
+* Bugs::
+
+* GNU Free Documentation License::
+* Concept Index::
+* Command Index::
+* Key Index::
+* Variable Index::
+
address@hidden menu
+
address@hidden ifnottex
+
address@hidden Introduction, Installation, Top, Top
address@hidden node-name, next, previous, up
address@hidden Introduction
+
+This documents the @emph{extra} features for Dired Mode for GNU Emacs. It
+is derived from version 1.191 of Sebastian Kremer's @file{dired-x.el}.
+
+In adopting this @file{dired-x.el} to GNU Emacs v19 some material that has
+been incorporated into @file{dired.el} and @file{dired-aux.el} of the GNU Emacs
+19 distribution has been removed and some material was modified for agreement
+with the functions in @file{dired.el} and @file{dired-aux.el}. For example,
+the code using @code{gmhist} history functions was replaced with code using
+the mini-buffer history now built into GNU Emacs. Finally, a few other
+features have been added and a few more functions have been bound to keys.
+
address@hidden
address@hidden
+* Features::
+* Technical Details::
address@hidden menu
address@hidden ifnottex
+
address@hidden Features, Technical Details, , Introduction
address@hidden node-name, next, previous, up
address@hidden Features
address@hidden Features
+
+Some features provided by Dired Extra
+
address@hidden
address@hidden
+Omitting uninteresting files from Dired listing.
address@hidden @bullet
address@hidden Files in Dired}.
address@hidden itemize
address@hidden
+Local variables for Dired directories.
address@hidden @bullet
address@hidden Variables}.
address@hidden itemize
address@hidden
+Guessing shell commands in Dired buffers.
address@hidden @bullet
address@hidden Command Guessing}.
address@hidden itemize
address@hidden
+Running Dired command in non-Dired buffers.
address@hidden @bullet
address@hidden Dired}.
address@hidden itemize
address@hidden
+Finding a file mentioned in a buffer
address@hidden @bullet
address@hidden File At Point}.
address@hidden itemize
address@hidden
+Commands using file marking.
address@hidden @bullet
address@hidden Mark Commands}.
address@hidden itemize
address@hidden enumerate
+
address@hidden
address@hidden binds some functions to keys in Dired Mode (@pxref{Key
+Index}) and also binds @kbd{C-x C-j} and @kbd{C-x 4 C-j} @emph{globally} to
address@hidden (@pxref{Miscellaneous Commands}). It may also bind @kbd{C-x
+C-f} and @kbd{C-x 4 C-f} to @code{dired-x-find-file} and
address@hidden, respectively (@pxref{Find File At
+Point}).
+
address@hidden Technical Details, , Features, Introduction
address@hidden node-name, next, previous, up
address@hidden Technical Details
address@hidden Redefined functions
address@hidden @file{dired-aux.el}
+
+When loaded this code @emph{redefines} the following functions of GNU Emacs
+from @file{dired.el}
+
address@hidden @bullet
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden itemize
+
address@hidden
+and the following functions from @file{dired-aux.el}
+
address@hidden @bullet
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden itemize
+
address@hidden Installation, Omitting Files in Dired, Introduction, Top
address@hidden node-name, next, previous, up
address@hidden Installation
+
address@hidden
+This manual describes the Dired features provided by the file
address@hidden To take advantage of these features, you must load the
+file and (optionally) set some variables.
+
address@hidden
+In your @file{.emacs} file in your home directory, or in the system-wide
+initialization file @file{default.el} in the @file{site-lisp} directory, put
+
address@hidden
+(add-hook 'dired-load-hook
+ (lambda ()
+ (load "dired-x")
+ ;; Set dired-x global variables here. For example:
+ ;; (setq dired-guess-shell-gnutar "gtar")
+ ;; (setq dired-x-hands-off-my-keys nil)
+ ))
+(add-hook 'dired-mode-hook
+ (lambda ()
+ ;; Set dired-x buffer-local variables here. For example:
+ ;; (dired-omit-mode 1)
+ ))
address@hidden example
+
address@hidden
+This will load @file{dired-x.el} when Dired is first invoked (for example,
+when you first type @kbd{C-x d}).
+
address@hidden
address@hidden
+* Optional Installation Dired Jump::
+* Optional Installation File At Point::
address@hidden menu
address@hidden ifnottex
+
address@hidden Optional Installation Dired Jump, Optional Installation File At
Point, , Installation
address@hidden node-name, next, previous, up
address@hidden Optional Installation Dired Jump
+
address@hidden 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
address@hidden have been properly loaded the user should set-up an autoload
+for these functions. In your @file{.emacs} file put
+
address@hidden
+;; Autoload `dired-jump' and `dired-jump-other-window'.
+;; We autoload from FILE dired.el. This will then load dired-x.el
+;; and hence define `dired-jump' and `dired-jump-other-window'.
+(define-key global-map "\C-x\C-j" 'dired-jump)
+(define-key global-map "\C-x4\C-j" 'dired-jump-other-window)
+
+(autoload (quote dired-jump) "dired" "\
+Jump to Dired buffer corresponding to current buffer.
+If in a file, Dired the current directory and move to file's line.
+If in Dired already, pop up a level and goto old directory's line.
+In case the proper Dired file line cannot be found, refresh the Dired
+buffer and try again." t nil)
+
+(autoload (quote dired-jump-other-window) "dired" "\
+Like \\[dired-jump] (dired-jump) but in other window." t nil)
address@hidden example
+
+Note that in recent releases of GNU Emacs 19 (i.e., 19.25 or later) the file
address@hidden/lisp/loaddefs.el} of the Emacs distribution already contains the
+proper auto-loading for @code{dired-jump} so you need only put
+
address@hidden
+(define-key global-map "\C-x\C-j" 'dired-jump)
address@hidden example
+
address@hidden
+in your @file{.emacs} file in order to have @kbd{C-x C-j} work
+before @code{dired} is loaded.
+
address@hidden Optional Installation File At Point, , Optional Installation
Dired Jump, Installation
address@hidden node-name, next, previous, up
address@hidden Optional Installation File At Point
+
address@hidden Binding @code{dired-x-find-file}
+If you choose to have @file{dired-x.el} bind @code{dired-x-find-file} over
address@hidden (@pxref{Find File At Point}), then you will need to set
address@hidden and make a call to the function
address@hidden in the @code{dired-load-hook}:
+
address@hidden
+(add-hook 'dired-load-hook
+ (lambda ()
+ (load "dired-x")
+ ;; Bind dired-x-find-file.
+ (setq dired-x-hands-off-my-keys nil)
+ ;; Make sure our binding preference is invoked.
+ (dired-x-bind-find-file)
+ ))
address@hidden example
+
+Alternatively, you can set the variable @emph{before} @file{dired-x.el} is
+loaded
+
address@hidden
+(add-hook 'dired-load-hook
+ (lambda ()
+ ;; Bind dired-x-find-file.
+ (setq dired-x-hands-off-my-keys nil)
+ (load "dired-x")
+ ))
address@hidden example
+
address@hidden Omitting Files in Dired, Local Variables, Installation, Top
address@hidden node-name, next, previous, up
address@hidden Omitting Files in Dired
+
address@hidden Omitting Files in Dired
address@hidden Uninteresting files
address@hidden 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
+the user can concentrate on the interesting files. Like hidden files, omitted
+files are never seen by Dired. Omitting differs from hiding in several
+respects:
+
address@hidden @bullet
+
address@hidden
+Omitting works on individual files, not on directories; an entire directory
+cannot be omitted (though each of its files could be).
+
address@hidden
+Omitting is wholesale; if omitting is turned on for a Dired buffer, then all
+uninteresting files listed in that buffer are omitted. The user does not omit
+(or unomit) files one at a time.
+
address@hidden
+Omitting can be automatic; uninteresting file lines in the buffer can be
+removed before the user ever sees them.
+
address@hidden
+Marked files are never omitted.
address@hidden itemize
+
address@hidden @kbd
address@hidden M-o
address@hidden M-o
address@hidden dired-omit-mode
+(@code{dired-omit-mode}) Toggle between displaying and omitting
+``uninteresting'' files.
address@hidden * O
address@hidden * O
address@hidden dired-mark-omitted
+(@code{dired-mark-omitted}) Mark ``uninteresting'' files.
address@hidden table
+
address@hidden
+In order to make Dired Omit work you first need to load @file{dired-x.el}
+inside @code{dired-load-hook} (@pxref{Installation}) and then evaluate
address@hidden(dired-omit-mode 1)} in some way (@pxref{Omitting Variables}).
+
address@hidden
address@hidden
+* Omitting Variables::
+* Omitting Examples::
+* Omitting Technical::
address@hidden menu
address@hidden ifnottex
+
address@hidden Omitting Variables, Omitting Examples, , Omitting Files in Dired
address@hidden node-name, next, previous, up
+
address@hidden Omitting Variables
+
address@hidden Customizing file omitting
+The following variables can be used to customize omitting.
+
address@hidden @code
+
address@hidden dired-omit-mode
address@hidden dired-omit-mode
+
+Default: @code{nil}
+
address@hidden How to make omitting the default in Dired
+If address@hidden, ``uninteresting'' files are not listed.
+Uninteresting files are those whose files whose names match regexp
address@hidden, plus those ending with extensions in
address@hidden @kbd{M-o} (@code{dired-omit-mode})
+toggles its value, which is buffer-local. Put
+
address@hidden
+(dired-omit-mode 1)
address@hidden example
+
address@hidden
+inside your @code{dired-mode-hook} to have omitting initially turned on in
address@hidden Dired buffer (@pxref{Installation}). You can then use @kbd{M-o}
to
+unomit in that buffer.
+
+To enable omitting automatically only in certain directories one can use Dired
+Local Variables and put
+
address@hidden
+Local Variables:
+dired-omit-mode: t
+End:
address@hidden example
+
address@hidden
+into a file @file{.dired} (the default value of
address@hidden) in that directory (@pxref{Local Variables}).
+
address@hidden @code
address@hidden dired-omit-here-always
address@hidden dired-omit-here-always
+
+This is an interactive function that creates a local variables file exactly
+like the example above (if it does not already exist) in the file
address@hidden in the current directory and then refreshes
+the directory listing (@pxref{Local Variables}).
address@hidden table
+
address@hidden dired-omit-files
address@hidden dired-omit-files
+
+Default: @code{"^#\\|\\.$"}
+
+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}).
+
address@hidden dired-omit-extensions
address@hidden dired-omit-extensions
+
+Default: The elements of @code{completion-ignored-extensions},
address@hidden, @code{dired-bibtex-unclean-extensions}
+and @code{dired-texinfo-unclean-extensions}.
+
+If address@hidden, a list of extensions (strings) to omit from Dired listings.
+Its format is the same as that of @code{completion-ignored-extensions}.
+
address@hidden dired-omit-localp
address@hidden dired-omit-localp
+
+Default: @code{no-dir}
+
+The @var{localp} argument @code{dired-omit-expunge} passes to
address@hidden If it is @code{no-dir}, omitting is much faster,
+but you can only match against the non-directory part of the file name. Set it
+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.
+
address@hidden dired-omit-marker-char
address@hidden dired-omit-marker-char
address@hidden Omitting additional files
+Default: @kbd{C-o}
+
+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
+
address@hidden
+(setq dired-mark-keys "\C-o")
+;; i.e., the value of dired-omit-marker-char
+;; (which is not defined yet)
address@hidden example
+
address@hidden
+to your @file{~/.emacs}, you can bind the @kbd{C-o} key to insert a
address@hidden 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.
+
address@hidden table
+
address@hidden Omitting Examples, Omitting Technical, Omitting Variables,
Omitting Files in Dired
address@hidden node-name, next, previous, up
address@hidden Examples of Omitting Various File Types
+
address@hidden @bullet
+
address@hidden
address@hidden RCS files, how to omit them in Dired
address@hidden Omitting RCS files in Dired
+If you wish to avoid seeing RCS files and the @file{RCS} directory, then put
+
address@hidden
+(setq dired-omit-files
+ (concat dired-omit-files "\\|^RCS$\\|,v$"))
address@hidden example
+
address@hidden
+in the @code{dired-load-hook} (@pxref{Installation}). This assumes
address@hidden has its default value of @code{no-dir} to make the
address@hidden matches work. As a slower alternative, with
address@hidden set to @code{nil}, you can use @code{/} instead of
address@hidden in the regexp.
+
address@hidden
address@hidden Tib files, how to omit them in Dired
address@hidden Omitting tib files in Dired
+If you use @code{tib}, the bibliography program for use with @TeX{} and
address@hidden, and you
+want to omit the @file{INDEX} and the @file{*-t.tex} files, then put
+
address@hidden
+(setq dired-omit-files
+ (concat dired-omit-files "\\|^INDEX$\\|-t\\.tex$"))
address@hidden example
+
address@hidden
+in the @code{dired-load-hook} (@pxref{Installation}).
+
address@hidden
address@hidden Dot files, how to omit them in Dired
address@hidden Omitting dot files in Dired
+If you do not wish to see @samp{dot} files (files starting with a @file{.}),
+then put
+
address@hidden
+(setq dired-omit-files
+ (concat dired-omit-files "\\|^\\..+$"))
address@hidden example
+
address@hidden
+in the @code{dired-load-hook} (@pxref{Installation}).
+
address@hidden itemize
+
address@hidden Omitting Technical, , Omitting Examples, Omitting Files in Dired
address@hidden node-name, next, previous, up
address@hidden Some Technical Details of Omitting
+
+Loading @file{dired-x.el} will install Dired Omit by putting
address@hidden on your @code{dired-after-readin-hook}, and will
+call @code{dired-extra-startup}, which in turn calls @code{dired-omit-startup}
+in your @code{dired-mode-hook}.
+
address@hidden Local Variables, Shell Command Guessing, Omitting Files in
Dired, Top
address@hidden node-name, next, previous, up
address@hidden Local Variables for Dired Directories
+
address@hidden Local Variables for Dired Directories
address@hidden dired-local-variables-file
address@hidden dired-enable-local-variables
address@hidden
+When Dired visits a directory, it looks for a file whose name is the value of
+variable @code{dired-local-variables-file} (default: @file{.dired}). If such
+a file is found, Dired will temporarily insert it into the Dired buffer and
+run @code{hack-local-variables}.
+
address@hidden
+For example, if the user puts
+
address@hidden
+Local Variables:
+dired-actual-switches: "-lat"
+dired-omit-mode: t
+End:
address@hidden example
+
address@hidden
+into a file called @file{.dired} in a directory then when that directory is
+viewed it will be
+
address@hidden
address@hidden
+sorted by date
address@hidden
+omitted automatically
address@hidden enumerate
+
address@hidden
+You can set @code{dired-local-variables-file} to @code{nil} to suppress this.
+The value of @code{dired-enable-local-variables} controls if and how these
+local variables are read. This variable exists so that if may override the
+default value of @code{enable-local-variables}.
+
address@hidden
+Please see the GNU Emacs Manual to learn more about local variables.
address@hidden Variables,Local Variables in Files,Local Variables in
+Files,emacs,The GNU Emacs Manual}.
+
address@hidden
+The following variables affect Dired Local Variables
+
address@hidden @code
address@hidden dired-local-variables-file
address@hidden dired-local-variables-file
+Default: @code{".dired"}
+
+If address@hidden, file name for local variables for Dired. If Dired finds a
+file with that name in the current directory, it will temporarily insert it
+into the Dired buffer and run @code{hack-local-variables}.
+
address@hidden dired-enable-local-variables
address@hidden dired-enable-local-variables
+Default: @code{t}
+
+Controls the use of local-variables lists in Dired. The value can be @code{t},
address@hidden, or something else. A value of @code{t} means local-variables
+lists are obeyed in the @code{dired-local-variables-file}; @code{nil} means
+they are ignored; anything else means query. This variable temporarily
+overrides the value of @code{enable-local-variables} when the Dired Local
+Variables are hacked.
address@hidden table
+
address@hidden Shell Command Guessing, Virtual Dired, Local Variables, Top
address@hidden node-name, next, previous, up
address@hidden Shell Command Guessing
address@hidden 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
+on a file named @file{foo.tar} and you press @kbd{!}, Dired will guess
+you want to @samp{tar xvf} it and suggest that as the default shell
+command.
+
+The default is mentioned in brackets and you can type @kbd{M-p} to get
+the default into the minibuffer and then edit it, e.g., to change
address@hidden xvf} to @samp{tar tvf}. If there are several commands for a
given
+file, e.g., @samp{xtex} and @samp{dvips} for a @file{.dvi} file, you can type
address@hidden several times to see each of the matching commands.
+
+Dired only tries to guess a command for a single file, never for a list
+of marked files.
+
address@hidden @code
address@hidden dired-guess-shell-alist-default
address@hidden 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 address@hidden
+
address@hidden dired-guess-shell-alist-user
address@hidden dired-guess-shell-alist-user
+If address@hidden, a 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).
address@hidden
+
+Each element of the alist looks like
+
address@hidden
+(@var{regexp} @address@hidden)
address@hidden example
+
address@hidden
+where each @var{command} can either be a string or a Lisp expression
+that evaluates to a string. If several commands are given, all of
+them will temporarily be pushed onto the history.
+
+If @samp{*} in the shell command, that means to substitute the file
+name.
+
+You can set this variable in your @file{~/.emacs}. For example,
+to add rules for @samp{.foo} and @samp{.bar} file extensions, write
+
address@hidden
+(setq dired-guess-shell-alist-user
+ (list
+ (list "\\.foo$" "@var{foo-command}");; fixed rule
+ ;; possibly more rules...
+ (list "\\.bar$";; rule with condition test
+ '(if @var{condition}
+ "@var{bar-command-1}"
+ "@var{bar-command-2}"))))
address@hidden example
+
address@hidden
+This will override any predefined rules for the same extensions.
+
address@hidden dired-guess-shell-gnutar
address@hidden dired-guess-shell-gnutar
address@hidden Passing GNU Tar its @samp{z} switch.
+Default: @code{nil}
+
+If address@hidden, this is the name of the GNU Tar executable (e.g.,
address@hidden 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.
+
address@hidden dired-guess-shell-gzip-quiet
address@hidden dired-guess-shell-gzip-quiet
address@hidden @code{gzip}
+Default: @code{t}
+
+A address@hidden value means that @samp{-q} is passed to @code{gzip}
+overriding a verbose option in the @env{GZIP} environment variable.
+
address@hidden dired-guess-shell-znew-switches nil
address@hidden dired-guess-shell-znew-switches nil
address@hidden @code{znew}
+Default: @code{nil}
+
+A string of switches passed to @code{znew}. An example is
address@hidden which will make @code{znew} keep a @file{.Z} file when it is
+smaller than the @file{.gz} file.
+
address@hidden dired-shell-command-history nil
address@hidden dired-shell-command-history nil
+
+History list for commands that read dired-shell commands.
address@hidden table
+
address@hidden Virtual Dired, Advanced Mark Commands, Shell Command Guessing,
Top
address@hidden node-name, next, previous, up
address@hidden Virtual Dired
+
address@hidden Virtual Dired
address@hidden Perusing @code{ls} listings
address@hidden @code{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}
+output file, for example one you got from an FTP server. You can use
+all motion commands usually available in Dired. You can also use
+it to save a Dired buffer in a file and resume it in a later session.
+
address@hidden dired-virtual
address@hidden g
address@hidden dired-virtual-revert
+Type @kbd{M-x dired-virtual} to put the current buffer into virtual
+Dired mode. You will be prompted for the top level directory of this
+buffer, with a default value guessed from the buffer contents. To
+convert the virtual to a real Dired buffer again, type @kbd{g} (which
+calls @code{dired-virtual-revert}) in the virtual Dired buffer and
+answer @samp{y}. You don't have to do this, though: you can relist
+single subdirectories using @kbd{l} (@code{dired-do-redisplay}) on the
subdirectory
+headerline, leaving the buffer in virtual Dired mode all the time.
+
address@hidden dired-virtual-mode
address@hidden auto-mode-alist
+The function @samp{dired-virtual-mode} is specially designed to turn on
+virtual Dired mode from the @code{auto-mode-alist}. To edit all
address@hidden files automatically in virtual Dired mode, put this into your
address@hidden/.emacs}:
+
address@hidden
+(setq auto-mode-alist (cons '("[^/]\\.dired$" . dired-virtual-mode)
+ auto-mode-alist))
address@hidden example
+
address@hidden
+The regexp is a bit more complicated than usual to exclude @file{.dired}
+local-variable files.
+
address@hidden Advanced Mark Commands, Multiple Dired Directories, Virtual
Dired, Top
address@hidden node-name, next, previous, up
address@hidden Advanced Mark Commands
+
address@hidden @kbd
address@hidden F
address@hidden F
address@hidden Visiting several files at once
address@hidden Simultaneous visiting of several files
address@hidden 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 address@hidden then just
+find the
+files but do not select. If you want to keep the Dired buffer displayed, type
address@hidden 2} first. If you want just the marked files displayed and
nothing
+else, type @kbd{C-x 1} first.
+
+The current window is split across all files marked, as evenly as possible.
+Remaining lines go to the bottom-most window. The number of files that can be
+displayed this way is restricted by the height of the current window and the
+variable @code{window-min-height}.
address@hidden table
+
address@hidden @code
address@hidden dired-mark-extension
address@hidden dired-mark-extension
+Mark all files with a certain extension for use in later commands. A @samp{.}
+is not automatically prepended to the string entered, you must type it
+explicitly.
+
+When called from Lisp, @var{extension} may also be a list of extensions
+and an optional argument @var{marker-char} specifies the marker used.
+
address@hidden dired-flag-extension
address@hidden dired-flag-extension
+Flag all files with a certain extension for deletion. A @samp{.} is
address@hidden automatically prepended to the string entered.
address@hidden table
+
address@hidden
address@hidden
+* Advanced Cleaning Functions::
+* Advanced Cleaning Variables::
+* Special Marking Function::
address@hidden menu
address@hidden ifnottex
+
address@hidden Advanced Cleaning Functions, Advanced Cleaning Variables, ,
Advanced Mark Commands
address@hidden node-name, next, previous, up
+
address@hidden Advanced Cleaning Functions
+
address@hidden @code
address@hidden dired-clean-patch
address@hidden dired-clean-patch
+Flag dispensable files created by the @samp{patch} program for deletion. See
+variable @code{dired-patch-unclean-extensions}.
+
address@hidden dired-clean-tex
address@hidden dired-clean-tex
+Flag dispensable files created by @TeX{}, address@hidden, and @samp{texinfo}
for
+deletion. See the following variables (@pxref{Advanced Cleaning Variables}):
+
address@hidden @bullet
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden
address@hidden itemize
+
address@hidden dired-very-clean-tex
address@hidden dired-very-clean-tex
+Flag dispensable files created by @TeX{}, address@hidden, @samp{texinfo},
+and @file{*.dvi} files for deletion.
address@hidden table
+
address@hidden Advanced Cleaning Variables, Special Marking Function, Advanced
Cleaning Functions, Advanced Mark Commands
address@hidden node-name, next, previous, up
+
address@hidden Advanced Cleaning Variables
+
address@hidden Variables used by the above cleaning commands (and in the
default value for
+variable @code{dired-omit-extensions}, @pxref{Omitting Variables})
+
address@hidden @code
address@hidden dired-patch-unclean-extensions
address@hidden dired-patch-unclean-extensions
+Default: @code{(".rej" ".orig")}
+
+List of extensions of dispensable files created by the @samp{patch} program.
+
address@hidden dired-tex-unclean-extensions
address@hidden dired-tex-unclean-extensions
+Default: @code{(".toc" ".log" ".aux")}
+
+List of extensions of dispensable files created by @TeX{}.
+
address@hidden dired-texinfo-unclean-extensions
address@hidden dired-texinfo-unclean-extensions
+Default: @code{(".cp" ".cps" ".fn" ".fns" ".ky" ".kys"}
address@hidden".pg" ".pgs" ".tp" ".tps" ".vr" ".vrs")}
+
+List of extensions of dispensable files created by @samp{texinfo}.
+
address@hidden dired-latex-unclean-extensions
address@hidden dired-latex-unclean-extensions
+Default: @code{(".idx" ".lof" ".lot" ".glo")}
+
+List of extensions of dispensable files created by address@hidden
+
address@hidden dired-bibtex-unclean-extensions
address@hidden dired-bibtex-unclean-extensions
+Default: @code{(".blg" ".bbl")}
+
+List of extensions of dispensable files created by address@hidden
address@hidden table
+
address@hidden Special Marking Function, , Advanced Cleaning Variables,
Advanced Mark Commands
address@hidden node-name, next, previous, up
+
address@hidden Special Marking Function
+
address@hidden @kbd
address@hidden M-(
address@hidden M-(
address@hidden dired-mark-sexp
address@hidden Lisp expression, marking files with in Dired
address@hidden Mark file by Lisp expression
+(@code{dired-mark-sexp}) Mark files for which @var{predicate} returns
address@hidden With a prefix argument, unflag those files instead.
+
+The @var{predicate} is a Lisp expression that can refer to the following
+symbols:
address@hidden @code
address@hidden inode
address@hidden the inode of the file (only for @samp{ls -i} output)
address@hidden s
address@hidden the size of the file for @samp{ls -s} output (usually in blocks
or,
+with @samp{-k}, in KBytes)
address@hidden mode
address@hidden file permission bits, e.g., @samp{-rw-r--r--}
address@hidden nlink
address@hidden number of links to file
address@hidden uid
address@hidden owner
address@hidden gid
address@hidden group (If the gid is not displayed by @samp{ls}, this
+will still be set (to the same as uid))
address@hidden size
address@hidden file size in bytes
address@hidden time
address@hidden the time that @samp{ls} displays, e.g., @samp{Feb 12 14:17}
address@hidden name
address@hidden the name of the file
address@hidden sym
address@hidden if file is a symbolic link, the linked-to name, else @code{""}
address@hidden table
+
address@hidden
+For example, use
address@hidden
+(equal 0 size)
address@hidden example
+to mark all zero length files.
+
+To find out all not yet compiled Emacs Lisp files in a directory, Dired
+all @file{.el} files in the lisp directory using the wildcard
address@hidden Then use @kbd{M-(} with
address@hidden
+(not (file-exists-p (concat name "c")))
address@hidden example
+to mark all @file{.el} files without a corresponding @file{.elc} file.
+
address@hidden table
+
address@hidden Multiple Dired Directories, Find File At Point, Advanced Mark
Commands, Top
address@hidden node-name, next, previous, up
address@hidden Multiple Dired Directories and Non-Dired Commands
+
address@hidden Multiple Dired directories
address@hidden 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
+directory: that of the top-level Dired directory in that buffer. For
+some commands it is appropriate that they use the current Dired
+directory instead of @code{default-directory}, e.g., @code{find-file} and
address@hidden
+
+A general mechanism is provided for special handling of the working
+directory in special major modes:
+
address@hidden @code
address@hidden default-directory-alist
address@hidden default-directory-alist
+Default: @code{((dired-mode . (dired-current-directory)))}
+
+Alist of major modes and their notion of @code{default-directory}, as a
+Lisp expression to evaluate. A resulting value of @code{nil} is ignored
+in favor of @code{default-directory}.
+
address@hidden dired-default-directory
address@hidden dired-default-directory
+Use this function like you would use the variable
address@hidden, except that @code{dired-default-directory}
+also consults the variable @code{default-directory-alist}.
address@hidden table
+
address@hidden Find File At Point, Miscellaneous Commands, Multiple Dired
Directories, Top
address@hidden node-name, next, previous, up
+
address@hidden Find File At Point
address@hidden Visiting a file mentioned in a buffer
address@hidden Finding a file at point
+
address@hidden 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
address@hidden file, etc.) or to test if that file exists. You can then modify
+this in the minibuffer after snatching the file name.
+
+When installed @file{dired-x} will substitute @code{dired-x-find-file} for
address@hidden (normally bound to @kbd{C-x C-f}) and
address@hidden for @code{find-file-other-window}
+(normally bound to @kbd{C-x 4 C-f}).
+
+In order to use this feature, you will need to set
address@hidden to @code{nil} inside @code{dired-load-hook}
+(@pxref{Optional Installation File At Point}).
+
address@hidden @code
address@hidden dired-x-find-file
address@hidden dired-x-find-file
address@hidden C-x C-f
+
address@hidden behaves exactly like @code{find-file} (normally bound
+to @kbd{C-x C-f}) unless a prefix argument is passed to the function in which
+case it will use the file name at point as a guess for the file to visit.
+
+For example, if the buffer you were reading contained the words
+
address@hidden
+Available via anonymous ftp in
+
+ /roebling.poly.edu:/pub/lisp/crypt++.el.gz
address@hidden example
+
address@hidden
+then you could move your cursor to the line containing the ftp address and
+type @kbd{C-u C-x C-f} (the @kbd{C-u} is a universal argument). The
+minibuffer would read
+
address@hidden
+Find file: /roebling.poly.edu:/pub/lisp/crypt++.el.gz
address@hidden example
+
address@hidden
+with the point after the last @code{/}. If you hit @key{RET}, emacs will visit
+the file at that address. This also works with files on your own computer.
+
address@hidden dired-x-find-file-other-window
address@hidden dired-x-find-file-other-window
address@hidden C-x 4 C-f
+
address@hidden behaves exactly like
address@hidden (normally bound to @kbd{C-x 4 C-f}) unless a
+prefix argument is used. See @code{dired-x-find-file} for more information.
+
address@hidden dired-x-hands-off-my-keys
address@hidden dired-x-hands-off-my-keys
+If set to @code{t}, then it means that @file{dired-x} should @emph{not} bind
address@hidden over @code{find-file} on keyboard. Similarly, it
+should not bind @code{dired-x-find-file-other-window} over
address@hidden If you change this variable after
address@hidden is loaded then do @kbd{M-x dired-x-bind-find-file}. The
+default value of this variable is @code{t}; by default, the binding is not
+done. See @xref{Optional Installation File At Point}.
+
address@hidden dired-x-bind-find-file
address@hidden dired-x-bind-find-file
+A function, which can be called interactively or in your @file{~/.emacs} file,
+that uses the value of @code{dired-x-hands-off-my-keys} to determine if
address@hidden should be bound over @code{find-file} and
address@hidden bound over
address@hidden See @xref{Optional Installation File At Point}.
address@hidden table
+
address@hidden Miscellaneous Commands, Bugs, Find File At Point, Top
address@hidden node-name, next, previous, up
address@hidden Miscellaneous Commands
+
+Miscellaneous features not fitting anywhere else:
+
address@hidden @code
address@hidden dired-find-subdir
address@hidden dired-find-subdir
+Default: @code{nil}
+
+If address@hidden, Dired does not make a new buffer for a directory if it can
+be found (perhaps as subdirectory) in some existing Dired buffer.
+
+If there are several Dired buffers for a directory, the most recently
+used is chosen.
+
+Dired avoids switching to the current buffer, so that if you have a
+normal and a wildcard buffer for the same directory, @kbd{C-x d RET}
+will toggle between those two.
address@hidden table
+
address@hidden @kbd
address@hidden dired-goto-subdir
address@hidden M-G
address@hidden M-G
+(@code{dired-goto-subdir}) Go to the header line of an inserted directory.
+This command reads its argument, with completion derived from the names of the
+inserted subdirectories.
address@hidden table
+
address@hidden @code
address@hidden dired-smart-shell-command
address@hidden dired-smart-shell-command
address@hidden shell-command
address@hidden M-!
+Like function @code{shell-command}, but in the current Dired directory.
+Bound to @kbd{M-!} in Dired buffers.
+
address@hidden dired-jump
address@hidden dired-jump
address@hidden C-x C-j
address@hidden 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
+found, refresh the Dired buffer and try again.
+
address@hidden dired-jump-other-window
address@hidden dired-jump-other-window
address@hidden C-x 4 C-j
+Bound to @kbd{C-x 4 C-j}. Like @code{dired-jump}, but to other window.
+
+These functions can be autoloaded so they work even though @file{dired-x.el}
+has not been loaded yet (@pxref{Optional Installation Dired Jump}).
+
address@hidden dired-bind-jump
+If the variable @code{dired-bind-jump} is @code{nil}, @code{dired-jump} will
not be
+bound to @kbd{C-x C-j} and @code{dired-jump-other-window} will not be bound to
address@hidden 4 C-j}.
+
address@hidden dired-vm
address@hidden Reading mail.
address@hidden V
address@hidden dired-vm
+Bound to @kbd{V} if @code{dired-bind-vm} is @code{t}. Run VM on this
+file (assumed to be a UNIX mail folder).
+
address@hidden dired-vm-read-only-folders
+If you give this command a prefix argument, it will visit the folder
+read-only. This only works in VM 5, not VM 4.
+
+If the variable @code{dired-vm-read-only-folders} is @code{t},
address@hidden will
+visit all folders read-only. If it is neither @code{nil} nor @code{t}, e.g.,
+the symbol @code{if-file-read-only}, only files not writable by you are
+visited read-only. This is the recommended value if you run VM 5.
+
address@hidden dired-bind-vm
+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.
+
address@hidden dired-rmail
address@hidden Reading mail.
address@hidden 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/BABYL format).
+
address@hidden dired-info
address@hidden I
address@hidden Running info.
address@hidden dired-info
+Bound to @kbd{I}. Run Info on this file (assumed to be a file in Info
+format).
+
address@hidden dired-bind-info
+If the variable @code{dired-bind-info} is @code{nil}, @code{dired-info} will
+not be bound to @kbd{I}.
+
address@hidden dired-man
address@hidden Running man.
address@hidden N
address@hidden dired-man
+Bound to @kbd{N}. Run man on this file (assumed to be a file in @code{nroff}
+format).
+
address@hidden dired-bind-man
+If the variable @code{dired-bind-man} is @code{nil}, @code{dired-man} will not
+be bound to @kbd{N}.
+
address@hidden dired-do-relsymlink
address@hidden Relative symbolic links.
address@hidden Y
address@hidden dired-do-relsymlink
+Bound to @kbd{Y}. Relative symlink all marked (or next ARG) files into a
+directory, or make a relative symbolic link to the current file. This creates
+relative symbolic links like
+
address@hidden
+ foo -> ../bar/foo
address@hidden example
+
address@hidden
+not absolute ones like
+
address@hidden
+ foo -> /ugly/path/that/may/change/any/day/bar/foo
address@hidden example
+
address@hidden dired-do-relsymlink-regexp
address@hidden %Y
address@hidden dired-do-relsymlink-regexp
+Bound to @kbd{%Y}. Relative symlink all marked files containing
address@hidden to @var{newname}. See functions
address@hidden and @code{dired-do-relsymlink} for more
+info.
address@hidden table
+
address@hidden Bugs, GNU Free Documentation License, Miscellaneous Commands, Top
address@hidden node-name, next, previous, up
address@hidden Bugs
address@hidden Bugs
address@hidden dired-x-submit-report
+
address@hidden
+If you encounter a bug in this package, wish to suggest an
+enhancement, or want to make a smart remark, then type
+
address@hidden
address@hidden dired-x-submit-report}
address@hidden example
+
address@hidden
+to set up an outgoing mail buffer, with the proper address to the
address@hidden maintainer automatically inserted in the @samp{To:@:} field.
+This command also inserts information that the Dired X maintainer can use to
+recreate your exact setup, making it easier to verify your bug or social
+maladjustment.
+
+Lawrence R. Dodd
address@hidden <dodd@@roebling.poly.edu>
+
address@hidden GNU Free Documentation License, Concept Index, Bugs, Top
address@hidden GNU Free Documentation License
address@hidden doclicense.texi
+
address@hidden Concept Index, Command Index, GNU Free Documentation
License, Top
address@hidden node-name, next, previous, up
address@hidden Concept Index
address@hidden cp
+
address@hidden Command Index, Key Index, Concept Index, Top
address@hidden node-name, next, previous, up
address@hidden Function Index
address@hidden fn
+
address@hidden Key Index, Variable Index, Command Index, Top
address@hidden node-name, next, previous, up
address@hidden Key Index
address@hidden ky
+
address@hidden Variable Index, , Key Index, Top
address@hidden node-name, next, previous, up
address@hidden Variable Index
address@hidden vr
+
address@hidden odd
address@hidden @summarycontents
address@hidden
+
address@hidden
address@hidden dired-x.texi ends here.
+
address@hidden
+ arch-tag: 201727aa-9318-4c74-a0d7-4f51c550c4de
address@hidden ignore