summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPo Lu <luangruo@yahoo.com>2022-03-19 11:35:55 +0800
committerPo Lu <luangruo@yahoo.com>2022-03-19 11:35:55 +0800
commitc7f085b53fe4bf0e6bc13e33b38f46f6b35a5608 (patch)
treef92d63e27bd602f9962259b3314bbf5f9377eb76
parentd2ba793ed97c7e759630109033cf729fee14446b (diff)
downloademacs-c7f085b53fe4bf0e6bc13e33b38f46f6b35a5608.tar.gz
emacs-c7f085b53fe4bf0e6bc13e33b38f46f6b35a5608.tar.bz2
emacs-c7f085b53fe4bf0e6bc13e33b38f46f6b35a5608.zip
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.
-rw-r--r--doc/emacs/dired.texi18
-rw-r--r--etc/NEWS1
-rw-r--r--lisp/dired.el2
3 files changed, 14 insertions, 7 deletions
diff --git a/doc/emacs/dired.texi b/doc/emacs/dired.texi
index 3112ac332b3..e18c8b048bc 100644
--- 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 c20d683710d..87fc3239902 100644
--- 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 2fe30d2a4e2..3790197f661 100644
--- 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)."