* lisp/filet.el: Add Commentary

diff --git a/lisp/filet.el b/lisp/filet.el
index d1a22e35c6d432dc8bd327ace081c206926c024a..b343e1761cb3f532fe78b25e3395b67f88e307b5 100644 (file)
--- a/lisp/filet.el
+++ b/lisp/filet.el
@@ -20,7 +20,22 @@
 
 ;;; Commentary:
 
+;; This library provides a single command, `filet'.  It pops up a
+;; transient menu that lets you apply file system operations to files
+;; whose names you previously copied (killed).
 ;;
+;; `filet' works best with Dired: say you're in a Dired buffer showing
+;; and you want to copy some of the listed files to another location.
+;; Maybe you don't know exactly where you want to put them yet, but
+;; that's OK.  Simply mark some files and hit `0 w' to copy their
+;; absolute names.  You can consult some resource or just think what you
+;; want to do with those files, and then later, in another Dired buffer,
+;; hit `C-y' to invoke `filet'.  It remembers the file names that you've
+;; copied (even if you copy other things in between), and lets you copy,
+;; move or link those files to the current Dired directory.
+;;
+;; Initial development of this library was inspired by this discussion:
+;; https://lists.gnu.org/archive/html/emacs-devel/2024-10/msg00478.html
 
 ;;; Code: