Document dired-mouse-drag-files

* doc/emacs/dired.texi (Misc Dired Features): Explain that
dragging files is now supported.
* etc/NEWS: Update documentation status.
* lisp/dired.el (dired-mouse-drag-files): Fix typo in doc
string.

diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index 3112ac332b3697f75bf9ec95f0fc73fb65c7c33b..e18c8b048bcd111153946c6ee577defa4568cef6 100644 (file)
--- a/doc/emacs/dired.texi
+++ b/doc/emacs/dired.texi
@@ -1695,9 +1695,15 @@ directory than in this one.  It also marks files with no counterpart,
 in both directories, as always.
 
 @cindex drag and drop, Dired
-  On the X Window System, Emacs supports the drag and drop
-protocol.  You can drag a file object from another program, and drop
-it onto a Dired buffer; this either moves, copies, or creates a link
-to the file in that directory.  Precisely which action is taken is
-determined by the originating program.  Dragging files out of a Dired
-buffer is currently not supported.
+@vindex dired-mouse-drag-files
+  On the X Window System, Emacs supports the drag and drop protocol.
+You can drag a file object from another program, and drop it onto a
+Dired buffer; this either moves, copies, or creates a link to the file
+in that directory.  Precisely which action is taken is determined by
+the originating program.  Dragging files out of a Dired buffer is also
+supported, by enabling the user option @code{dired-mouse-drag-files},
+the mouse can be used to drag files onto other programs.  When set to
+@code{link}, it will make the other program (typically a file manager)
+create a symbolic link to the file, and setting it to any other
+non-@code{nil} value will make the other program open or create a copy
+of the file.

diff --git a/etc/NEWS b/etc/NEWS
index c20d683710dde4a591914d280ca9ed29d7ec5842..87fc32399024c7cf157dc8d1d1ff724e3f5d3029 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -942,6 +942,7 @@ the thumbnail file.
 
 ** Dired
 
++++
 *** New user option 'dired-mouse-drag-files'.
 If non-nil, dragging file names with the mouse in a Dired buffer will
 initiate a drag-and-drop session allowing them to be opened in other

diff --git a/lisp/dired.el b/lisp/dired.el
index 2fe30d2a4e2f3c2e1bbc26afa53f0ff390129d39..3790197f661a3972891e12af41f28316eec008b7 100644 (file)
--- a/lisp/dired.el
+++ b/lisp/dired.el
@@ -252,7 +252,7 @@ The target is used in the prompt for file copy, rename etc."
   "If non-nil, allow the mouse to drag files from inside a Dired buffer.
 Dragging the mouse and then releasing it over the window of
 another program will result in that program opening the file, or
-creating a copy of it .
+creating a copy of it.
 
 If the value is `link', then a symbolic link will be created to
 the file instead by the other program (usually a file manager)."