Proposed changes to dired.texi and `dired-copy-filename-as-kill'.

[Luc Teirlinck]

I read man/dired.texi and propose some changes.  I also propose a
change to `dired-copy-filename-as-kill'.

In as far as the change to `dired-copy-filename-as-kill' is concerned,
currently an argument of just `-' behaves like an argument of just
`C-u' on the current line.  This is neither documented in the Emacs
manual, nor in the docstring, which only mention `C-u'.  It would be
more in line with other Dired commands and standard Emacs practice
if M-- behaved just like M--1, that is, operated on the previous
line.  The patch to dired.el below implements that.  It also clarifies
and corrects the docstring.

In as far as the changes to dired.texi are concerned, it removes the
reference to the no longer existing `dired-view-command-alist'.  I
believe that the corresponding functionality has been completely deleted.
Is this correct?

Certain key bindings are added in the section on marks that are more
convenient than the ones currently listed, although the ones currently
listed are kept as alternatives.

I propose to delete the lines:

- The subdirectory hiding commands toggle; that is, they hide what was
- visible, and show what was hidden.

in the section on hiding subdirectories, since they are inaccurate in
as far as M-$ is concerned and the same statement already occurs
before in the node in a more accurate form.

The description of `dired-copy-filename-as-kill' has been made more
accurate and complete.

===File ~/dired.el-diff-1===================================
*** dired.el    27 Mar 2005 18:59:10 -0600      1.305
--- dired.el    02 Apr 2005 20:38:46 -0600      
***************
*** 1937,1946 ****
    "Copy names of marked (or next ARG) files into the kill ring.
  The names are separated by a space.
  With a zero prefix arg, use the absolute file name of each marked file.
! With \\[universal-argument], use the file name sans directory of each marked 
file.
  
! If on a subdir headerline, use subdirname instead; prefix arg is ignored
! in this case.
  
  You can then feed the file name(s) to other commands with \\[yank]."
    (interactive "P")
--- 1937,1947 ----
    "Copy names of marked (or next ARG) files into the kill ring.
  The names are separated by a space.
  With a zero prefix arg, use the absolute file name of each marked file.
! With \\[universal-argument], use the file name relative to the Dired buffer's
! `default-directory'.  (This still may contain slashes if in a subdirectory.)
  
! If on a subdir headerline, use absolute subdirname instead;
! prefix arg and marked files are ignored in this case.
  
  You can then feed the file name(s) to other commands with \\[yank]."
    (interactive "P")
***************
*** 1950,1959 ****
                          (if arg
                              (cond ((zerop (prefix-numeric-value arg))
                                     (dired-get-marked-files))
!                                   ((integerp arg)
!                                    (dired-get-marked-files 'no-dir arg))
!                                   (t    ; else a raw arg
!                                    (dired-get-marked-files t)))
                            (dired-get-marked-files 'no-dir))
                          " "))))
      (if (eq last-command 'kill-region)
--- 1951,1961 ----
                          (if arg
                              (cond ((zerop (prefix-numeric-value arg))
                                     (dired-get-marked-files))
!                                   ((consp arg)
!                                    (dired-get-marked-files t))
!                                   (t
!                                    (dired-get-marked-files
!                                   'no-dir (prefix-numeric-value arg))))
                            (dired-get-marked-files 'no-dir))
                          " "))))
      (if (eq last-command 'kill-region)
============================================================

===File ~/dired.texi-diff-1=================================
*** dired.texi  28 Mar 2005 15:19:31 -0600      1.36
--- dired.texi  02 Apr 2005 21:11:48 -0600      
***************
*** 289,303 ****
  @item v
  @kindex v @r{(Dired)}
  @findex dired-view-file
! View the file described on the current line, using either an external
! viewing program or @kbd{M-x view-file} (@code{dired-view-file}).
! 
! @vindex dired-view-command-alist
! External viewers are used for certain file types under the control of
! @code{dired-view-command-alist}.  Viewing a file with @code{view-file}
! is like visiting it, but is slanted toward moving around in the file
  conveniently and does not allow changing the file.  @xref{Misc File
! Ops,View File, Miscellaneous File Operations}.
  
  @item ^
  @kindex ^ @r{(Dired)}
--- 289,299 ----
  @item v
  @kindex v @r{(Dired)}
  @findex dired-view-file
! View the file described on the current line, using @kbd{M-x view-file}
! (@code{dired-view-file}).  Viewing a file with @code{view-file} is
! like visiting it, but is slanted toward moving around in the file
  conveniently and does not allow changing the file.  @xref{Misc File
! Ops, View File, Miscellaneous File Operations}.
  
  @item ^
  @kindex ^ @r{(Dired)}
***************
*** 376,388 ****
--- 372,388 ----
  (@code{dired-unmark-backward}).
  
  @item * !
+ @itemx U
  @kindex * ! @r{(Dired)}
+ @kindex U @r{(Dired)}
  @findex dired-unmark-all-marks
  Remove all marks from all the files in this Dired buffer
  (@code{dired-unmark-all-marks}).
  
  @item * ? @var{markchar}
+ @itemx address@hidden
  @kindex * ? @r{(Dired)}
+ @kindex M-DEL @r{(Dired)}
  @findex dired-unmark-all-files
  Remove all marks that use the character @var{markchar}
  (@code{dired-unmark-all-files}).  The argument is a single
***************
*** 396,412 ****
  files without asking about them.
  
  @item * C-n
  @findex dired-next-marked-file
  @kindex * C-n @r{(Dired)}
  Move down to the next marked file (@code{dired-next-marked-file})
  A file is ``marked'' if it has any kind of mark.
  
  @item * C-p
  @findex dired-prev-marked-file
  @kindex * C-p @r{(Dired)}
  Move up to the previous marked file (@code{dired-prev-marked-file})
  
! @item * t
  @kindex * t @r{(Dired)}
  @findex dired-toggle-marks
  @cindex toggling marks (in Dired)
--- 396,418 ----
  files without asking about them.
  
  @item * C-n
+ @itemx address@hidden
  @findex dired-next-marked-file
  @kindex * C-n @r{(Dired)}
+ @kindex address@hidden @r{(Dired)}
  Move down to the next marked file (@code{dired-next-marked-file})
  A file is ``marked'' if it has any kind of mark.
  
  @item * C-p
+ @itemx address@hidden
  @findex dired-prev-marked-file
  @kindex * C-p @r{(Dired)}
+ @kindex address@hidden @r{(Dired)}
  Move up to the previous marked file (@code{dired-prev-marked-file})
  
! @item t
! @itemx * t
! @kindex t @r{(Dired)}
  @kindex * t @r{(Dired)}
  @findex dired-toggle-marks
  @cindex toggling marks (in Dired)
***************
*** 968,976 ****
  can use hiding to temporarily exclude subdirectories from operations
  without having to remove the markers.
  
-   The subdirectory hiding commands toggle; that is, they hide what was
- visible, and show what was hidden.
- 
  @node Dired Updating
  @section Updating the Dired Buffer
  @cindex updating Dired buffer
--- 974,979 ----
***************
*** 1145,1162 ****
  @findex dired-copy-filename-as-kill
    The @kbd{w} command (@code{dired-copy-filename-as-kill}) puts the
  names of the marked (or next @var{n}) files into the kill ring, as if
! you had killed them with @kbd{C-w}.
  
    The main purpose of this command is so that you can yank the file
  names into arguments for other Emacs commands.  It also displays what
  was pushed onto the kill ring, so you can use it to display the list
  of currently marked files in the echo area.  With a zero prefix
! argument @var{n}=0, this uses the absolute file name of each marked
! file.  With just @kbd{C-u} as the prefix argument, it uses the
! relative file name of each marked file.  As a special case, if no
! prefix argument is given and point is on a directory headerline,
! @kbd{w} gives you the name of that directory without looking for
! marked files.
  
    On the X window system, Emacs supports the ``drag and drop''
  protocol.  You can drag a file object from another program, and drop
--- 1148,1165 ----
  @findex dired-copy-filename-as-kill
    The @kbd{w} command (@code{dired-copy-filename-as-kill}) puts the
  names of the marked (or next @var{n}) files into the kill ring, as if
! you had killed them with @kbd{C-w}.  The mames are separated by a space.
  
    The main purpose of this command is so that you can yank the file
  names into arguments for other Emacs commands.  It also displays what
  was pushed onto the kill ring, so you can use it to display the list
  of currently marked files in the echo area.  With a zero prefix
! argument, this uses the absolute file name of each marked file.  With
! just @kbd{C-u} as the prefix argument, it uses file names relative to
! the Dired buffer's default directory.  (This can still contain slashes
! if in a subdirectory.)  As a special case, if point is on a directory
! headerline, @kbd{w} gives you the absolute name of that directory.
! Any prefix argument or marked files are ignored in this case.
  
    On the X window system, Emacs supports the ``drag and drop''
  protocol.  You can drag a file object from another program, and drop
============================================================