Merge from emacs--rel--22
[bpt/emacs.git] / man / dired-x.texi
index 8ac41ec..bf2d528 100644 (file)
 @comment %**end of header (This is for running Texinfo on a region.)
 
 @copying
-This documents the ``extra'' features for Dired Mode for GNU Emacs found in
-the file @file{dired-x.el}.
-
-Copyright @copyright{} 1993, 1994, 2001, 2002 Free Software Foundation, Inc.
+Copyright @copyright{} 1994, 1995, 1999, 2001, 2002, 2003, 2004,
+2005, 2006, 2007  Free Software Foundation, Inc.
 
 @quotation
-Permission is granted to make and distribute verbatim copies of this
-manual provided the copyright notice and this permission notice are
-preserved on all copies.
-
-Permission is granted to copy and distribute modified versions of
-this manual under the conditions for verbatim copying, provided that
-the entire resulting derived work is distributed under the terms of
-a permission notice identical to this one.
-
-Permission is granted to copy and distribute translations of this
-manual into another language, under the above conditions for
-modified versions, except that this permission notice may be stated
-in a translation approved by the Free Software Foundation.
-
-The file used to create this is called @file{dired-x.texi}, but the
-original work that was altered to make that file was called
-@file{dired.texi} written by Sebastian Kremer.
-
-@ignore
-Permission is granted to process this file through TeX and print the
-results, provided the printed document carries copying permission
-notice identical to this one except for the removal of this paragraph
-(this paragraph not being relevant to the printed manual).
-
-@end ignore
+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.
 @end quotation
 @end copying
 
@@ -79,9 +69,6 @@ notice identical to this one except for the removal of this paragraph
 @sp 1
 @center @titlefont{Directory Editor}
 @sp 4
-@center Manual Revision: 2.53
-@center 2001/02/25 14:05:46
-@sp 5
 @center Lawrence R@. Dodd
 @c @center @t{dodd@@roebling.poly.edu}
 @sp 5
@@ -93,7 +80,7 @@ notice identical to this one except for the removal of this paragraph
 
 @page
 
-@ifinfo
+@ifnottex
 
 @node Top
 @comment  node-name,  next,  previous,  up
@@ -137,6 +124,7 @@ For @file{dired-x.el} revision 2
 * Miscellaneous Commands::
 * Bugs::
 
+* GNU Free Documentation License::
 * Concept Index::
 * Command Index::
 * Key Index::
@@ -144,7 +132,7 @@ For @file{dired-x.el} revision 2
 
 @end menu
 
-@end ifinfo
+@end ifnottex
 
 @node Introduction, Installation, Top, Top
 @comment  node-name,  next,  previous,  up
@@ -161,12 +149,12 @@ 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.
 
-@ifinfo
+@ifnottex
 @menu
 * Features::
 * Technical Details::
 @end menu
-@end ifinfo
+@end ifnottex
 
 @node Features, Technical Details, , Introduction
 @comment  node-name,  next,  previous,  up
@@ -278,12 +266,12 @@ initialization file @file{default.el} in the @file{site-lisp} directory, put
 This will load @file{dired-x.el} when Dired is first invoked (for example,
 when you first type @kbd{C-x d}).
 
-@ifinfo
+@ifnottex
 @menu
 * Optional Installation Dired Jump::
 * Optional Installation File At Point::
 @end menu
-@end ifinfo
+@end ifnottex
 
 @node Optional Installation Dired Jump, Optional Installation File At Point, , Installation
 @comment  node-name,  next,  previous,  up
@@ -297,9 +285,9 @@ In order to have @code{dired-jump} and @code{dired-jump-other-window}
 for these functions.  In your @file{.emacs} file put
 
 @example
-;;; 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'.
+;; 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)
 
@@ -397,8 +385,8 @@ Marked files are never omitted.
 @findex dired-omit-mode
 (@code{dired-omit-mode}) Toggle between displaying and omitting
 ``uninteresting'' files.
-@item M-O
-@kindex M-O
+@item O
+@kindex O
 @findex dired-mark-omitted
 (@code{dired-mark-omitted}) Mark ``uninteresting'' files.
 @end table
@@ -408,13 +396,13 @@ 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
 @code{(dired-omit-mode 1)} in some way (@pxref{Omitting Variables}).
 
-@ifinfo
+@ifnottex
 @menu
 * Omitting Variables::
 * Omitting Examples::
 * Omitting Technical::
 @end menu
-@end ifinfo
+@end ifnottex
 
 @node Omitting Variables, Omitting Examples, , Omitting Files in Dired
 @comment  node-name,  next,  previous,  up
@@ -838,13 +826,13 @@ Flag all files with a certain extension for deletion.  A @samp{.} is
 @emph{not} automatically prepended to the string entered.
 @end table
 
-@ifinfo
+@ifnottex
 @menu
 * Advanced Cleaning Functions::
 * Advanced Cleaning Variables::
 * Special Marking Function::
 @end menu
-@end ifinfo
+@end ifnottex
 
 @node Advanced Cleaning Functions, Advanced Cleaning Variables, , Advanced Mark Commands
 @comment  node-name,  next,  previous,  up
@@ -1004,10 +992,11 @@ 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}.
 
-@item default-directory
-@findex default-directory
-Function with usage like variable @code{default-directory}, but knows about the
-special cases in variable @code{default-directory-alist}.
+@item dired-default-directory
+@findex dired-default-directory
+Use this function like you would use the variable
+@code{default-directory}, except that @code{dired-default-directory}
+also consults the variable @code{default-directory-alist}.
 @end table
 
 @node Find File At Point, Miscellaneous Commands, Multiple Dired Directories, Top
@@ -1153,8 +1142,8 @@ bound to @kbd{C-x C-j} and @code{dired-jump-other-window} will not be bound to
 @cindex Reading mail.
 @kindex V
 @findex dired-vm
-Bound to @kbd{V} if @code{dired-bind-vm} is t.  Run VM on this file (assumed
-to be a UNIX mail folder).
+Bound to @kbd{V} if @code{dired-bind-vm} is @code{t}.  Run VM on this
+file (assumed to be a UNIX mail folder).
 
 @vindex dired-vm-read-only-folders
 If you give this command a prefix argument, it will visit the folder
@@ -1167,8 +1156,8 @@ 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.
 
 @vindex dired-bind-vm
-If the variable @code{dired-bind-vm} is t, @code{dired-vm} will be bound to
-@kbd{V}.  Otherwise, @code{dired-bind-rmail} will be bound.
+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.
@@ -1198,10 +1187,10 @@ format).
 If the variable @code{dired-bind-man} is @code{nil}, @code{dired-man} will not
 be bound to @kbd{N}.
 
-@item dired-do-relative-symlink
+@item dired-do-relsymlink
 @cindex Relative symbolic links.
 @kindex Y
-@findex dired-do-relative-symlink
+@findex 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
@@ -1217,16 +1206,16 @@ not absolute ones like
     foo -> /ugly/path/that/may/change/any/day/bar/foo
 @end example
 
-@item dired-do-relative-symlink-regexp
+@item dired-do-relsymlink-regexp
 @kindex %Y
-@findex dired-do-relative-symlink-regexp
+@findex dired-do-relsymlink-regexp
 Bound to @kbd{%Y}.  Relative symlink all marked files containing
 @var{regexp} to @var{newname}.  See functions
 @code{dired-do-rename-regexp} and @code{dired-do-relsymlink} for more
 info.
 @end table
 
-@node Bugs, Concept Index, Miscellaneous Commands, Top
+@node Bugs, GNU Free Documentation License, Miscellaneous Commands, Top
 @comment  node-name,  next,  previous,  up
 @chapter Bugs
 @cindex Bugs
@@ -1250,7 +1239,11 @@ maladjustment.
 Lawrence R. Dodd
 @c <dodd@@roebling.poly.edu>
 
-@node     Concept Index, Command Index, Bugs, Top
+@node GNU Free Documentation License, Concept Index, Bugs, Top
+@appendix GNU Free Documentation License
+@include doclicense.texi
+
+@node     Concept Index, Command Index, GNU Free Documentation License, Top
 @comment  node-name,  next,  previous,  up
 @unnumbered Concept Index
 @printindex cp