branch: elpa/casual
commit f4c7714eb6df08fcbfcb13f242f801ac4f5a7001
Author: Charles Choi <[email protected]>
Commit: Charles Choi <[email protected]>
Use marker for menu items using a command prefix
- Deploy convention to use ✦ as a suffix for a menu item that uses a command
prefix.
- Update Info documentation to support this change.
---
docs/casual.info | Bin 148480 -> 148775 bytes
docs/casual.org | 4 ++--
docs/casual.texi | 17 +++++++++++------
docs/dired.org | 2 +-
docs/elisp.org | 3 ++-
docs/eshell.org | 6 +++++-
docs/images/casual-dired-screenshot-unicode.png | Bin 144481 -> 139396 bytes
docs/images/casual-dired-screenshot.png | Bin 283490 -> 323765 bytes
docs/images/casual-elisp-edebug-screenshot.png | Bin 158941 -> 73348 bytes
docs/images/casual-elisp-screenshot.png | Bin 158044 -> 174559 bytes
docs/images/casual-elisp-unicode-screenshot.png | Bin 0 -> 83544 bytes
docs/images/casual-eshell-process-screenshot.png | Bin 98707 -> 97015 bytes
docs/images/casual-eshell-screenshot.png | Bin 67165 -> 70316 bytes
docs/images/casual-eshell-unicode-screenshot.png | Bin 0 -> 65682 bytes
lisp/casual-dired.el | 7 +++++--
lisp/casual-elisp.el | 4 ++--
lisp/casual-eshell.el | 6 +++---
17 files changed, 31 insertions(+), 18 deletions(-)
diff --git a/docs/casual.info b/docs/casual.info
index c3842d3f62..2f5072094b 100644
Binary files a/docs/casual.info and b/docs/casual.info differ
diff --git a/docs/casual.org b/docs/casual.org
index 109cc0a2e1..5af1a47240 100644
--- a/docs/casual.org
+++ b/docs/casual.org
@@ -103,7 +103,7 @@ If a mouse is available, a menu item can be selected by
moving the mouse cursor
Pressing the {{{kbd(?)}}} key or {{{kbd(C-h)}}} will toggle help for all the
menu items. Press the key of interest to get help for it.
-When a Transient menu is raised, a prefix argument ({{{kbd(C-u)}}}) and an
optional argument can be entered before selecting a menu item.
+When a Transient menu is raised, a command prefix argument ({{{kbd(C-u)}}})
and an optional argument can be entered before selecting a menu item. Menu
items which particularly use a command prefix are annotated with the ✦ glyph.
The command prefix can be cancelled with {{{kbd(C-g)}}}.
For Transient menus that offer setting different values, the following
bindings will allow you save them:
@@ -247,7 +247,7 @@ Casual annotates menu labels with the following conventions:
- ‘…’ :: If the label ends with an ellipsis, then the command will prompt the
user for input.
- ‘›’ :: If the label ends with a right-pointing arrow, then the item will
raise a sub-menu.
-- ‘ⁿ’ :: If the label ends with the superscript ‘ⁿ’, then the command supports
a prefix {{{kbd(C-u)}}}.
+- ‘✦’ :: If the label ends with the glyph ✦ (BLACK FOUR POINTED STAR), then
the command supports a prefix {{{kbd(C-u)}}}.
* Casual Modes
#+CINDEX: Casual Modes
diff --git a/docs/casual.texi b/docs/casual.texi
index f22ca87d1d..b4424867d3 100644
--- a/docs/casual.texi
+++ b/docs/casual.texi
@@ -396,7 +396,7 @@ If a mouse is available, a menu item can be selected by
moving the mouse cursor
Pressing the @kbd{?} key or @kbd{C-h} will toggle help for all the menu items.
Press the key of interest to get help for it.
-When a Transient menu is raised, a prefix argument (@kbd{C-u}) and an optional
argument can be entered before selecting a menu item.
+When a Transient menu is raised, a command prefix argument (@kbd{C-u}) and an
optional argument can be entered before selecting a menu item. Menu items which
particularly use a command prefix are annotated with the ✦ glyph. The command
prefix can be cancelled with @kbd{C-g}.
For Transient menus that offer setting different values, the following
bindings will allow you save them:
@@ -612,8 +612,8 @@ Casual annotates menu labels with the following conventions:
If the label ends with an ellipsis, then the command will prompt the user for
input.
@item ‘›’
If the label ends with a right-pointing arrow, then the item will raise a
sub-menu.
-@item ‘ⁿ’
-If the label ends with the superscript ‘ⁿ’, then the command supports a prefix
@kbd{C-u}.
+@item ‘✦’
+If the label ends with the glyph ✦ (BLACK FOUR POINTED STAR), then the command
supports a prefix @kbd{C-u}.
@end table
@node Casual Modes
@@ -1768,7 +1768,7 @@ Casual Dired organizes its main menu into the following
sections:
File-related commands are placed here. Most of the commands will also operate
on marked files (see @strong{Mark} item below).
@item Directory
-Directory-related commands. Subdir view commands are also made available in
this section. To remove a subdir view, use the prefix @kbd{C-u} before pressing
the binding @kbd{k} to kill a subdir view.
+Directory-related commands. Subdir view commands are also made available in
this section. To remove a subdir view, use the command prefix @kbd{C-u} before
pressing the binding @kbd{k} to kill a subdir view.
@item Mark
Marking operations are available here. Commands in the “@kbd{#} Utils›”
sub-menu can be used to operate on marked items. In addition, many commands
from the @strong{File} section can be operate on marked items.
@@ -2359,7 +2359,7 @@ Commands for Sexp (balanced expression) navigation.
@subheading Edebug Support
@cindex Edebug
-Using the prefix @kbd{C-u} when @code{casual-elisp-tmenu} is raised will
change the “@kbd{d} Defunⁿ” menu item to “@kbd{d} Edebugⁿ” to support
instrumenting a function for Edebug (@ref{Edebug,,,elisp,}).
+Using the command prefix @kbd{C-u} when @code{casual-elisp-tmenu} is raised
will change the “@kbd{d} Defun✦” menu item to “@kbd{d} Edebug” to support
instrumenting a function for Edebug (@ref{Edebug,,,elisp,}).
@image{images/casual-elisp-edebug-screenshot,,,,png}
@@ -2367,6 +2367,8 @@ Using the prefix @kbd{C-u} when @code{casual-elisp-tmenu}
is raised will change
By enabling “@kbd{u} Use Unicode Symbols” from the Settings menu, Casual Elisp
will use Unicode symbols as appropriate in its menus.
+@image{images/casual-elisp-unicode-screenshot,,,,png}
+
@node Eshell
@section Eshell
@@ -2410,7 +2412,7 @@ Commands supporting arguments in the current prompt.
@item Prompt
Navigation of previous prompt commands.
@item Output
-Commands related to display of prompt. Commands marked with an @code{n}
superscript support an optional prefix (@kbd{C-u}) value.
+Commands related to display of prompt. Commands marked with the glyph ✦
support an optional prefix (@kbd{C-u}) value.
@item Misc
Miscellaneous commands.
@item Process
@@ -2425,6 +2427,9 @@ Signal commands to send to the process. This section is
only visible when a proc
By enabling “@kbd{u} Use Unicode Symbols” from the Settings menu, Casual
Eshell will use Unicode symbols as appropriate in its menus.
+
+@image{images/casual-eshell-unicode-screenshot,,,,png}
+
@node Help
@section Help
diff --git a/docs/dired.org b/docs/dired.org
index 37254e9b1d..c70b4f1f50 100644
--- a/docs/dired.org
+++ b/docs/dired.org
@@ -117,7 +117,7 @@ Casual Dired organizes its main menu into the following
sections:
- File :: File-related commands are placed here. Most of the commands will
also operate on marked files (see *Mark* item below).
-- Directory :: Directory-related commands. Subdir view commands are also made
available in this section. To remove a subdir view, use the prefix
{{{kbd(C-u)}}} before pressing the binding {{{kbd(k)}}} to kill a subdir view.
+- Directory :: Directory-related commands. Subdir view commands are also made
available in this section. To remove a subdir view, use the command prefix
{{{kbd(C-u)}}} before pressing the binding {{{kbd(k)}}} to kill a subdir view.
- Mark :: Marking operations are available here. Commands in the “{{{kbd(#)}}}
Utils›” sub-menu can be used to operate on marked items. In addition, many
commands from the *File* section can be operate on marked items.
diff --git a/docs/elisp.org b/docs/elisp.org
index 7fbce42eb6..943b808121 100644
--- a/docs/elisp.org
+++ b/docs/elisp.org
@@ -45,7 +45,7 @@ The following sections are offered in the menu:
#+TEXINFO: @subheading Edebug Support
#+CINDEX: Edebug
-Using the prefix {{{kbd(C-u)}}} when ~casual-elisp-tmenu~ is raised will
change the “{{{kbd(d)}}} Defunⁿ” menu item to “{{{kbd(d)}}} Edebugⁿ” to support
instrumenting a function for Edebug ([[info:elisp#Edebug]]).
+Using the command prefix {{{kbd(C-u)}}} when ~casual-elisp-tmenu~ is raised
will change the “{{{kbd(d)}}} Defun✦” menu item to “{{{kbd(d)}}} Edebug” to
support instrumenting a function for Edebug ([[info:elisp#Edebug]]).
[[file:images/casual-elisp-edebug-screenshot.png]]
@@ -53,3 +53,4 @@ Using the prefix {{{kbd(C-u)}}} when ~casual-elisp-tmenu~ is
raised will change
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Elisp will use Unicode symbols as appropriate in its menus.
+[[file:images/casual-elisp-unicode-screenshot.png]]
diff --git a/docs/eshell.org b/docs/eshell.org
index 7e9cfff49c..9b28f51c86 100644
--- a/docs/eshell.org
+++ b/docs/eshell.org
@@ -30,7 +30,7 @@ The following sections are offered in the menu:
- Input :: Commands supporting input to the current prompt.
- Argument :: Commands supporting arguments in the current prompt.
- Prompt :: Navigation of previous prompt commands.
-- Output :: Commands related to display of prompt. Commands marked with an ~n~
superscript support an optional prefix ({{{kbd(C-u)}}}) value.
+- Output :: Commands related to display of prompt. Commands marked with the
glyph ✦ support an optional prefix ({{{kbd(C-u)}}}) value.
- Misc :: Miscellaneous commands.
- Process :: Signal commands to send to the process. This section is only
visible when a process is running.
@@ -42,3 +42,7 @@ The following sections are offered in the menu:
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Eshell will use Unicode symbols as appropriate in its menus.
+
+[[file:images/casual-eshell-unicode-screenshot.png]]
+
+
diff --git a/docs/images/casual-dired-screenshot-unicode.png
b/docs/images/casual-dired-screenshot-unicode.png
index 3f9bff2753..7c4f504035 100644
Binary files a/docs/images/casual-dired-screenshot-unicode.png and
b/docs/images/casual-dired-screenshot-unicode.png differ
diff --git a/docs/images/casual-dired-screenshot.png
b/docs/images/casual-dired-screenshot.png
index 669eae2c0c..eff5f515ce 100644
Binary files a/docs/images/casual-dired-screenshot.png and
b/docs/images/casual-dired-screenshot.png differ
diff --git a/docs/images/casual-elisp-edebug-screenshot.png
b/docs/images/casual-elisp-edebug-screenshot.png
index 9187e567ad..86416b1abd 100644
Binary files a/docs/images/casual-elisp-edebug-screenshot.png and
b/docs/images/casual-elisp-edebug-screenshot.png differ
diff --git a/docs/images/casual-elisp-screenshot.png
b/docs/images/casual-elisp-screenshot.png
index cf2c92c7e5..aa03de2f80 100644
Binary files a/docs/images/casual-elisp-screenshot.png and
b/docs/images/casual-elisp-screenshot.png differ
diff --git a/docs/images/casual-elisp-unicode-screenshot.png
b/docs/images/casual-elisp-unicode-screenshot.png
new file mode 100644
index 0000000000..62a89756f6
Binary files /dev/null and b/docs/images/casual-elisp-unicode-screenshot.png
differ
diff --git a/docs/images/casual-eshell-process-screenshot.png
b/docs/images/casual-eshell-process-screenshot.png
index 716cd9973e..aa47488475 100644
Binary files a/docs/images/casual-eshell-process-screenshot.png and
b/docs/images/casual-eshell-process-screenshot.png differ
diff --git a/docs/images/casual-eshell-screenshot.png
b/docs/images/casual-eshell-screenshot.png
index 869ab25901..034c16e9cb 100644
Binary files a/docs/images/casual-eshell-screenshot.png and
b/docs/images/casual-eshell-screenshot.png differ
diff --git a/docs/images/casual-eshell-unicode-screenshot.png
b/docs/images/casual-eshell-unicode-screenshot.png
new file mode 100644
index 0000000000..04d839aa1f
Binary files /dev/null and b/docs/images/casual-eshell-unicode-screenshot.png
differ
diff --git a/lisp/casual-dired.el b/lisp/casual-dired.el
index 6a0ce8192d..e7f854d917 100644
--- a/lisp/casual-dired.el
+++ b/lisp/casual-dired.el
@@ -1,6 +1,6 @@
;;; casual-dired.el --- Transient UI for Dired -*- lexical-binding: t; -*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -50,6 +50,7 @@
;;;###autoload (autoload 'casual-dired-tmenu "casual-dired" nil t)
(transient-define-prefix casual-dired-tmenu ()
"Transient menu for Dired."
+ :refresh-suffixes t
[["File"
("o" "Open Other" dired-find-file-other-window :transient nil)
("v" "View" dired-view-file)
@@ -87,7 +88,9 @@
("$" "Hide/Unhide Subdir" dired-hide-subdir
:if-not casual-dired-lisp-dired-buffer-p
:transient t)
- ("k" "Kill (Hide) Line(s)" dired-do-kill-lines :transient t)
+ ("k" "Kill (Hide) Line(s)" dired-do-kill-lines
+ :description (lambda () (if prefix-arg "Kill Subdir" "Kill (Hide)
Line(s)✦"))
+ :transient t)
("g" "Revert" revert-buffer :transient t)
("f" "Filter by name…" casual-dired-find-dired-regexp)
("E" "Edit (wdired)" wdired-change-to-wdired-mode)
diff --git a/lisp/casual-elisp.el b/lisp/casual-elisp.el
index cdee46fdde..e536ebef30 100644
--- a/lisp/casual-elisp.el
+++ b/lisp/casual-elisp.el
@@ -1,6 +1,6 @@
;;; casual-elisp.el --- Transient UI for Elisp Mode -*- lexical-binding: t; -*-
-;; Copyright (C) 2025 Charles Choi
+;; Copyright (C) 2025-2026 Charles Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -45,7 +45,7 @@
("L" "Buffer or Region" elisp-eval-region-or-buffer
:description (lambda () (if (use-region-p) "Region" "Buffer")))
("d" "Defun" eval-defun
- :description (lambda () (if prefix-arg "Edebugⁿ" "Defunⁿ")))]
+ :description (lambda () (if prefix-arg "Edebug" "Defun✦")))]
["Xref"
("." "Definition" xref-find-definitions)
diff --git a/lisp/casual-eshell.el b/lisp/casual-eshell.el
index af3cf19e60..5c39f4df94 100644
--- a/lisp/casual-eshell.el
+++ b/lisp/casual-eshell.el
@@ -1,6 +1,6 @@
;;; casual-eshell.el --- Transient UI for Eshell -*- lexical-binding: t; -*-
-;; Copyright (C) 2025 Charles Y. Choi
+;; Copyright (C) 2025-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -83,9 +83,9 @@
("s" "Show" eshell-show-output)
("." "Show Max" eshell-show-maximum-output)
("m" "Mark" eshell-mark-output
- :description (lambda () (if prefix-arg "Narrow" "Markⁿ")))
+ :description (lambda () (if prefix-arg "Narrow" "Mark✦")))
("D" "Delete" eshell-delete-output
- :description (lambda () (if prefix-arg "Kill" "Deleteⁿ")))]
+ :description (lambda () (if prefix-arg "Kill" "Delete✦")))]
["Output"
:if buffer-narrowed-p
