branch: elpa/casual
commit af3075a929bc0e010b50ecc69bf096231ccf325c
Merge: 350a6a9f19 06084eb287
Author: Charles Choi <[email protected]>
Commit: GitHub <[email protected]>
Merge pull request #378 from
kickingvegas/merge-development-to-main-20260204_120251
Merge development to main 20260204_120251
---
docs/agenda.org | 12 +-
docs/bibtex.org | 11 +-
docs/bookmarks.org | 22 ++--
docs/calendar.org | 58 +++++----
docs/casual.info | Bin 153025 -> 164640 bytes
docs/casual.org | 18 ++-
docs/compile.org | 4 +
docs/css.org | 5 +-
docs/csv.org | 8 +-
docs/dired.org | 21 +++-
docs/ediff.org | 8 ++
docs/editkit.org | 83 ++++++++-----
docs/elisp.org | 10 ++
docs/eshell.org | 16 +++
docs/eww.org | 6 +-
docs/help.org | 10 +-
docs/html.org | 6 +-
docs/ibuffer.org | 15 +--
docs/image.org | 14 ++-
docs/images/casual-calendar-calendars-menu.png | Bin 113360 -> 57952 bytes
docs/images/casual-calendar-diary-menu.png | Bin 106320 -> 43640 bytes
docs/images/casual-calendar-lunar-menu.png | Bin 149101 -> 84023 bytes
docs/images/casual-calendar-main-unicode.png | Bin 0 -> 97376 bytes
docs/images/casual-calendar-screenshot.png | Bin 178673 -> 164472 bytes
docs/images/casual-calendar-settings-menu.png | Bin 84748 -> 82606 bytes
docs/images/casual-css-screenshot.png | Bin 107800 -> 77208 bytes
docs/images/casual-csv-align-screenshot.png | Bin 38846 -> 43704 bytes
docs/images/casual-csv-edit-screenshot.png | Bin 203137 -> 191363 bytes
docs/images/casual-csv-edit-unicode-screenshot.png | Bin 0 -> 81071 bytes
docs/images/casual-csv-view-screenshot.png | Bin 68512 -> 75710 bytes
docs/images/casual-csv-view-unicode-screenshot.png | Bin 63214 -> 0 bytes
.../images/casual-editkit-bookmarks-screenshot.png | Bin 43644 -> 41707 bytes
docs/images/casual-editkit-copy-screenshot.png | Bin 58221 -> 52327 bytes
docs/images/casual-editkit-delete-screenshot.png | Bin 59654 -> 61195 bytes
docs/images/casual-editkit-edit-screenshot.png | Bin 81867 -> 61503 bytes
.../casual-editkit-emoji-symbols-screenshot.png | Bin 73815 -> 73406 bytes
docs/images/casual-editkit-kill-screenshot.png | Bin 59883 -> 54663 bytes
docs/images/casual-editkit-macro-screenshot.png | Bin 55766 -> 52446 bytes
docs/images/casual-editkit-main-screenshot.png | Bin 124634 -> 176762 bytes
docs/images/casual-editkit-mark-screenshot.png | Bin 53557 -> 50084 bytes
docs/images/casual-editkit-move-screenshot.png | Bin 52523 -> 47608 bytes
.../images/casual-editkit-move-word-screenshot.png | Bin 0 -> 41545 bytes
docs/images/casual-editkit-narrow-screenshot.png | Bin 41152 -> 42008 bytes
docs/images/casual-editkit-open-screenshot.png | Bin 65528 -> 61020 bytes
docs/images/casual-editkit-project-screenshot.png | Bin 82356 -> 81605 bytes
.../images/casual-editkit-rectangle-screenshot.png | Bin 67405 -> 62407 bytes
docs/images/casual-editkit-reformat-screenshot.png | Bin 81550 -> 73743 bytes
.../images/casual-editkit-registers-screenshot.png | Bin 63315 -> 60766 bytes
docs/images/casual-editkit-search-screenshot.png | Bin 66902 -> 62291 bytes
docs/images/casual-editkit-settings-screenshot.png | Bin 95293 -> 93073 bytes
docs/images/casual-editkit-sort-screenshot.png | Bin 58316 -> 53228 bytes
docs/images/casual-editkit-tools-screenshot.png | Bin 75767 -> 71797 bytes
.../images/casual-editkit-transform-screenshot.png | Bin 55286 -> 52601 bytes
.../images/casual-editkit-transpose-screenshot.png | Bin 59600 -> 55869 bytes
.../casual-editkit-window-delete-screenshot.png | Bin 40653 -> 38557 bytes
docs/images/casual-editkit-window-screenshot.png | Bin 75543 -> 71477 bytes
.../casual-editkit-window-unicode-screenshot.png | Bin 58958 -> 53308 bytes
docs/images/casual-elisp-edebug-screenshot.png | Bin 73348 -> 88055 bytes
docs/images/casual-elisp-screenshot.png | Bin 174559 -> 174599 bytes
docs/images/casual-elisp-unicode-screenshot.png | Bin 83544 -> 83620 bytes
docs/images/casual-html-screenshot.png | Bin 169002 -> 143003 bytes
docs/images/casual-html-settings-screenshot.png | Bin 159704 -> 46934 bytes
docs/images/casual-html-tags-screenshot.png | Bin 170992 -> 84530 bytes
docs/images/casual-html-unicode-screenshot.png | Bin 0 -> 58870 bytes
docs/images/casual-image-main-screenshot.png | Bin 603038 -> 447132 bytes
.../casual-image-main-unicode-screenshot.png | Bin 0 -> 99841 bytes
docs/images/casual-image-resize-screenshot.png | Bin 56993 -> 58422 bytes
docs/images/casual-isearch-settings-tmenu.png | Bin 0 -> 58875 bytes
docs/images/casual-isearch-tmenu.png | Bin 158657 -> 172808 bytes
docs/images/casual-isearch-unicode.png | Bin 0 -> 110716 bytes
.../casual-make-automatic-variables-screenshot.png | Bin 89880 -> 98088 bytes
docs/images/casual-make-mode-select-screenshot.png | Bin 42866 -> 43938 bytes
docs/images/casual-make-screenshot.png | Bin 110666 -> 78823 bytes
docs/info.org | 1 +
docs/isearch.org | 20 ++++
docs/make-mode.org | 4 +
docs/man.org | 4 +
docs/re-builder.org | 17 +--
docs/timezone.org | 12 +-
lisp/casual-calc-variables.el | 31 ++---
lisp/casual-calendar-constants.el | 4 +-
lisp/casual-calendar-settings.el | 10 +-
lisp/casual-calendar-utils.el | 6 +-
lisp/casual-calendar.el | 12 +-
lisp/casual-css-settings.el | 2 +-
lisp/casual-css.el | 2 +-
lisp/casual-csv-utils.el | 4 +-
lisp/casual-csv.el | 7 +-
lisp/casual-editkit-constants.el | 17 ++-
lisp/casual-editkit-settings.el | 9 +-
lisp/casual-editkit-utils.el | 133 +++++++++++----------
lisp/casual-editkit.el | 4 +-
lisp/casual-elisp.el | 4 +-
lisp/casual-help.el | 2 +-
lisp/casual-html.el | 4 +-
lisp/casual-image-utils.el | 3 +-
lisp/casual-image.el | 3 +-
lisp/casual-isearch-utils.el | 2 +-
lisp/casual-isearch.el | 2 +-
lisp/casual-lib.el | 2 +-
lisp/casual-make-utils.el | 10 +-
lisp/casual-make.el | 6 +-
lisp/casual-man-utils.el | 2 +-
lisp/casual.el | 2 +-
tests/test-casual-calc-variables.el | 37 +-----
tests/test-casual-editkit-constants.el | 33 ++++-
tests/test-casual-editkit-utils.el | 60 ++++++++++
107 files changed, 528 insertions(+), 270 deletions(-)
diff --git a/docs/agenda.org b/docs/agenda.org
index bf00099adb..00b7715094 100644
--- a/docs/agenda.org
+++ b/docs/agenda.org
@@ -40,24 +40,28 @@ The main menu for Casual Agenda is ~casual-agenda-tmenu~.
It is divided into fiv
- Utils :: Set a timer, get almanac info.
-#+TEXINFO: @subheading Operating on Headlines
+#+TEXINFO: @subheading Operating on Headlines (casual-agenda-operations-tmenu)
+#+VINDEX: casual-agenda-operations-tmenu
Use “{{{kbd(o)}}} Operations›” from ~casual-agenda-tmenu~ to change a
headline's attributes such as TODO state, scheduling, tags, and priority. The
following menu will be displayed.
[[file:images/casual-agenda-operations-screenshot.png]]
-#+TEXINFO: @subheading Marking Headlines
+#+TEXINFO: @subheading Marking Headlines (casual-agenda-mark-tmenu)
+#+VINDEX: casual-agenda-mark-tmenu
Use “{{{kbd(M)}}} Mark›” menu from ~casual-agenda-tmenu~ to mark different
headlines and perform a bulk action on them.
[[file:images/casual-agenda-mark-screenshot.png]]
-#+TEXINFO: @subheading Almanac
+#+TEXINFO: @subheading Almanac (casual-agenda-almanac-tmenu)
+#+VINDEX: casual-agenda-almanac-tmenu
Get sunrise/sunset times, lunar cycle dates, and holidays with respect to a
date via the “{{{kbd(l)}}} Almanac›” menu from ~casual-agenda-tmenu~.
[[file:images/casual-agenda-almanac-screenshot.png]]
#+TEXINFO: @subheading Changing Modes and Settings
+#+VINDEX: casual-agenda-settings-tmenu
Agenda views have different display modes and behavior that can be modified
from the “{{{kbd(\,)}}} Settings›” menu from ~casual-agenda-tmenu~.
[[file:images/casual-agenda-settings-screenshot.png]]
@@ -67,4 +71,4 @@ By enabling “{{{kbd(u)}}} Use Unicode Settings” from the
Settings menu, Casu
[[file:images/casual-agenda-unicode-screenshot.png]]
-
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/bibtex.org b/docs/bibtex.org
index 49f9f086d8..61bcaa8223 100644
--- a/docs/bibtex.org
+++ b/docs/bibtex.org
@@ -65,7 +65,7 @@ In your initialization file, bind the Transient
~casual-bibtex-tmenu~ to your ke
[[file:images/casual-bibtex-screenshot.png]]
-The main menu for Casual BibTeX is organized into the following sections:
+The main menu for Casual BibTeX (~casual-bibtex-tmenu~) is organized into the
following sections:
- Field :: Commands to edit or navigate fields within an entry.
- Entry :: Commands to edit or navigate entries within a BibTeX file.
@@ -144,11 +144,12 @@ The ability to search and jump to a position in a BibTeX
database are offered by
:CUSTOM_ID: bibtex-settings
:END:
#+CINDEX: BibTeX Settings
+#+VINDEX: casual-bibtex-settings-tmenu
[[file:images/casual-bibtex-settings-screenshot.png]]
-This menu offers access to commonly configured BibTeX mode settings.
+The menu ~casual-bibtex-settings-tmenu~ offers access to commonly configured
BibTeX mode settings.
Settings are organized into the following sections:
@@ -162,9 +163,11 @@ Settings are organized into the following sections:
By default BibTeX mode does not format (or "fill") an entry upon cleaning. To
support filling an entry upon clean, add the command ~bibtex-fill-entry~ to
~bibtex-clean-entry-hook~ using the “{{{kbd(C)}}} Clean” command as shown below:
[[file:images/casual-bibtex-clean-entry-hook.png]]
-
-#+TEXINFO: @subsubheading BibTeX Mode Unicode Symbol Support
+*** BibTeX Mode Unicode Symbol Support
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
BibTeX will use Unicode symbols as appropriate in its menus.
[[file:images/casual-bibtex-unicode-screenshot.png]]
+
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
+
diff --git a/docs/bookmarks.org b/docs/bookmarks.org
index 24e32827ab..0444c8ef04 100644
--- a/docs/bookmarks.org
+++ b/docs/bookmarks.org
@@ -47,7 +47,7 @@ While not necessary, having the current bookmark highlighted
is convenient. Enab
Finally, customize the variable ~bookmark-save-flag~ to the value ~1~ to
ensure that your bookmark changes are always saved.
-The above guidance largely extends the work done in the blog post
[[http://yummymelon.com/devnull/using-bookmarks-in-emacs-like-you-do-in-web-browsers.html][Using
Bookmarks in Emacs like you do in Web Browsers]].
+The above guidance largely extends the work done in the blog post
[[http://yummymelon.com/devnull/using-bookmarks-in-emacs-like-you-do-in-web-browsers.html][Using
Bookmarks in Emacs like you do in Web Browsers]].
** Bookmarks Usage
#+CINDEX: Bookmarks Usage
@@ -70,21 +70,15 @@ Casual Bookmarks organizes its main menu into the following
sections:
- Column :: Commands to navigate and control the display of the table layout
for bookmarks.
+#+TEXINFO: @subheading Sorting
+#+VINDEX: casual-bookmarks-sortby-tmenu
+
+Support for sorting the bookmarks list is provided by the menu
~casual-bookmarks-sortby-tmenu~.
+
#+TEXINFO: @subheading Unicode Symbol Support
[[file:images/casual-bookmarks-unicode-screenshot.png]]
-By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Bookmarks will use Unicode symbols as appropriate in its menus. The following
mapping is shown in the table below:
-
-| Name | Plain | Unicode |
-|----------------------+-----------+---------|
-| :previous | Previous | ↑ |
-| :next | Next | ↓ |
-| :jump | Jump | 🚀 |
-| :beginning-of-buffer | Beginning | ⤒ |
-| :end-of-buffer | End | ⤓ |
-| :backward | Backward | ← |
-| :forward | Forward | → |
-| :narrow | Narrow | →← |
-| :widen | Widen | ←→ |
+By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Bookmarks will use Unicode symbols as appropriate in its menus.
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/calendar.org b/docs/calendar.org
index cacc735f66..72f40f2d8c 100644
--- a/docs/calendar.org
+++ b/docs/calendar.org
@@ -24,7 +24,7 @@ The main menu for Casual Calendar (~casual-calendar-tmenu)~
is invoked by the co
[[file:images/casual-calendar-screenshot.png]]
-Whenever the ~calendar~ window (showing three months) is raised, the Casual
user interface is invoked via the command ~casual-calendar~. This command is
typically bound to a keybinding (e.g. {{{kbd(C-o)}}}).
+Whenever the ~calendar~ window (showing three months) is raised, the Casual
user interface is invoked via the command ~casual-calendar~. This command is
typically bound to a keybinding (e.g. {{{kbd(C-o)}}}).
Casual Calendar organizes its main menu into the following sections:
@@ -39,34 +39,48 @@ Casual Calendar organizes its main menu into the following
sections:
- Almanac :: Almanac-related commands such the lunar phase, sunrise/sunset
times are found here.
- Region :: Support for counting days defined in a region is offered here.
-
+
Also made available is access to a Settings menu (more below) and to the Info
documentation for ~calendar~.
*** Diary & Goto Menu
+#+VINDEX: casual-calendar-diary-and-goto-tmenu
-From the main menu, choosing “(D) Diary & Goto›” will present choices for
diary event insertion and to “goto” a particular date via different
specifications.
+From the main menu, choosing “{{{kbd(D)}}} Diary & Goto›” will present choices
for diary event insertion and to “goto” a particular date via different
specifications.
-[[file:images/casual-calendar-diary-menu.png]]
+[[file:images/casual-calendar-diary-menu.png]]
*** Calendar System Date Conversion
+#+VINDEX: casual-calendar-conversions-tmenu
+#+VINDEX: casual-calendar-lunar-tmenu
+#+VINDEX: casual-calendar-astro-tmenu
+#+VINDEX: casual-calendar-islamic-tmenu
+#+VINDEX: casual-calendar-hebrew-tmenu
+#+VINDEX: casual-calendar-bahai-tmenu
+#+VINDEX: casual-calendar-ethiopic-tmenu
+#+VINDEX: casual-calendar-french-tmenu
+#+VINDEX: casual-calendar-julian-tmenu
+#+VINDEX: casual-calendar-coptic-tmenu
+#+VINDEX: casual-calendar-persian-tmenu
+#+VINDEX: casual-calendar-mayan-tmenu
+
Calendar supports conversion of dates from Gregorian (default) to a number of
different calendar systems. Choose "(c) Conversions›" from the main menu to
select from a list of such calendars.
[[file:images/casual-calendar-calendars-menu.png]]
Supported calendar systems:
-- Astronomical
-- Bahá’í
-- Ethiopic
-- French Revolutionary
-- Hebrew
-- Islamic
-- Julian
-- Lunar (Chinese)
-- Mayan
-- Persian
+- Astronomical (~casual-calendar-astro-tmenu~)
+- Bahá’í (~casual-calendar-bahai-tmenu~)
+- Ethiopic (~casual-calendar-ethiopic-tmenu~)
+- French Revolutionary (~casual-calendar-french-tmenu~)
+- Hebrew (~casual-calendar-hebrew-tmenu~)
+- Islamic (~casual-calendar-islamic-tmenu~)
+- Julian (~casual-calendar-julian-tmenu~)
+- Lunar (Chinese) (~casual-calendar-lunar-tmenu~)
+- Mayan (~casual-calendar-mayan-tmenu~)
+- Persian (~casual-calendar-persian-tmenu~)
-Selecting a calendar system will raise a menu that offers date conversion
commands between it and the Gregorian system. In the screenshot below, the
Lunar (Chinese) calendar system menu is shown.
+Selecting a calendar system will raise a menu that offers date conversion
commands between it and the Gregorian system. In the screenshot below, the
Lunar (Chinese) calendar system menu is shown.
To convert a Gregorian date to Lunar (Chinese):
@@ -77,8 +91,7 @@ To convert a Lunar (Chinese) date to Gregorian:
1. Choose “(G) Goto…” and follow the prompts.
-
-[[file:images/casual-calendar-lunar-menu.png]]
+[[file:images/casual-calendar-lunar-menu.png]]
Certain non-Gregorian calendar systems are supported by the diary (Bahá’í,
Hebrew, Islamic, Lunar (Chinese)). For such systems, their menus will offer
choices to insert diary events.
@@ -87,10 +100,15 @@ Note that inserting non-Gregorian diary events require
configuration of the vari
Both of these variables can be configured from the Calendar Settings menu.
*** Calendar Settings Menu
-From the main menu, choosing “{{{kbd(\,)}}} Settings›” will provide a menu of
frequently configured calendar and diary-related variables.
+#+VINDEX: casual-calendar-settings-tmenu
-[[file:images/casual-calendar-settings-menu.png]]
+From the main menu, choosing “{{{kbd(\,)}}} Settings›” will provide a menu
(~casual-calendar-settings-tmenu~) of frequently configured calendar and
diary-related variables.
+
+[[file:images/casual-calendar-settings-menu.png]]
*** Calendar Unicode Symbol Support
-By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Calendar will use Unicode symbols as appropriate in its menus.
+By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Calendar will use Unicode symbols as appropriate in its menus.
+
+[[file:images/casual-calendar-main-unicode.png]]
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/casual.info b/docs/casual.info
index 67f0048aef..9d22640a80 100644
Binary files a/docs/casual.info and b/docs/casual.info differ
diff --git a/docs/casual.org b/docs/casual.org
index 351d21572a..ddf2e4b434 100644
--- a/docs/casual.org
+++ b/docs/casual.org
@@ -5,7 +5,7 @@
#+EMAIL: [email protected]
#+OPTIONS: ':t toc:t author:t email:t H:4 f:t
#+LANGUAGE: en
-#+MACRO: version 2.13.1
+#+MACRO: version 2.13.2-rc.1
#+MACRO: kbd (eval (org-texinfo-kbd-macro $1))
#+TEXINFO_FILENAME: casual.info
#+TEXINFO_CLASS: casual
@@ -195,16 +195,20 @@ For version 2.x going forward, I (Charles Choi) have
decided to not offer any do
That said, if you have used ~:ensure t~ to install a superseded package, you
/must/ remove that configuration. After doing so, please follow the above
instructions for installing ~casual~.
* UX Conventions
+:PROPERTIES:
+:CUSTOM_ID: ux-conventions
+:END:
#+CINDEX: UX Conventions
The Casual menus share common user experience (UX) conventions to facilitate
usability. This section details this.
#+TEXINFO: @subheading Common Menu Navigation
-Casual organizes a mode's command set into a menu hierarchy. As the user
descends down different menu levels, the user is given the option to dismiss
the current menu or to dismiss completely all menu levels descended. Transient
provides a standard convention for menu dismissal via the {{{kbd(C-g)}}}
(~transient-quit-one~) and {{{kbd(C-q)}}} (~transient-quit-all~) commands. By
default Transient does not display these commands in the menu though, rather
they make the assumption that the u [...]
+Casual organizes a mode's command set into a menu hierarchy. As the user
descends down different menu levels, the user is given the option to dismiss
the current menu or to dismiss completely all menu levels descended. Transient
provides a standard convention for menu dismissal via the {{{kbd(C-g)}}}
(~transient-quit-one~) and {{{kbd(C-q)}}} (~transient-quit-all~) commands.
+Casual makes explicit the display of {{{kbd(C-g)}}} and {{{kbd(C-q)}}} at the
bottom of its menus, which differs from the default behavior of Transient.
#+VINDEX: casual-lib-hide-navigation
-In contrast, Casual makes these bindings explicitly known to user by
displaying them at the bottom of the menu. Users who wish to have them hidden
can set the customizable variable ~casual-lib-hide-navigation~ to a non-nil
value. This can be changed from a Casual mode-specific settings menu.
+Users who wish to have them hidden can set the customizable variable
~casual-lib-hide-navigation~ to a non-nil value. This can be changed from a
Casual mode-specific settings menu.
#+TEXINFO: @subheading Settings Menu
@@ -248,7 +252,13 @@ 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 glyph ✦ (BLACK FOUR POINTED STAR), 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)}}}.
+- ‘ⓘ’ :: If the label starts with the glyph ⓘ (CIRCLED LATIN SMALL LETTER I),
then the command will invoke the Info reader.
+
+
+#+TEXINFO: @subheading Menu Naming Conventions
+
+To distinguish Transient menu (prefix) definitions from existing Emacs menu
definitions using keymaps ([[info:elisp#Menu Keymaps][elisp#Menu Keymaps]]),
Casual uses the naming suffix ~-tmenu~.
* Casual Modes
#+CINDEX: Casual Modes
diff --git a/docs/compile.org b/docs/compile.org
index 44cfce36bb..a327ce7a9e 100644
--- a/docs/compile.org
+++ b/docs/compile.org
@@ -77,9 +77,13 @@ The following sections are offered in the menu:
If the output window is from a Grep command, ~casual-compile-tmenu~ will
adjust its labels accordingly as shown below.
[[file:images/casual-compile-grep-screenshot.png]]
+#+TEXINFO: @subheading Compile Settings
+#+VINDEX: casual-compile-settings-tmenu
+The menu ~casual-compile-settings-tmenu~ provides access to different
~compilation-mode~ settings.
#+TEXINFO: @subheading Compile Mode Unicode Symbol Support
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Compile will use Unicode symbols as appropriate in its menus.
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/css.org b/docs/css.org
index 6de3c72ee1..8d77f0fb06 100644
--- a/docs/css.org
+++ b/docs/css.org
@@ -46,8 +46,7 @@ The following sections are offered in the menu:
#+TEXINFO: @subheading CSS Settings
#+VINDEX: casual-css-settings-tmenu
-Settings menu for Casual CSS.
-
+The menu ~casual-css-settings-tmenu~ provides access to different ~css-mode~
settings.
[[file:images/casual-css-settings-screenshot.png]]
@@ -55,3 +54,5 @@ Settings menu for Casual CSS.
#+TEXINFO: @subheading CSS Unicode Symbol Support
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
CSS will use Unicode symbols as appropriate in its menus.
+
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/csv.org b/docs/csv.org
index 26dcc84688..c016f622b4 100644
--- a/docs/csv.org
+++ b/docs/csv.org
@@ -60,7 +60,7 @@ If the buffer is editable, a common to desire to instead work
on a copy of the C
#+TEXINFO: @subheading CSV Align
#+VINDEX: casual-csv-align-tmenu
-The display of the CSV buffer can be controlled with this menu.
+The display of the CSV buffer can be controlled with the menu
~casual-csv-align-tmenu~.
[[file:images/casual-csv-align-screenshot.png]]
@@ -68,6 +68,8 @@ The display of the CSV buffer can be controlled with this
menu.
#+TEXINFO: @subheading CSV Settings
#+VINDEX: casual-csv-settings-tmenu
+The menu ~casual-csv-settings-tmenu~ provides access to different ~csv-mode~
settings.
+
[[file:images/casual-csv-settings-screenshot.png]]
@@ -75,6 +77,6 @@ The display of the CSV buffer can be controlled with this
menu.
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
CSV will use Unicode symbols as appropriate in its menus.
-[[file:images/casual-csv-view-unicode-screenshot.png]]
-
+[[file:images/casual-csv-edit-unicode-screenshot.png]]
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/dired.org b/docs/dired.org
index c70b4f1f50..c39c3df619 100644
--- a/docs/dired.org
+++ b/docs/dired.org
@@ -146,7 +146,7 @@ With the *Sort By* menu raised, one can save the switch
settings for future use
#+CINDEX: Dired Search & Replace
#+VINDEX: casual-dired-search-replace-tmenu
-Search and replace in multiple marked files using the “{{{kbd(/)}}} Search &
Replace›” menu item in ~casual-dired-tmenu~. This will raise a menu of Dired
commands that will work on marked files.
+Search and replace in multiple marked files using the “{{{kbd(/)}}} Search &
Replace›” menu (~casual-dired-search-replace-tmenu~) in ~casual-dired-tmenu~.
This will raise a menu of Dired commands that will work on marked files.
[[file:images/casual-dired-search-replace.png]]
@@ -158,15 +158,28 @@ While most Dired commands use Emacs-style regular
expression syntax ([[info:elis
The *grep*-style syntax is dependent on the ~grep~ implementation that is
installed and used by Emacs.
*** Bulk Dired Operations
-Casual Dired organizes a number of Dired commands that work on a set of marked
files. These commands are presented in the “{{{kbd(#)}}} Utils›” menu in
~casual-dired-tmenu~.
+#+VINDEX: casual-dired-utils-tmenu
+
+Casual Dired organizes a number of Dired commands that work on a set of marked
files. These commands are presented in the “{{{kbd(#)}}} Utils›” menu
(~casual-dired-utils-tmenu~) in ~casual-dired-tmenu~.
[[file:images/casual-dired-utils-screenshot.png]]
*** Dired Link
-Create symbolic and hard links via the “{{{kbd(l)}}} Link›” menu in
~casual-dired-tmenu~. Both absolute and relative symbolic links (symlinks) are
supported.
+#+VINDEX: casual-dired-link-tmenu
+
+Create symbolic and hard links via the “{{{kbd(l)}}} Link›” menu
(~casual-dired-link-tmenu~) in ~casual-dired-tmenu~. Both absolute and relative
symbolic links (symlinks) are supported.
[[file:images/casual-dired-link.png]]
+
+*** Dired Elisp
+#+VINDEX: casual-dired-elisp-tmenu
+
+Support for running bulk commands for Elisp development are provided by the
menu ~casual-dired-elisp-tmenu~.
+
+# TODO: Insert screenshot
+
+
*** Dired Unicode Symbol Support
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Dired will use Unicode symbols as appropriate in its menus. An example is shown
below.
@@ -175,3 +188,5 @@ By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the
Settings menu, Casua
To ensure proper layout and spacing, your default typeface should be
fixed-width or monospace and *must* support the Unicode symbols used.
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
+
diff --git a/docs/ediff.org b/docs/ediff.org
index 19b9ae9c24..f864630ed8 100644
--- a/docs/ediff.org
+++ b/docs/ediff.org
@@ -108,6 +108,14 @@ Magit offers a means of invoking Ediff to resolve a merge
conflict via the {{{kb
Calling ~casual-ediff-tmenu~ will show the menu shown above. Note that in the
C section, there are commands to merge both the variant A and variant B diffs
using the bindings {{{kbd(mab)}}} or {{{kbd(mba)}}}, depending on the desired
order the diffs are to be merged.
+*** Ediff Settings
+#+VINDEX: casual-ediff-settings-tmenu
+
+The menu ~casual-ediff-settings-tmenu~ provides access to different
~ediff-mode~ settings.
+
+# TODO: Insert screenshot
+
*** Ediff Unicode Symbol Support
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Ediff will use Unicode symbols as appropriate in its menus.
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/editkit.org b/docs/editkit.org
index c5335465a5..25dd43c6e3 100644
--- a/docs/editkit.org
+++ b/docs/editkit.org
@@ -23,8 +23,14 @@ A reference menu (~casual-editkit-main-tmenu~) illustrating
nearly all the diffe
(keymap-global-set "C-o" #'casual-editkit-main-tmenu)
#+end_src
-For motivated users desiring a bespoke solution, it is recommended that they
use Casual EditKit as a library of menus to build their own workflows.
+Also suggested is to globally bind the window and rectangle menus as shown
below.
+
+#+begin_src elisp :lexical no
+ (keymap-global-set "C-c w" #'casual-editkit-windows-tmenu)
+ (keymap-global-set "C-c r" #'casual-editkit-rectangle-tmenu)
+#+end_src
+For motivated users desiring a bespoke solution, it is recommended that they
use Casual EditKit as a library of menus to build their own workflows.
** EditKit Usage
#+CINDEX: EditKit Usage
@@ -62,27 +68,28 @@ Register commands for saving and recalling text, point,
window configuration, an
#+CINDEX: Edit Commands
#+VINDEX: casual-editkit-edit-tmenu
-This menu contains commands and sub-menus related to editing text.
+The menu ~casual-editkit-edit-tmenu~ contains commands and sub-menus related
to editing text.
[[file:images/casual-editkit-edit-screenshot.png]]
Depending on the buffer mode, text can be operated on with different
granularity as words, sentences, paragraphs, balanced expressions, functions
(defuns). The following sub-menus illustrate what operations can be done on the
different text granularity.
-#+TEXINFO: @subheading Mark›
+#+TEXINFO: @subheading Mark› (casual-editkit-mark-tmenu)
#+CINDEX: Mark commands
#+VINDEX: casual-editkit-mark-tmenu
-Text can be marked with different granularity with this menu. Note that
marking functions (Defun) is only supported for modes derived from ~prog-mode~.
+
+Text can be marked with different granularity with this menu. Note that the
menu item “{{{kbd(d)}}} Defun” is only supported for modes derived from
~prog-mode~.
[[file:images/casual-editkit-mark-screenshot.png]]
-#+TEXINFO: @subheading Copy›
+#+TEXINFO: @subheading Copy› (casual-editkit-copy-tmenu)
#+CINDEX: Copy commands
#+VINDEX: casual-editkit-copy-tmenu
Text can be copied with different granularity with this menu.
[[file:images/casual-editkit-copy-screenshot.png]]
-#+TEXINFO: @subheading Kill (Cut)›
+#+TEXINFO: @subheading Kill (Cut)› (casual-editkit-kill-tmenu)
#+CINDEX: Kill commands
#+CINDEX: Cut commands
#+VINDEX: casual-editkit-kill-tmenu
@@ -90,42 +97,52 @@ Text can be cut (killed) with different granularity with
this menu.
[[file:images/casual-editkit-kill-screenshot.png]]
-#+TEXINFO: @subheading Move›
+#+TEXINFO: @subheading Move› (casual-editkit-move-tmenu)
#+CINDEX: Move commands
#+VINDEX: casual-editkit-move-tmenu
+#+VINDEX: casual-editkit-move-word-tmenu
+#+VINDEX: casual-editkit-move-sentence-tmenu
+#+VINDEX: casual-editkit-move-sexp-tmenu
+
Text can be moved forwards or backwards with different granularity with this
menu. Note that selecting a granularity will raise another menu to allow
selection of direction (forward, backward) the text is to be moved. To enable
repeat operation, that menu is persisted and must be dismissed either with
either ~C-q~ (dismiss all) or ~C-g~ (dismiss to previous menu).
[[file:images/casual-editkit-move-screenshot.png]]
-#+TEXINFO: @subheading Transpose›
+If “{{{kbd(w)}}} Word›” is selected, then the following menu
~casual-editkit-move-word-tmenu~ is displayed.
+
+[[file:images/casual-editkit-move-word-screenshot.png]]
+
+Similar menus for moving a sentence (~casual-editkit-move-sentence-tmenu~) and
balanced expression (~casual-editkit-move-sexp-tmenu~) are available.
+
+#+TEXINFO: @subheading Transpose› (casual-editkit-transpose-tmenu)
#+CINDEX: Transpose commands
#+VINDEX: casual-editkit-transpose-tmenu
Text can be transposed with different granularity with this menu.
[[file:images/casual-editkit-transpose-screenshot.png]]
-#+TEXINFO: @subheading Transform›
+#+TEXINFO: @subheading Transform› (casual-editkit-transform-tmenu)
#+CINDEX: Transform commands
#+VINDEX: casual-editkit-transform-tmenu
Text can be transformed with different granularity with this menu. Supported
transformations are capitalization, lower and upper casing of text.
[[file:images/casual-editkit-transform-screenshot.png]]
-#+TEXINFO: @subheading Delete›
+#+TEXINFO: @subheading Delete› (casual-editkit-delete-tmenu)
#+CINDEX: Delete commands
#+VINDEX: casual-editkit-delete-tmenu
Operations involving text deletion are included in this menu, including
joining lines and zapping to a character.
[[file:images/casual-editkit-delete-screenshot.png]]
-#+TEXINFO: @subheading Sort›
+#+TEXINFO: @subheading Sort› (casual-editkit-sort-tmenu)
#+CINDEX: Sort commands
#+VINDEX: casual-editkit-sort-tmenu
Sorting operations on different sections of text are supported, as well as
support for sorting off a field. Press ~?~ or ~C-h~ to get help for a specific
command.
[[file:images/casual-editkit-sort-screenshot.png]]
-#+TEXINFO: @subheading Reformat›
+#+TEXINFO: @subheading Reformat› (casual-editkit-reformat-tmenu)
#+CINDEX: Reformat commands
#+VINDEX: casual-editkit-reformat-tmenu
Commands to reformat text such as filling, centering, and repunctuating
sentences are provided here. Press ~?~ or ~C-h~ to get help for a specific
command.
@@ -133,7 +150,7 @@ Commands to reformat text such as filling, centering, and
repunctuating sentence
[[file:images/casual-editkit-reformat-screenshot.png]]
-#+TEXINFO: @subheading Rectangle›
+#+TEXINFO: @subheading Rectangle› (casual-editkit-rectangle-tmenu)
#+CINDEX: Rectangle commands
#+VINDEX: casual-editkit-rectangle-tmenu
@@ -141,50 +158,62 @@ This menu offers all the rectangle commands. It is
packaged as a sub-menu of ~ca
[[file:images/casual-editkit-rectangle-screenshot.png]]
+Users wishing more direct access to this menu can bind
~casual-editkit-rectangle-tmenu~ as shown in the [[#editkit-install][install
section]].
+
*** Window management
#+CINDEX: Window management
-#+VINDEX: casual-editkit-window-tmenu
-This menu provides support for different Emacs window management commands.
Note that in Emacs, a window ([[info:elisp#Basic Windows]]) is defined
differently than its usage in contemporary graphical user interfaces.
+#+VINDEX: casual-editkit-windows-tmenu
+The menu ~casual-editkit-windows-tmenu~ provides support for different Emacs
window management commands. Note that in Emacs, a window ([[info:elisp#Basic
Windows]]) is defined differently than its usage in contemporary graphical user
interfaces.
[[file:images/casual-editkit-window-screenshot.png]]
-If the variable ~casual-lib-use-unicode~ is set to ~t~, then Unicode symbols
are used in the labels.
+Note that the section “Transpose” is only available if the package
[[https://melpa.org/#/transpose-frame][transpose-frame]] is installed.
+
+Users wishing more direct access to this menu can bind
~casual-editkit-windows-tmenu~ as shown in the [[#editkit-install][install
section]].
-[[file:images/casual-editkit-window-unicode-screenshot.png]]
#+TEXINFO: @subheading Window Deletion
#+CINDEX: Window deletion
#+VINDEX: casual-editkit-window-delete-tmenu
-This menu provides support for deleting windows.
+
+This menu provides support for deleting windows. Note the commands apply to
other windows, not the current one in focus.
[[file:images/casual-editkit-window-delete-screenshot.png]]
+#+TEXINFO: @subheading Window Menu Unicode Symbol Support
+
+If the variable ~casual-lib-use-unicode~ is set to ~t~, then Unicode symbols
are used in the labels.
+
+[[file:images/casual-editkit-window-unicode-screenshot.png]]
+
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
+
*** Search & Replace commands
#+CINDEX: Search & Replace commands
#+VINDEX: casual-editkit-search-tmenu
-Operations related to search and replace are captured by this menu. Note that
this menu uses Transient prefix arguments (~--backward~ and ~--regexp~). This
is because some commands have variants involving direction and whether to
search using a regexp. Commands that support direction will by default operate
forward of the current point if ~--backward~ is not enabled.
+Operations related to search and replace are captured by the menu
~casual-editkit-search-tmenu~. Note that this menu uses Transient prefix
arguments (~--backward~ and ~--regexp~). This is because some commands have
variants involving direction and whether to search using a regexp. Commands
that support direction will by default operate forward of the current point if
~--backward~ is not enabled.
[[file:images/casual-editkit-search-screenshot.png]]
*** Open commands
#+CINDEX: Open commands
#+VINDEX: casual-editkit-open-tmenu
-Commands related to opening a file (either for writing or read-only) are
supported here. Included are commands for visiting and renaming a file or
buffer. The *Project* sub-menu is also offered here.
+Commands related to opening a file (either for writing or read-only) are
supported by the menu ~casual-editkit-open-tmenu~. Included are commands for
visiting and renaming a file or buffer. The *Project* sub-menu is also offered
here.
[[file:images/casual-editkit-open-screenshot.png]]
*** Project commands
#+CINDEX: Project commands
#+VINDEX: casual-editkit-project-tmenu
-Project-related commands are listed in this menu.
+Project-related commands are listed in the menu ~casual-editkit-project-tmenu~.
[[file:images/casual-editkit-project-screenshot.png]]
*** Bookmark commands
#+CINDEX: Bookmark commands
#+VINDEX: casual-editkit-bookmarks-tmenu
-Commands edit, add, or jump to a bookmark are captured in this menu.
+Commands edit, add, or jump to a bookmark are captured in the menu
~casual-editkit-bookmarks-tmenu~.
[[file:images/casual-editkit-bookmarks-screenshot.png]]
@@ -192,21 +221,21 @@ Commands edit, add, or jump to a bookmark are captured in
this menu.
#+CINDEX: Emoji & Symbols
#+VINDEX: casual-editkit-emoji-symbol-tmenu
-Insert emoji and symbol characters with this menu. Smart quotes are also
supported by this menu and can be applied to a text region. This menu also
offers the command ~electric-quote-mode~ which is bound to {{{kbd(Q)}}}.
+Insert emoji and symbol characters with the menu
~casual-editkit-emoji-symbol-tmenu~. Smart quotes are also supported by this
menu and can be applied to a text region. This menu also offers the command
~electric-quote-mode~ which is bound to {{{kbd(Q)}}}.
[[file:images/casual-editkit-emoji-symbols-screenshot.png]]
*** Tool commands
#+CINDEX: Tool commands
#+VINDEX: casual-editkit-tools-tmenu
-This menu holds an assorted collection of different tools/utilities provided
by Emacs. Motivated users can use this Transient prefix as starting point to
create a menu customized to their needs.
+The menu ~casual-editkit-tools-tmenu~ holds an assorted collection of
different tools/utilities provided by Emacs. Motivated users can use this
Transient prefix as starting point to create a menu customized to their needs.
[[file:images/casual-editkit-tools-screenshot.png]]
*** Narrow/Widen Commands
#+CINDEX: Narrow/Widen Commands
#+VINDEX: casual-editkit-narrow-tmenu
-Support for narrowing and widening ([[info:emacs#Narrowing]]) a buffer is
supported. Mode specific narrowing behavior is supported for Org and
~prog-mode~ derived buffers.
+Support for narrowing and widening ([[info:emacs#Narrowing]]) a buffer is
supported by the menu ~casual-editkit-narrow-tmenu~. Mode specific narrowing
behavior is supported for Org and ~prog-mode~ derived buffers.
[[file:images/casual-editkit-narrow-screenshot.png]]
@@ -224,14 +253,14 @@ This menu can be modified ([[info:transient#Modifying
Existing Transients]]) to
*** Macro
#+CINDEX: Macro commands
#+VINDEX: casual-editkit-macro-tmenu
-Commands for managing macros are provided for by this menu. Note that macro
creation commands are /not/ supported as they are tightly-bound to keybindings.
+Commands for managing macros are provided for by the menu
~casual-editkit-macro-tmenu~. Note that macro creation commands are /not/
supported as they are tightly-bound to keybindings.
[[file:images/casual-editkit-macro-screenshot.png]]
*** EditKit Settings
#+CINDEX: EditKit Settings
#+VINDEX: casual-editkit-settings-tmenu
-Configuration of common editing-related settings are provided here. Most all
settings are set via the ~customize-variable~ interface with the following
exceptions for:
+Configuration of common editing-related settings are provided by the menu
~casual-editkit-settings-tmenu~. Most all settings are set via the
~customize-variable~ interface with the following exceptions for:
- “Auto-fill Mode (~auto-fill-mode~)”
- “Indent Tabs Mode (~indent-tabs-mode~)”
diff --git a/docs/elisp.org b/docs/elisp.org
index 943b808121..2c86e37551 100644
--- a/docs/elisp.org
+++ b/docs/elisp.org
@@ -49,8 +49,18 @@ Using the command prefix {{{kbd(C-u)}}} when
~casual-elisp-tmenu~ is raised will
[[file:images/casual-elisp-edebug-screenshot.png]]
+
+#+TEXINFO: @subheading Elisp Settings
+#+VINDEX: casual-elisp-settings-tmenu
+
+The menu ~casual-elisp-settings-tmenu~ provides access to different
~emacs-lisp-mode~ settings.
+
+# TODO: Insert screenshot
+
#+TEXINFO: @subheading Elisp Unicode Symbol Support
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]]
+
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/eshell.org b/docs/eshell.org
index 9b28f51c86..b677b9d01b 100644
--- a/docs/eshell.org
+++ b/docs/eshell.org
@@ -37,6 +37,21 @@ The following sections are offered in the menu:
[[file:images/casual-eshell-process-screenshot.png]]
+
+#+TEXINFO: @subheading Eshell Settings
+#+VINDEX: casual-eshell-settings-tmenu
+
+The menu ~casual-eshell-settings-tmenu~ provides access to different
~eshell-mode~ settings.
+
+# TODO: Insert screenshot
+
+#+TEXINFO: @subheading Eshell Info
+#+VINDEX: casual-eshell-info-tmenu
+
+The menu ~casual-eshell-info-tmenu~ provides access to different ~eshell-mode~
documentation in its Info manual.
+
+# TODO: Insert screenshot
+
#+TEXINFO: @subheading Eshell Unicode Symbol Support
@@ -46,3 +61,4 @@ By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the
Settings menu, Casua
[[file:images/casual-eshell-unicode-screenshot.png]]
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/eww.org b/docs/eww.org
index f152ae9f4e..6eddffa2ab 100644
--- a/docs/eww.org
+++ b/docs/eww.org
@@ -83,7 +83,7 @@ Customize common EWW settings from this menu. These settings
can be persisted to
#+TEXINFO: @subheading EWW Display
#+VINDEX: casual-eww-display-tmenu
-This menu (~casual-eww-display-tmenu~) provides commands to toggle different
display attributes of a web page.
+The menu ~casual-eww-display-tmenu~ provides commands to toggle different
display attributes of a web page.
[[file:images/casual-eww-display-screenshot.png]]
@@ -91,7 +91,7 @@ This menu (~casual-eww-display-tmenu~) provides commands to
toggle different dis
#+TEXINFO: @subheading EWW Bookmarks
#+VINDEX: casual-eww-bookmarks-tmenu
-This menu (~casual-eww-bookmarks-tmenu~) provides commands for managing the
EWW bookmark list.
+The menu ~casual-eww-bookmarks-tmenu~ provides commands for managing the EWW
bookmark list.
[[file:images/casual-eww-bookmarks-screenshot.png]]
@@ -102,3 +102,5 @@ Note that the EWW bookmarks list has a very limited feature
set.
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
EWW will use Unicode symbols as appropriate in its menus.
[[file:images/casual-eww-unicode-screenshot.png]]
+
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/help.org b/docs/help.org
index e950ba7206..a73ec6075a 100644
--- a/docs/help.org
+++ b/docs/help.org
@@ -56,8 +56,16 @@ The following sections are offered in the menu:
- Describe :: Get help for different Elisp types.
- Info :: If available, then open this help topic in [[file:info.org][Info]].
- Source :: Show the Elisp source. If the help displayed is for a customizable
variable, then show a customize menu item.
+
+#+TEXINFO: @subheading Help Mode Settings
+#+VINDEX: casual-help-settings-tmenu
+
+The menu ~casual-help-settings-tmenu~ provides access to different ~help-mode~
settings.
+
+# TODO: Insert screenshot
#+TEXINFO: @subheading Help Mode Unicode Symbol Support
-By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Man will use Unicode symbols as appropriate in its menus.
+By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Help will use Unicode symbols as appropriate in its menus.
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/html.org b/docs/html.org
index 1188573f1f..7eec33e1e6 100644
--- a/docs/html.org
+++ b/docs/html.org
@@ -59,7 +59,7 @@ This menu provides support for HTML tag-related commands
provided by ~html-mode~
#+TEXINFO: @subheading HTML Settings
#+VINDEX: casual-html-settings-tmenu
-SGML/HTML mode related settings can be customized here.
+SGML/HTML mode related settings can be customized using the menu
~casual-html-settings-tmenu~.
[[file:images/casual-html-settings-screenshot.png]]
@@ -67,3 +67,7 @@ SGML/HTML mode related settings can be customized here.
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
html will use Unicode symbols as appropriate in its menus.
+[[file:images/casual-html-unicode-screenshot.png]]
+
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
+
diff --git a/docs/ibuffer.org b/docs/ibuffer.org
index c7acf7f46f..f6f5b9930a 100644
--- a/docs/ibuffer.org
+++ b/docs/ibuffer.org
@@ -83,6 +83,8 @@ Note that the menu item “{{{kbd(RET)}}} Visit/Toggle” has "do
what I mean"
As with other Casual user interfaces, the ability to jump to a bookmark is
available.
+# TODO: Need to add operations, mark, mark-regexp tmenus
+
*** IBuffer Filtering
#+VINDEX: casual-ibuffer-filter-tmenu
@@ -168,18 +170,11 @@ Out of the box, it is best to think of the IBuffer
commands for editing buffer f
[[file:images/casual-ibuffer-sortby-screenshot.png]]
-The buffer list can be sorted using different criteria as shown in the
screenshot above.
+The buffer list can be sorted using different criteria using the menu
~casual-ibuffer-sortby-tmenu~.
Sort ordering can be reversed via the /Invert/ command.
*** IBuffer Unicode Symbol Support
-By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
IBuffer will use Unicode symbols as appropriate in its menus. The following
mapping is shown in the table below:
-
-| Name | Plain | Unicode |
-|-----------+----------+---------|
-| :previous | Previous | ↑ |
-| :next | Next | ↓ |
-| :marked | Marked | ❯ |
-| :group | Group | [] |
-| :jump | Jump | 🚀 |
+By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
IBuffer will use Unicode symbols as appropriate in its menus.
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/image.org b/docs/image.org
index 5e8d405c91..db646e1d16 100644
--- a/docs/image.org
+++ b/docs/image.org
@@ -45,6 +45,7 @@ The main menu for Casual Image (~casual-image-tmenu~) is
organized into the foll
*** Image Resize
#+CINDEX: Image Resize
+#+VINDEX: casual-image-resize-tmenu
If ImageMagick (version 6 or 7) is installed, Casual Image can resize an image
using it. The Transient ~casual-image-resize-tmenu~ is a streamlined interface
to the ImageMagick ~-resize~ function.
@@ -57,9 +58,20 @@ Note that if the image file has been modified, the resize
interface will be disa
- (o) Output to another file - If enabled, then the user will be prompted for
a different output file, else it will /irreversibly/ update the current image
file.
- (t) Type - Specify if /adaptive/ or /interpolative/ resizing should be used.
If nothing is specified then /standard/ resizing is used.
+*** Image Settings
+#+VINDEX: casual-image-settings-tmenu
+
+The menu ~casual-image-settings-tmenu~ provides access to different
~image-mode~ settings.
+
+# TODO: Insert screenshot
+
*** Image Unicode Symbol Support
-By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Image will use Unicode symbols as appropriate in its menus.
+By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Image will use Unicode symbols as appropriate in its menus.
+
+[[file:images/casual-image-main-unicode-screenshot.png]]
+
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
*** Image Mode Command Naming
diff --git a/docs/images/casual-calendar-calendars-menu.png
b/docs/images/casual-calendar-calendars-menu.png
index b488b5d7a9..cbfb0e8d5c 100644
Binary files a/docs/images/casual-calendar-calendars-menu.png and
b/docs/images/casual-calendar-calendars-menu.png differ
diff --git a/docs/images/casual-calendar-diary-menu.png
b/docs/images/casual-calendar-diary-menu.png
index b2896ea39f..848dfe7c03 100644
Binary files a/docs/images/casual-calendar-diary-menu.png and
b/docs/images/casual-calendar-diary-menu.png differ
diff --git a/docs/images/casual-calendar-lunar-menu.png
b/docs/images/casual-calendar-lunar-menu.png
index 78b6970dee..517c45ed49 100644
Binary files a/docs/images/casual-calendar-lunar-menu.png and
b/docs/images/casual-calendar-lunar-menu.png differ
diff --git a/docs/images/casual-calendar-main-unicode.png
b/docs/images/casual-calendar-main-unicode.png
new file mode 100644
index 0000000000..e48d44313e
Binary files /dev/null and b/docs/images/casual-calendar-main-unicode.png differ
diff --git a/docs/images/casual-calendar-screenshot.png
b/docs/images/casual-calendar-screenshot.png
index f00b471823..dbe6db04ca 100644
Binary files a/docs/images/casual-calendar-screenshot.png and
b/docs/images/casual-calendar-screenshot.png differ
diff --git a/docs/images/casual-calendar-settings-menu.png
b/docs/images/casual-calendar-settings-menu.png
index e68ca7b088..7ec265006a 100644
Binary files a/docs/images/casual-calendar-settings-menu.png and
b/docs/images/casual-calendar-settings-menu.png differ
diff --git a/docs/images/casual-css-screenshot.png
b/docs/images/casual-css-screenshot.png
index f2b9f4886d..3536373b1a 100644
Binary files a/docs/images/casual-css-screenshot.png and
b/docs/images/casual-css-screenshot.png differ
diff --git a/docs/images/casual-csv-align-screenshot.png
b/docs/images/casual-csv-align-screenshot.png
index 56f95f3443..799566a652 100644
Binary files a/docs/images/casual-csv-align-screenshot.png and
b/docs/images/casual-csv-align-screenshot.png differ
diff --git a/docs/images/casual-csv-edit-screenshot.png
b/docs/images/casual-csv-edit-screenshot.png
index 006e8cfc88..f5b33139b3 100644
Binary files a/docs/images/casual-csv-edit-screenshot.png and
b/docs/images/casual-csv-edit-screenshot.png differ
diff --git a/docs/images/casual-csv-edit-unicode-screenshot.png
b/docs/images/casual-csv-edit-unicode-screenshot.png
new file mode 100644
index 0000000000..57e8447ff9
Binary files /dev/null and b/docs/images/casual-csv-edit-unicode-screenshot.png
differ
diff --git a/docs/images/casual-csv-view-screenshot.png
b/docs/images/casual-csv-view-screenshot.png
index 64bcee2700..6befe615be 100644
Binary files a/docs/images/casual-csv-view-screenshot.png and
b/docs/images/casual-csv-view-screenshot.png differ
diff --git a/docs/images/casual-csv-view-unicode-screenshot.png
b/docs/images/casual-csv-view-unicode-screenshot.png
deleted file mode 100644
index b406054c7d..0000000000
Binary files a/docs/images/casual-csv-view-unicode-screenshot.png and /dev/null
differ
diff --git a/docs/images/casual-editkit-bookmarks-screenshot.png
b/docs/images/casual-editkit-bookmarks-screenshot.png
index 2984b70a4d..2739487c65 100644
Binary files a/docs/images/casual-editkit-bookmarks-screenshot.png and
b/docs/images/casual-editkit-bookmarks-screenshot.png differ
diff --git a/docs/images/casual-editkit-copy-screenshot.png
b/docs/images/casual-editkit-copy-screenshot.png
index 5e8fb117c6..08a63a9bdd 100644
Binary files a/docs/images/casual-editkit-copy-screenshot.png and
b/docs/images/casual-editkit-copy-screenshot.png differ
diff --git a/docs/images/casual-editkit-delete-screenshot.png
b/docs/images/casual-editkit-delete-screenshot.png
index b02eb7fd86..6aa54ae69e 100644
Binary files a/docs/images/casual-editkit-delete-screenshot.png and
b/docs/images/casual-editkit-delete-screenshot.png differ
diff --git a/docs/images/casual-editkit-edit-screenshot.png
b/docs/images/casual-editkit-edit-screenshot.png
index c9cc21965c..29dc090dad 100644
Binary files a/docs/images/casual-editkit-edit-screenshot.png and
b/docs/images/casual-editkit-edit-screenshot.png differ
diff --git a/docs/images/casual-editkit-emoji-symbols-screenshot.png
b/docs/images/casual-editkit-emoji-symbols-screenshot.png
index 538ae0b733..f2ee23e098 100644
Binary files a/docs/images/casual-editkit-emoji-symbols-screenshot.png and
b/docs/images/casual-editkit-emoji-symbols-screenshot.png differ
diff --git a/docs/images/casual-editkit-kill-screenshot.png
b/docs/images/casual-editkit-kill-screenshot.png
index 4be89695f7..7a50889442 100644
Binary files a/docs/images/casual-editkit-kill-screenshot.png and
b/docs/images/casual-editkit-kill-screenshot.png differ
diff --git a/docs/images/casual-editkit-macro-screenshot.png
b/docs/images/casual-editkit-macro-screenshot.png
index 60895ca30c..0d254a8f88 100644
Binary files a/docs/images/casual-editkit-macro-screenshot.png and
b/docs/images/casual-editkit-macro-screenshot.png differ
diff --git a/docs/images/casual-editkit-main-screenshot.png
b/docs/images/casual-editkit-main-screenshot.png
index 370d7b61fd..4d20cfecd5 100644
Binary files a/docs/images/casual-editkit-main-screenshot.png and
b/docs/images/casual-editkit-main-screenshot.png differ
diff --git a/docs/images/casual-editkit-mark-screenshot.png
b/docs/images/casual-editkit-mark-screenshot.png
index fb6c9429c1..569b503944 100644
Binary files a/docs/images/casual-editkit-mark-screenshot.png and
b/docs/images/casual-editkit-mark-screenshot.png differ
diff --git a/docs/images/casual-editkit-move-screenshot.png
b/docs/images/casual-editkit-move-screenshot.png
index c2504cb7ae..2f0fc7a7af 100644
Binary files a/docs/images/casual-editkit-move-screenshot.png and
b/docs/images/casual-editkit-move-screenshot.png differ
diff --git a/docs/images/casual-editkit-move-word-screenshot.png
b/docs/images/casual-editkit-move-word-screenshot.png
new file mode 100644
index 0000000000..b231400095
Binary files /dev/null and
b/docs/images/casual-editkit-move-word-screenshot.png differ
diff --git a/docs/images/casual-editkit-narrow-screenshot.png
b/docs/images/casual-editkit-narrow-screenshot.png
index a9b8ff6088..f0eca17625 100644
Binary files a/docs/images/casual-editkit-narrow-screenshot.png and
b/docs/images/casual-editkit-narrow-screenshot.png differ
diff --git a/docs/images/casual-editkit-open-screenshot.png
b/docs/images/casual-editkit-open-screenshot.png
index f00ca0735e..edefa8d36d 100644
Binary files a/docs/images/casual-editkit-open-screenshot.png and
b/docs/images/casual-editkit-open-screenshot.png differ
diff --git a/docs/images/casual-editkit-project-screenshot.png
b/docs/images/casual-editkit-project-screenshot.png
index 1d9d0a3aef..2f5a00976a 100644
Binary files a/docs/images/casual-editkit-project-screenshot.png and
b/docs/images/casual-editkit-project-screenshot.png differ
diff --git a/docs/images/casual-editkit-rectangle-screenshot.png
b/docs/images/casual-editkit-rectangle-screenshot.png
index 7c0ea7d9de..d849b43e75 100644
Binary files a/docs/images/casual-editkit-rectangle-screenshot.png and
b/docs/images/casual-editkit-rectangle-screenshot.png differ
diff --git a/docs/images/casual-editkit-reformat-screenshot.png
b/docs/images/casual-editkit-reformat-screenshot.png
index 82d8bef224..be8650c78a 100644
Binary files a/docs/images/casual-editkit-reformat-screenshot.png and
b/docs/images/casual-editkit-reformat-screenshot.png differ
diff --git a/docs/images/casual-editkit-registers-screenshot.png
b/docs/images/casual-editkit-registers-screenshot.png
index c525c2957d..aa38045248 100644
Binary files a/docs/images/casual-editkit-registers-screenshot.png and
b/docs/images/casual-editkit-registers-screenshot.png differ
diff --git a/docs/images/casual-editkit-search-screenshot.png
b/docs/images/casual-editkit-search-screenshot.png
index 6e19ccf6e0..b72df12d0c 100644
Binary files a/docs/images/casual-editkit-search-screenshot.png and
b/docs/images/casual-editkit-search-screenshot.png differ
diff --git a/docs/images/casual-editkit-settings-screenshot.png
b/docs/images/casual-editkit-settings-screenshot.png
index 1408ccf1e9..a517f7d282 100644
Binary files a/docs/images/casual-editkit-settings-screenshot.png and
b/docs/images/casual-editkit-settings-screenshot.png differ
diff --git a/docs/images/casual-editkit-sort-screenshot.png
b/docs/images/casual-editkit-sort-screenshot.png
index b26f3f177b..7d2c81124f 100644
Binary files a/docs/images/casual-editkit-sort-screenshot.png and
b/docs/images/casual-editkit-sort-screenshot.png differ
diff --git a/docs/images/casual-editkit-tools-screenshot.png
b/docs/images/casual-editkit-tools-screenshot.png
index 812d31af47..91bbce08d7 100644
Binary files a/docs/images/casual-editkit-tools-screenshot.png and
b/docs/images/casual-editkit-tools-screenshot.png differ
diff --git a/docs/images/casual-editkit-transform-screenshot.png
b/docs/images/casual-editkit-transform-screenshot.png
index 2a069ca6b4..d8e69e97d2 100644
Binary files a/docs/images/casual-editkit-transform-screenshot.png and
b/docs/images/casual-editkit-transform-screenshot.png differ
diff --git a/docs/images/casual-editkit-transpose-screenshot.png
b/docs/images/casual-editkit-transpose-screenshot.png
index df850d7863..70c0650727 100644
Binary files a/docs/images/casual-editkit-transpose-screenshot.png and
b/docs/images/casual-editkit-transpose-screenshot.png differ
diff --git a/docs/images/casual-editkit-window-delete-screenshot.png
b/docs/images/casual-editkit-window-delete-screenshot.png
index df3fed3cbc..16ad7ce0a0 100644
Binary files a/docs/images/casual-editkit-window-delete-screenshot.png and
b/docs/images/casual-editkit-window-delete-screenshot.png differ
diff --git a/docs/images/casual-editkit-window-screenshot.png
b/docs/images/casual-editkit-window-screenshot.png
index a1ff6c47e8..7d3ebffbf6 100644
Binary files a/docs/images/casual-editkit-window-screenshot.png and
b/docs/images/casual-editkit-window-screenshot.png differ
diff --git a/docs/images/casual-editkit-window-unicode-screenshot.png
b/docs/images/casual-editkit-window-unicode-screenshot.png
index 78cdb68f35..fa551c0ee7 100644
Binary files a/docs/images/casual-editkit-window-unicode-screenshot.png and
b/docs/images/casual-editkit-window-unicode-screenshot.png differ
diff --git a/docs/images/casual-elisp-edebug-screenshot.png
b/docs/images/casual-elisp-edebug-screenshot.png
index 86416b1abd..73fa4cd573 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 aa03de2f80..b3e23aa9fc 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
index 62a89756f6..99123a889d 100644
Binary files a/docs/images/casual-elisp-unicode-screenshot.png and
b/docs/images/casual-elisp-unicode-screenshot.png differ
diff --git a/docs/images/casual-html-screenshot.png
b/docs/images/casual-html-screenshot.png
index 7d7d8c655e..d947b141dc 100644
Binary files a/docs/images/casual-html-screenshot.png and
b/docs/images/casual-html-screenshot.png differ
diff --git a/docs/images/casual-html-settings-screenshot.png
b/docs/images/casual-html-settings-screenshot.png
index 5c840703e4..a5869044f1 100644
Binary files a/docs/images/casual-html-settings-screenshot.png and
b/docs/images/casual-html-settings-screenshot.png differ
diff --git a/docs/images/casual-html-tags-screenshot.png
b/docs/images/casual-html-tags-screenshot.png
index 9924c39d45..71b39fbde0 100644
Binary files a/docs/images/casual-html-tags-screenshot.png and
b/docs/images/casual-html-tags-screenshot.png differ
diff --git a/docs/images/casual-html-unicode-screenshot.png
b/docs/images/casual-html-unicode-screenshot.png
new file mode 100644
index 0000000000..9e3dd559da
Binary files /dev/null and b/docs/images/casual-html-unicode-screenshot.png
differ
diff --git a/docs/images/casual-image-main-screenshot.png
b/docs/images/casual-image-main-screenshot.png
index cef3b68aa1..624a3b0a68 100644
Binary files a/docs/images/casual-image-main-screenshot.png and
b/docs/images/casual-image-main-screenshot.png differ
diff --git a/docs/images/casual-image-main-unicode-screenshot.png
b/docs/images/casual-image-main-unicode-screenshot.png
new file mode 100644
index 0000000000..6ac97aea9e
Binary files /dev/null and
b/docs/images/casual-image-main-unicode-screenshot.png differ
diff --git a/docs/images/casual-image-resize-screenshot.png
b/docs/images/casual-image-resize-screenshot.png
index 674735a9b1..06aaed432e 100644
Binary files a/docs/images/casual-image-resize-screenshot.png and
b/docs/images/casual-image-resize-screenshot.png differ
diff --git a/docs/images/casual-isearch-settings-tmenu.png
b/docs/images/casual-isearch-settings-tmenu.png
new file mode 100644
index 0000000000..be48f5e230
Binary files /dev/null and b/docs/images/casual-isearch-settings-tmenu.png
differ
diff --git a/docs/images/casual-isearch-tmenu.png
b/docs/images/casual-isearch-tmenu.png
index a7edff4149..73aff2be01 100644
Binary files a/docs/images/casual-isearch-tmenu.png and
b/docs/images/casual-isearch-tmenu.png differ
diff --git a/docs/images/casual-isearch-unicode.png
b/docs/images/casual-isearch-unicode.png
new file mode 100644
index 0000000000..6764370781
Binary files /dev/null and b/docs/images/casual-isearch-unicode.png differ
diff --git a/docs/images/casual-make-automatic-variables-screenshot.png
b/docs/images/casual-make-automatic-variables-screenshot.png
index f207df3762..92a07f4863 100644
Binary files a/docs/images/casual-make-automatic-variables-screenshot.png and
b/docs/images/casual-make-automatic-variables-screenshot.png differ
diff --git a/docs/images/casual-make-mode-select-screenshot.png
b/docs/images/casual-make-mode-select-screenshot.png
index 5be01f476d..601613128e 100644
Binary files a/docs/images/casual-make-mode-select-screenshot.png and
b/docs/images/casual-make-mode-select-screenshot.png differ
diff --git a/docs/images/casual-make-screenshot.png
b/docs/images/casual-make-screenshot.png
index c26c71487d..c6641b3ce6 100644
Binary files a/docs/images/casual-make-screenshot.png and
b/docs/images/casual-make-screenshot.png differ
diff --git a/docs/info.org b/docs/info.org
index 71580bc1f6..b5cbf1fd1b 100644
--- a/docs/info.org
+++ b/docs/info.org
@@ -70,3 +70,4 @@ The main menu for Casual Info is organized into the following
sections:
#+TEXINFO: @subheading Info Unicode Symbol Support
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Info will use Unicode symbols as appropriate in its menus.
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/isearch.org b/docs/isearch.org
index d67fe87344..8dc769dcfd 100644
--- a/docs/isearch.org
+++ b/docs/isearch.org
@@ -40,3 +40,23 @@ The main menu for Casual I-Search is organized into the
following sections:
When in search mode (typically via the keybinding {{{kbd(C-s)}}} or
{{{kbd(C-r)}}}), pressing the keybinding {{{kbd(C-o)}}} (or binding of your
preference) will raise the Transient menu ~casual-isearch-tmenu~. Once raised,
only the /I-Search/ commands in the *Toggle*, *Replace*, and *Misc* sections
will automatically dismiss the menu when selected. All other /I-Search/
commands will /not/ dismiss the menu.
Use {{{kbd(C-g)}}} to dismiss this Transient menu.
+
+
+#+TEXINFO: @subheading I-Search Settings
+#+VINDEX: casual-isearch-settings-tmenu
+
+The menu ~casual-isearch-settings-tmenu~ provides access to different I-Search
settings.
+
+[[file:images/casual-isearch-settings-tmenu.png]]
+
+
+#+TEXINFO: @subheading I-Search Unicode Symbol Support
+
+By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
I-Search will use Unicode symbols as appropriate in its menus.
+
+[[file:images/casual-isearch-unicode.png]]
+
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
+
+
+
diff --git a/docs/make-mode.org b/docs/make-mode.org
index 7107ddb0d0..0c1de07a37 100644
--- a/docs/make-mode.org
+++ b/docs/make-mode.org
@@ -45,6 +45,7 @@ As there are different variants of *make* and makefile
formats, you can configur
[[file:images/casual-make-mode-select-screenshot.png]]
+The symbol for this menu is ~casual-make-mode-select-tmenu~.
*** Automatic Variables
#+CINDEX: Automatic Variables
@@ -54,7 +55,10 @@ Casual Make provides a menu to enter GNU Make-style
[[info:make#Automatic Variab
[[file:images/casual-make-automatic-variables-screenshot.png]]
+The symbol for this menu is ~casual-make-automatic-variables-tmenu~.
*** Make Unicode Symbol Support
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Make will use Unicode symbols as appropriate in its menus.
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
+
diff --git a/docs/man.org b/docs/man.org
index 08fc4583b0..bcc125baf9 100644
--- a/docs/man.org
+++ b/docs/man.org
@@ -60,10 +60,12 @@ The following sections are offered in the menu:
- Page :: If the Man page reader is configured to display all manual pages for
a given search key, navigation commands for multiple pages is provided.
#+TEXINFO: @subheading Options Navigation
+#+VINDEX: casual-man-occur-options
~casual-man-tmenu~ provides the menu item {{{kbd(o)}}} which runs the command
~casual-man-occur-options~. This will invoke ~occur~ with a regexp that
searches for command line options (for example, "--foo", "-a") that can be
navigated via the ~occur~ interface.
#+TEXINFO: @subheading Man Settings
+#+VINDEX: casual-man-settings-tmenu
By default, the Man page reader will /not/ display all manual pages for given
search key. This can be changed in the Settings menu
~casual-man-settings-tmenu~ that can be invoked by pressing {{{kbd(\,)}}} in
~casual-man-tmenu~.
@@ -75,3 +77,5 @@ Press ‘s’ and configure ~Man-switches~ to have the value "-a"
to get all man
#+TEXINFO: @subheading Man Unicode Symbol Support
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Man will use Unicode symbols as appropriate in its menus.
+
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/re-builder.org b/docs/re-builder.org
index 558b72c878..8b70460291 100644
--- a/docs/re-builder.org
+++ b/docs/re-builder.org
@@ -52,13 +52,16 @@ Once a desired regexp pattern is defined, there are two
menu items that can be u
The menu item {{{kbd(i)}}} will invoke the Info page for regexp syntax with
respect to the current syntax type.
#+TEXINFO: @subheading Quitting RE-Builder
-Select “{{{kbd(q)}}} Quit” to exit the RE-Builder tool.
+Select “{{{kbd(q)}}} Quit” to exit the RE-Builder tool.
-#+TEXINFO: @subheading RE-Builder Unicode Symbol Support
-By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
RE-Builder will use Unicode symbols as appropriate in its menus. The following
mapping is shown in the table below:
+#+TEXINFO: @subheading RE-Builder Settings
+#+VINDEX: casual-re-builder-settings-tmenu
+
+The menu ~casual-re-builder-settings-tmenu~ provides access to different
RE-Builder settings.
-| Name | Plain | Unicode |
-|-----------+----------+---------|
-| :previous | Previous | ↑ |
-| :next | Next | ↓ |
+# TODO: Insert screenshot
+
+#+TEXINFO: @subheading RE-Builder Unicode Symbol Support
+By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
RE-Builder will use Unicode symbols as appropriate in its menus.
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
diff --git a/docs/timezone.org b/docs/timezone.org
index d4a8eb0dcd..64e4a4dfba 100644
--- a/docs/timezone.org
+++ b/docs/timezone.org
@@ -35,6 +35,7 @@ The main menu for Casual Timezone (~casual-timezone-tmenu~)
offers the following
#+TEXINFO: @subheading Timezone Planner
+#+VINDEX: casual-timezone-planner
[[file:images/casual-timezone-planner-screenshot.png]]
@@ -44,7 +45,6 @@ In this table, the point can be navigated using the
{{{kbd(p)}}}, {{{kbd(n)}}},
Use the {{{kbd(T)}}} binding to copy the timestamp under the current point to
the ~kill-ring~. The {{{kbd(t)}}} binding will copy all timestamps on the
current line to the ~kill-ring~.
-
*** Timezone Formatting
#+VINDEX: casual-timezone-datestamp-format
#+VINDEX: casual-timezone-convert-datestamp-format
@@ -84,5 +84,15 @@ These variables can be customized via the Transient menu
~casual-timezone-settin
The variable ~casual-timezone-zone-info-database~ is default set to the path
"/usr/share/zoneinfo/tzdata.zi". Customize this variable if the zoneinfo
database is located at a different path.
+*** Timezone Settings
+#+VINDEX: casual-timezone-settings-tmenu
+
+The menu ~casual-timezone-settings-tmenu~ provides access to different Casual
Timezone settings.
+
+# TODO: Insert screenshot
+
*** Timezone Unicode Symbol Support
By enabling “{{{kbd(u)}}} Use Unicode Symbols” from the Settings menu, Casual
Timezone will use Unicode symbols as appropriate in its menus.
+
+For more info on using Unicode symbols, please refer to [[#ux-conventions][UX
Conventions]].
+
diff --git a/lisp/casual-calc-variables.el b/lisp/casual-calc-variables.el
index 30b9d5e620..61bca62542 100644
--- a/lisp/casual-calc-variables.el
+++ b/lisp/casual-calc-variables.el
@@ -1,6 +1,6 @@
;;; casual-calc-variables.el --- Casual Variable Menu -*- lexical-binding:
t; -*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -35,22 +35,23 @@
Operations to store, recall, clear, and edit variables are provided by this
menu."
["Variable Operations"
- ("s" "Store (𝟣:)…" casual-calc--store :transient t)
- ("r" "Recall…" casual-calc--recall :transient t)
- ("c" "Clear…" casual-calc--unstore :transient t)
- ("e" "Edit…" casual-calc--edit-variable :transient nil)
- ("o" "Copy to other variable…" casual-calc--copy-variable :transient t)
- ("x" "Exchange (𝟣:) to variable…" casual-calc--store-exchange :transient t)
- ("p" "Persist…" casual-calc--permanent-variable :transient t)
- ("O" "Open Calc Settings File" casual-calc-open-settings-file :transient
nil)
- ("i" "Insert variables into buffer…" casual-calc--insert-variables
:transient t)]
+ [("s" "Store (𝟣:)…" casual-calc--store :transient nil)
+ ("r" "Recall…" casual-calc--recall :transient nil)
+ ("c" "Clear…" casual-calc--unstore :transient nil)]
+ [("e" "Edit…" casual-calc--edit-variable :transient nil)
+ ("o" "Copy to other variable…" casual-calc--copy-variable :transient t)
+ ("x" "Exchange (𝟣:) to variable…" casual-calc--store-exchange :transient
t)]
+
+ [("p" "Persist…" casual-calc--permanent-variable :transient t)
+ ("O" "Open Calc Settings File" casual-calc-open-settings-file :transient
nil)
+ ("i" "Insert variables into buffer…" casual-calc--insert-variables
:transient nil)]]
[:class transient-row
- (casual-lib-quit-one)
- (casual-calc-algebraic-entry)
- (casual-calc-pop)
- (casual-calc-undo-suffix)
- (casual-lib-quit-all)])
+ (casual-lib-quit-one)
+ (casual-calc-algebraic-entry)
+ (casual-calc-pop)
+ (casual-calc-undo-suffix)
+ (casual-lib-quit-all)])
(provide 'casual-calc-variables)
;;; casual-calc-variables.el ends here
diff --git a/lisp/casual-calendar-constants.el
b/lisp/casual-calendar-constants.el
index 5463519286..4f25586dd3 100644
--- a/lisp/casual-calendar-constants.el
+++ b/lisp/casual-calendar-constants.el
@@ -1,6 +1,6 @@
;;; casual-calendar-constants.el --- Casual Calendar Constants -*-
lexical-binding: t; -*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: calendar
@@ -143,7 +143,7 @@ plain ASCII-range string."
(transient-define-group casual-calendar--menu-navigation-group
[:class transient-row
(casual-lib-quit-one)
- ("RET" "Dismiss" transient-quit-all)
+ ("RET" "Done" transient-quit-all)
(casual-lib-quit-all)])
(provide 'casual-calendar-constants)
diff --git a/lisp/casual-calendar-settings.el b/lisp/casual-calendar-settings.el
index 65326a7972..a11d891fbe 100644
--- a/lisp/casual-calendar-settings.el
+++ b/lisp/casual-calendar-settings.el
@@ -1,6 +1,6 @@
;;; casual-calendar-settings.el --- Casual Calendar Settings -*-
lexical-binding: t; -*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -77,10 +77,10 @@ Customize settings for Calendar and Diary modes."
(casual-lib-customize-hide-navigation)]
[:class transient-row
- (casual-lib-quit-one)
- ("a" "About" casual-calendar-about :transient nil)
-
- (casual-lib-quit-all)])
+ (casual-lib-quit-one)
+ ("a" "About" casual-calendar-about :transient nil)
+ ("RET" "Done" transient-quit-all)
+ (casual-lib-quit-all)])
(defun casual-calendar--customize-calendar-group ()
"Customize calendar group."
diff --git a/lisp/casual-calendar-utils.el b/lisp/casual-calendar-utils.el
index 7f60daeb1f..b3d364854c 100644
--- a/lisp/casual-calendar-utils.el
+++ b/lisp/casual-calendar-utils.el
@@ -1,6 +1,6 @@
;;; casual-calendar-utils.el --- Casual Calendar Utils -*- lexical-binding: t;
-*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -85,11 +85,11 @@ specific supported non-Gregorian calendar system behavior."
[:class transient-row
(casual-lib-quit-one)
- ("RET" "Dismiss" transient-quit-all)
- ("I" "ⓘ Info" (lambda ()
+ ("I" "ⓘ Other Calendars" (lambda ()
(interactive)
(calendar-exit)
(info "(emacs) Other Calendars")))
+ ("RET" "Done" transient-quit-all)
(casual-lib-quit-all)])
(transient-define-prefix casual-calendar-lunar-tmenu ()
diff --git a/lisp/casual-calendar.el b/lisp/casual-calendar.el
index 03598ec0e9..e13c5a0d63 100644
--- a/lisp/casual-calendar.el
+++ b/lisp/casual-calendar.el
@@ -1,6 +1,6 @@
;;; casual-calendar.el --- Transient UI for Calendar -*- lexical-binding: t;
-*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -93,12 +93,12 @@ Main menu for `calendar' commands.
[:class transient-row
(casual-lib-quit-one)
- ("RET" "Dismiss" transient-quit-all)
- ("I" "ⓘ Info" (lambda ()
- (interactive)
- (calendar-exit)
- (calendar-goto-info-node)))
("," "Settings›" casual-calendar-settings-tmenu)
+ ("I" "ⓘ" (lambda ()
+ (interactive)
+ (calendar-exit)
+ (calendar-goto-info-node)))
+ ("RET" "Done" transient-quit-all)
("q" "Quit" calendar-exit)])
(provide 'casual-calendar)
diff --git a/lisp/casual-css-settings.el b/lisp/casual-css-settings.el
index 0652a3282a..6b1a4378a2 100644
--- a/lisp/casual-css-settings.el
+++ b/lisp/casual-css-settings.el
@@ -42,7 +42,7 @@
[:class transient-row
(casual-lib-quit-one)
- ("a" "About" casual-css-about :transient nil)
+ ("a" "About" casual-css-about)
(casual-lib-quit-all)])
(defun casual-css--customize-indent-offset ()
diff --git a/lisp/casual-css.el b/lisp/casual-css.el
index daadbce9e6..fb420217a7 100644
--- a/lisp/casual-css.el
+++ b/lisp/casual-css.el
@@ -66,7 +66,7 @@ Transient menu to commands provided by `css-mode'."
[:class transient-row
(casual-lib-quit-one)
("," "Settings" casual-css-settings-tmenu)
- ("RET" "Dismiss" transient-quit-all)
+ ("RET" "Done" transient-quit-all)
(casual-lib-quit-all)])
(provide 'casual-css)
diff --git a/lisp/casual-csv-utils.el b/lisp/casual-csv-utils.el
index 4569351d3e..7805d575e9 100644
--- a/lisp/casual-csv-utils.el
+++ b/lisp/casual-csv-utils.el
@@ -1,6 +1,6 @@
;;; casual-csv-utils.el --- Casual CSV Utils -*- lexical-binding: t; -*-
-;; Copyright (C) 2025 Charles Y. Choi
+;; Copyright (C) 2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -98,7 +98,7 @@ plain ASCII-range string."
[:class transient-row
(casual-lib-quit-one)
- ("RET" "Dismiss" casual-lib-quit-all)
+ ("RET" "Done" casual-lib-quit-all)
(casual-lib-quit-all)])
(provide 'casual-csv-utils)
diff --git a/lisp/casual-csv.el b/lisp/casual-csv.el
index 2b259e69bb..e4bdc3f477 100644
--- a/lisp/casual-csv.el
+++ b/lisp/casual-csv.el
@@ -1,6 +1,6 @@
;;; casual-csv.el --- Transient UI for CSV mode -*- lexical-binding: t; -*-
-;; Copyright (C) 2025 Charles Y. Choi
+;; Copyright (C) 2025-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -128,8 +128,9 @@
[:class transient-row
(casual-lib-quit-one)
("," "Settings" casual-csv-settings-tmenu)
- ("q" "Quit" quit-window)
- (casual-lib-quit-all)])
+ ("RET" "Done" transient-quit-all)
+ (casual-lib-quit-all)
+ ("q" "Quit" quit-window)])
(provide 'casual-csv)
;;; casual-csv.el ends here
diff --git a/lisp/casual-editkit-constants.el b/lisp/casual-editkit-constants.el
index eb5a663d4b..b60b80a19e 100644
--- a/lisp/casual-editkit-constants.el
+++ b/lisp/casual-editkit-constants.el
@@ -1,6 +1,6 @@
;;; casual-editkit-constants.el --- Constants file for Casual EditKit -*-
lexical-binding: t; -*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools, wp
@@ -33,14 +33,20 @@
(:point-down . '("↓" "Down"))
(:point-left . '("←" "Left"))
(:point-right . '("→" "Right"))
+
+ (:window-above . '("↑" "Above"))
+ (:window-below . '("↓" "Below"))
+ (:window-left . '("←" "To Left"))
+ (:window-right . '("→" "To Right"))
+
(:other-window . '("»" "Other"))
(:delete-other-windows . '("❏" "Delete other"))
- (:split-window-below . '("⇩" "Window below"))
- (:split-window-horizontally . '("⇨" "Window right"))
+ (:split-window-below . '("━" "Below"))
+ (:split-window-horizontally . '("┃" "Right"))
(:enlarge . '("+" "Enlarge"))
(:shrink . '("−" "Shrink"))
- (:horizontal . '("⦵" "Horizontal"))
- (:vertical . '("⏀" "Vertical"))
+ (:horizontal . '("↔︎" "Horizontal"))
+ (:vertical . '("↕︎" "Vertical"))
(:first . '("⤒" "first"))
(:last . '("⤓" "last"))
(:swap . '("⇄" "Swap"))
@@ -62,6 +68,7 @@ plain ASCII-range string."
[:class transient-row
(casual-lib-quit-one)
("U" "Undo" undo :transient t)
+ ("RET" "Done" transient-quit-all)
(casual-lib-quit-all)])
;; Transient cursor navigation group for Casual EditKit menus.
diff --git a/lisp/casual-editkit-settings.el b/lisp/casual-editkit-settings.el
index 9a69e600c9..de4a512ad2 100644
--- a/lisp/casual-editkit-settings.el
+++ b/lisp/casual-editkit-settings.el
@@ -1,6 +1,6 @@
;;; casual-editkit-settings.el --- Casual Bookmarks Settings -*-
lexical-binding: t; -*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools, wp
@@ -107,9 +107,10 @@
(casual-lib-customize-hide-navigation)]]
[:class transient-row
- (casual-lib-quit-one)
- ("a" "About" casual-editkit-about :transient nil)
- (casual-lib-quit-all)])
+ (casual-lib-quit-one)
+ ("a" "About" casual-editkit-about :transient nil)
+ ("RET" "Done" transient-quit-all)
+ (casual-lib-quit-all)])
(defun casual-editkit-about-editkit ()
"Casual EditKit is a user interface library for Emacs editing commands.
diff --git a/lisp/casual-editkit-utils.el b/lisp/casual-editkit-utils.el
index adab6e0e1b..dd87e1a662 100644
--- a/lisp/casual-editkit-utils.el
+++ b/lisp/casual-editkit-utils.el
@@ -1,6 +1,6 @@
;;; casual-editkit-utils.el --- Casual Bookmarks Utils -*- lexical-binding: t;
-*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools, wp
@@ -235,12 +235,7 @@ Commands pertaining to editing operations can be accessed
here."
("r" "Reformat›" casual-editkit-reformat-tmenu
:if-not (lambda () buffer-read-only))]]
-
- [:class transient-row
- (casual-lib-quit-one)
- ("RET" "Done" transient-quit-all)
- ("U" "Undo" undo :transient t)
- (casual-lib-quit-all)])
+ casual-editkit-navigation-group)
;;;###autoload (autoload 'casual-editkit-emoji-symbols-tmenu
"casual-editkit-utils" nil t)
(transient-define-prefix casual-editkit-emoji-symbols-tmenu ()
@@ -313,11 +308,7 @@ inserting common miscellaneous symbols."
("t" "™" (lambda () "Insert trademark sign."
(interactive) (insert "™")))]
- [:class transient-row
- (casual-lib-quit-one)
- ("RET" "Done" transient-quit-all)
- ("U" "Undo" undo :transient t)
- (casual-lib-quit-all)])
+ casual-editkit-navigation-group)
;;;###autoload (autoload 'casual-editkit-mark-tmenu "casual-editkit-utils" nil
t)
(transient-define-prefix casual-editkit-mark-tmenu ()
@@ -444,8 +435,7 @@ Commands pertaining to move word operations can be accessed
here."
["Move Word"
:class transient-row
("b" "Backward" casual-editkit-move-word-backward :transient t)
- ("f" "Forward" casual-editkit-move-word-forward :transient t)
- ("RET" "Done" transient-quit-all)]
+ ("f" "Forward" casual-editkit-move-word-forward :transient t)]
casual-editkit-cursor-navigation-group
casual-editkit-navigation-group)
@@ -456,8 +446,7 @@ Commands pertaining to move sentence operations can be
accessed here."
["Move Sentence"
:class transient-row
("b" "Backward" casual-editkit-move-sentence-backward :transient t)
- ("f" "Forward" casual-editkit-move-sentence-forward :transient t)
- ("RET" "Done" transient-quit-all)]
+ ("f" "Forward" casual-editkit-move-sentence-forward :transient t)]
casual-editkit-cursor-navigation-group
casual-editkit-navigation-group)
@@ -469,8 +458,7 @@ can be accessed here."
["Move Sexp"
:class transient-row
("b" "Backward" casual-editkit-move-sexp-backward :transient t)
- ("f" "Forward" casual-editkit-move-sexp-forward :transient t)
- ("RET" "Done" transient-quit-all)]
+ ("f" "Forward" casual-editkit-move-sexp-forward :transient t)]
casual-editkit-cursor-navigation-group
casual-editkit-navigation-group)
@@ -479,87 +467,107 @@ can be accessed here."
"Menu for ‘Window’ commands.
Commands pertaining to window management operations can be accessed here."
- ["Window"
- ["Navigate"
- :pad-keys t
+
+ ["Casual Window"
+ :description (lambda () (format "Casual Window: %s" (buffer-name)))
+ :pad-keys t
+ ["Focus"
("o" "»" other-window
:description (lambda () (casual-editkit-unicode-get :other-window))
- :transient t)
+ :transient t)]
+ [""
("p" "↑" windmove-up
:description (lambda () (casual-editkit-unicode-get :point-up))
- :transient t)
+ :transient nil)
("n" "↓" windmove-down
:description (lambda () (casual-editkit-unicode-get :point-down))
- :transient t)
+ :transient nil)]
+ [""
("b" "←" windmove-left
:description (lambda () (casual-editkit-unicode-get :point-left))
- :transient t)
+ :transient nil)
("f" "→" windmove-right
:description (lambda () (casual-editkit-unicode-get :point-right))
- :transient t)]
+ :transient nil)]
["Swap"
- :pad-keys t
("s" "⇄"
window-swap-states
- :description (lambda () (casual-editkit-unicode-get :swap)))
+ :transient t
+ :description (lambda () (casual-editkit-unicode-get :swap)))]
+ [""
("M-p" "↑" windmove-swap-states-up
- :description (lambda () (casual-editkit-unicode-get :point-up)))
+ :description (lambda () (casual-editkit-unicode-get :point-up))
+ :transient nil)
("M-n" "↓" windmove-swap-states-down
- :description (lambda () (casual-editkit-unicode-get :point-down)))
+ :description (lambda () (casual-editkit-unicode-get :point-down))
+ :transient nil)]
+ [""
("M-b" "←" windmove-swap-states-left
- :description (lambda () (casual-editkit-unicode-get :point-left)))
+ :description (lambda () (casual-editkit-unicode-get :point-left))
+ :transient nil)
("M-f" "→" windmove-swap-states-right
- :description (lambda () (casual-editkit-unicode-get :point-right)))]
+ :description (lambda () (casual-editkit-unicode-get :point-right))
+ :transient nil)]
- ["New"
- ("1" "❏" delete-other-windows
- :description (lambda () (casual-editkit-unicode-get
:delete-other-windows)))
+ ["Split"
("2" "⇩" split-window-below
- :description (lambda () (casual-editkit-unicode-get :split-window-below)))
+ :description (lambda ()
+ (casual-editkit-unicode-get :split-window-below)))
+
("3" "⇨" split-window-horizontally
- :description (lambda () (casual-editkit-unicode-get
:split-window-horizontally)))]
+ :description (lambda ()
+ (casual-editkit-unicode-get :split-window-horizontally)))]]
- ["Misc"
- ("t" "Transpose" casual-editkit-transpose-frame
- :if casual-editkit-package-transpose-frame-installed-p)
- ;; ("T" "Toggle Tab Bar" mac-toggle-tab-bar
- ;; :if casual-editkit-window-system-mac-p)
- ;;("J" "Jump to Window…" ace-select-window)
- ("d" "Delete›" casual-editkit-windows-delete-tmenu)]]
-
- ["Resize"
- ["↕︎"
+ [["Delete"
+ :pad-keys t
+ ("1" "Other" delete-other-windows)
+ ("DEL" "Delete›" casual-editkit-windows-delete-tmenu)]
+
+ ["Resize ↕︎"
:description (lambda () (casual-editkit-unicode-get :vertical))
("+" "Enlarge" enlarge-window
:description (lambda () (casual-editkit-unicode-get :enlarge))
:transient t)
("-" "Shrink" shrink-window
:description (lambda () (casual-editkit-unicode-get :shrink))
- :transient t)]
- ["↔︎"
+ :transient t)
+ ]
+
+ ["Resize ↔︎"
:description (lambda () (casual-editkit-unicode-get :horizontal))
- (">" "Enlarge" enlarge-window-horizontally
+ ("[" "Enlarge" enlarge-window-horizontally
:description (lambda () (casual-editkit-unicode-get :enlarge))
:transient t)
- ("<" "Shrink" shrink-window-horizontally
+ ("]" "Shrink" shrink-window-horizontally
:description (lambda () (casual-editkit-unicode-get :shrink))
- :transient t)]]
+ :transient t)]
+
+ ["Transpose"
+ :if casual-editkit-package-transpose-frame-installed-p
+ ("t" "Transpose" casual-editkit-transpose-frame)]]
casual-editkit-navigation-group)
;;;###autoload (autoload 'casual-editkit-windows-delete-tmenu
"casual-editkit-utils" nil t)
(transient-define-prefix casual-editkit-windows-delete-tmenu ()
- "Menu for ‘Window Delete’ commands.
-
+ "Menu for ‘Window Delete’ commands.
Commands pertaining to window deletion operations can be
accessed here."
["Delete Window"
- ("p" "Above" windmove-delete-up)
- ("n" "Below" windmove-delete-down)
- ("b" "On Left" windmove-delete-left)
- ("f" "On Right" windmove-delete-right)]
- [(casual-lib-quit-all)])
+ :pad-keys t
+ [("b" "To Left" windmove-delete-left
+ :description (lambda () (casual-editkit-unicode-get :window-left)))]
+
+ [("p" "Above" windmove-delete-up
+ :description (lambda () (casual-editkit-unicode-get :window-above)))
+ ("n" "Below" windmove-delete-down
+ :description (lambda () (casual-editkit-unicode-get :window-below)))]
+
+ [("f" "To Right" windmove-delete-right
+ :description (lambda () (casual-editkit-unicode-get :window-right)))]]
+
+ casual-editkit-navigation-group)
;;;###autoload (autoload 'casual-editkit-bookmarks-tmenu
"casual-editkit-utils" nil t)
(transient-define-prefix casual-editkit-bookmarks-tmenu ()
@@ -722,8 +730,7 @@ Commands pertaining to rectangle operations can be accessed
here."
("D" "Delete Leading Spaces" delete-whitespace-rectangle
:if-not casual-editkit-buffer-read-only-p
:inapt-if-not use-region-p
- :transient t)
- ("RET" "Done" transient-quit-all)]]
+ :transient t)]]
casual-editkit-cursor-navigation-group
casual-editkit-navigation-group)
@@ -739,9 +746,7 @@ Commands pertaining to transformation operations can be
accessed here."
:inapt-if-not use-region-p)]
[("l" "Make Lower Case" downcase-dwim :transient t)
- ("u" "Make Upper Case" upcase-dwim :transient t)]
-
- [("RET" "Done" transient-quit-all)]]
+ ("u" "Make Upper Case" upcase-dwim :transient t)]]
casual-editkit-cursor-navigation-group
casual-editkit-navigation-group)
diff --git a/lisp/casual-editkit.el b/lisp/casual-editkit.el
index fdd934a1cc..1d827c283a 100644
--- a/lisp/casual-editkit.el
+++ b/lisp/casual-editkit.el
@@ -1,6 +1,6 @@
;;; casual-editkit.el --- Transient user interface library for editing
commands -*- lexical-binding: t; -*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools, wp
@@ -124,8 +124,8 @@ user-customized menu."
("r" "Registers›" casual-editkit-registers-tmenu)
("U" "Undo" undo :transient t)
("," "Settings›" casual-editkit-settings-tmenu)
+ ("RET" "Done" transient-quit-all)
(casual-lib-quit-all)
-
("x" "Exit Emacs" save-buffers-kill-emacs)])
(provide 'casual-editkit)
diff --git a/lisp/casual-elisp.el b/lisp/casual-elisp.el
index e536ebef30..511e4a32bd 100644
--- a/lisp/casual-elisp.el
+++ b/lisp/casual-elisp.el
@@ -102,9 +102,9 @@
[:class transient-row
(casual-lib-quit-one)
- (casual-lib-quit-all)
("," "Settings›" casual-elisp-settings-tmenu)
- ("RET" "Dismiss" transient-quit-all)])
+ ("RET" "Done" transient-quit-all)
+ (casual-lib-quit-all)])
(provide 'casual-elisp)
;;; casual-elisp.el ends here
diff --git a/lisp/casual-help.el b/lisp/casual-help.el
index a5afa01017..13a4d8f0e1 100644
--- a/lisp/casual-help.el
+++ b/lisp/casual-help.el
@@ -1,6 +1,6 @@
;;; casual-help.el --- Transient UI for Help -*- lexical-binding: t; -*-
-;; Copyright (C) 2025 Charles Y. Choi
+;; Copyright (C) 2025-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
diff --git a/lisp/casual-html.el b/lisp/casual-html.el
index c43624d5ee..d9a78efccb 100644
--- a/lisp/casual-html.el
+++ b/lisp/casual-html.el
@@ -104,7 +104,7 @@ For more documentation, refer to the following links:
(casual-lib-quit-one)
("," "Settings" casual-html-settings-tmenu)
("I" "ⓘ" casual-html-info)
- ("RET" "Dismiss" transient-quit-all)
+ ("RET" "Done" transient-quit-all)
(casual-lib-quit-all)])
@@ -166,7 +166,7 @@ This menu provides an interface to HTML-specific commands
provided by
[:class transient-row
(casual-lib-quit-one)
- ("RET" "Dismiss" transient-quit-all)
+ ("RET" "Done" transient-quit-all)
(casual-lib-quit-all)])
(provide 'casual-html)
diff --git a/lisp/casual-image-utils.el b/lisp/casual-image-utils.el
index a00fb2e970..c8fc9afa07 100644
--- a/lisp/casual-image-utils.el
+++ b/lisp/casual-image-utils.el
@@ -1,6 +1,6 @@
;;; casual-image-utils.el --- Casual Image Utils -*- lexical-binding: t;
-*-
-;; Copyright (C) 2025 Charles Choi
+;; Copyright (C) 2025-2026 Charles Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -214,6 +214,7 @@ Menu resizing an image."
[:class transient-row
(casual-lib-quit-one)
+ ("RET" "Done" transient-quit-all)
(casual-lib-quit-all)])
(provide 'casual-image-utils)
diff --git a/lisp/casual-image.el b/lisp/casual-image.el
index 15dec07799..3e05893f14 100644
--- a/lisp/casual-image.el
+++ b/lisp/casual-image.el
@@ -1,6 +1,6 @@
;;; casual-image.el --- Casual Image -*- lexical-binding: t;
-*-
-;; Copyright (C) 2025 Charles Choi
+;; Copyright (C) 2025-2026 Charles Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -112,6 +112,7 @@
(casual-lib-quit-one)
("I" "Identify" casual-image--indentify-verbose)
("," "Settings›" casual-image-settings-tmenu)
+ ("RET" "Done" transient-quit-all)
(casual-lib-quit-all)
("q" "Quit View" quit-window)])
diff --git a/lisp/casual-isearch-utils.el b/lisp/casual-isearch-utils.el
index 01bb0ccd63..046c122e87 100644
--- a/lisp/casual-isearch-utils.el
+++ b/lisp/casual-isearch-utils.el
@@ -1,6 +1,6 @@
;;; casual-isearch-utils.el --- Casual Re-Builder Utils -*- lexical-binding:
t; -*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
diff --git a/lisp/casual-isearch.el b/lisp/casual-isearch.el
index ec1fcad063..4d93402048 100644
--- a/lisp/casual-isearch.el
+++ b/lisp/casual-isearch.el
@@ -113,8 +113,8 @@
[:class transient-row
(casual-lib-quit-one)
- ("RET" "Exit Search" isearch-exit)
("," "Settings›" casual-isearch-settings-tmenu)
+ ("RET" "Done" isearch-exit)
(casual-lib-quit-all)])
(provide 'casual-isearch)
diff --git a/lisp/casual-lib.el b/lisp/casual-lib.el
index fe56ea5abb..d7000235d4 100644
--- a/lisp/casual-lib.el
+++ b/lisp/casual-lib.el
@@ -160,7 +160,7 @@ new buffer. This can be avoided if a prefix ARG is
provided."
(let ((filename (buffer-file-name)))
(unless filename
- (error "This command only works on a file."))
+ (error "This command only works on a file"))
(let* ((extension (file-name-extension filename t))
(target (format "%s copy%s"
diff --git a/lisp/casual-make-utils.el b/lisp/casual-make-utils.el
index 2134b71d6d..97c090c1ce 100644
--- a/lisp/casual-make-utils.el
+++ b/lisp/casual-make-utils.el
@@ -1,6 +1,6 @@
;;; casual-make-utils.el --- Casual Make Utils -*- lexical-binding: t; -*-
-;; Copyright (C) 2025 Charles Y. Choi
+;; Copyright (C) 2025-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -73,6 +73,7 @@ plain ASCII-range string."
[:class transient-row
(casual-lib-quit-one)
+ ("RET" "Done" casual-lib-quit-all)
(casual-lib-quit-all)])
(defconst casual-make--autovar-description-map
@@ -231,9 +232,10 @@ For more info, refer to info node `(make) Automatic
Variables'."
[:class transient-row
(casual-lib-quit-one)
- (casual-lib-quit-all)
- ("RET" "Dismiss" casual-lib-quit-all)
- ("i" "Info" (lambda () (interactive) (info "(make) Automatic Variables")))])
+ ("I" "ⓘ Automatic Variables"
+ (lambda () (interactive) (info "(make) Automatic Variables")))
+ ("RET" "Done" casual-lib-quit-all)
+ (casual-lib-quit-all)])
(provide 'casual-make-utils)
;;; casual-make-utils.el ends here
diff --git a/lisp/casual-make.el b/lisp/casual-make.el
index f239b47429..360670cc7e 100644
--- a/lisp/casual-make.el
+++ b/lisp/casual-make.el
@@ -1,6 +1,6 @@
;;; casual-make.el --- Transient UI for Make -*- lexical-binding: t; -*-
-;; Copyright (C) 2025 Charles Y. Choi
+;; Copyright (C) 2025-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -78,8 +78,8 @@ This menu provides a user interface for the commands in
`make-mode'."
(casual-lib-quit-one)
("," "Settings" casual-make-settings-tmenu)
("I" "ⓘ Make" (lambda () (interactive) (info "(make) Top")))
- (casual-lib-quit-all)
- ("RET" "Exit Menu" transient-quit-all)])
+ ("RET" "Done" transient-quit-all)
+ (casual-lib-quit-all)])
(provide 'casual-make)
;;; casual-make.el ends here
diff --git a/lisp/casual-man-utils.el b/lisp/casual-man-utils.el
index 02b34eb4d7..42946813a9 100644
--- a/lisp/casual-man-utils.el
+++ b/lisp/casual-man-utils.el
@@ -1,6 +1,6 @@
;;; casual-man-utils.el --- Casual Man Utils -*- lexical-binding: t; -*-
-;; Copyright (C) 2025 Charles Y. Choi
+;; Copyright (C) 2025-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
diff --git a/lisp/casual.el b/lisp/casual.el
index 5ec9e03552..358f0042e4 100644
--- a/lisp/casual.el
+++ b/lisp/casual.el
@@ -5,7 +5,7 @@
;; Author: Charles Choi <[email protected]>
;; URL: https://github.com/kickingvegas/casual
;; Keywords: tools, wp
-;; Version: 2.13.1
+;; Version: 2.13.2-rc.1
;; Package-Requires: ((emacs "29.1") (transient "0.9.0") (csv-mode "1.27"))
;; This program is free software; you can redistribute it and/or modify
diff --git a/tests/test-casual-calc-variables.el
b/tests/test-casual-calc-variables.el
index 31a8bd8df0..4a6b245c39 100644
--- a/tests/test-casual-calc-variables.el
+++ b/tests/test-casual-calc-variables.el
@@ -1,6 +1,6 @@
;;; test-casual-calc-variables.el --- Test Casual Variables -*-
lexical-binding: t; -*-
-;; Copyright (C) 2024-2025 Charles Y. Choi
+;; Copyright (C) 2024-2026 Charles Y. Choi
;; Author: Charles Choi <[email protected]>
;; Keywords: tools
@@ -27,37 +27,6 @@
(require 'casual-calc-test-utils)
(require 'casual-calc-variables)
-(ert-deftest test-casual-calc-variable-crud-tmenu-integration ()
- (casualt-calc-setup)
-
- (calc-push-list '(25))
- (funcall 'casual-calc-variable-crud-tmenu)
- ;; test (s) calc-store
- (execute-kbd-macro "sfoo
")
- (should (= (calc-var-value 'var-foo) 25))
- (calc-pop-stack (calc-stack-size))
-
- ;; test (r) calc-recall
- (execute-kbd-macro "rfoo
")
- (should (= (calc-top) 25))
-
- ;; test (o) calc-copy-variable
- (execute-kbd-macro "ofoo
jane
")
- (should (= (calc-var-value 'var-jane) 25))
-
- ;; test (c) calc-unstore
- (execute-kbd-macro "cfoo
")
- (should (not (calc-var-value 'var-foo)))
-
- ;; test (x) calc-store-exchange
- (calc-push-list '(32))
- (execute-kbd-macro "xjane
")
- (should (= (calc-var-value 'var-jane) 32))
-
- ;; TODO: punting on calc-edit-variable
- ;; TODO: punting on calc-permanent-variable
- ;; TODO: punting on calc-insert-variables
- (casualt-calc-breakdown t))
(ert-deftest test-casual-calc-variable-crud-tmenu ()
(casualt-calc-setup)
@@ -73,7 +42,9 @@
(casualt-suffix-testbench-runner test-vectors
#'casual-calc-variable-crud-tmenu
'(lambda () (random 5000))))
- (casualt-calc-breakdown t t))
+ )
+
+
(provide 'test-casual-calc-variables)
;;; test-casual-calc-variables.el ends here
diff --git a/tests/test-casual-editkit-constants.el
b/tests/test-casual-editkit-constants.el
index ba4f6f0f36..aacfea5978 100644
--- a/tests/test-casual-editkit-constants.el
+++ b/tests/test-casual-editkit-constants.el
@@ -38,6 +38,22 @@
(let ((casual-lib-use-unicode nil))
(casualt-editkit-unicode-assert :previous "previous")
(casualt-editkit-unicode-assert :next "next")
+ (casualt-editkit-unicode-assert :point-up "Up")
+ (casualt-editkit-unicode-assert :point-down "Down")
+ (casualt-editkit-unicode-assert :point-left "Left")
+ (casualt-editkit-unicode-assert :point-right "Right")
+ (casualt-editkit-unicode-assert :window-above "Above")
+ (casualt-editkit-unicode-assert :window-below "Below")
+ (casualt-editkit-unicode-assert :window-left "To Left")
+ (casualt-editkit-unicode-assert :window-right "To Right")
+ (casualt-editkit-unicode-assert :other-window "Other")
+ (casualt-editkit-unicode-assert :delete-other-windows "Delete other")
+ (casualt-editkit-unicode-assert :split-window-below "Below")
+ (casualt-editkit-unicode-assert :split-window-horizontally "Right")
+ (casualt-editkit-unicode-assert :enlarge "Enlarge")
+ (casualt-editkit-unicode-assert :shrink "Shrink")
+ (casualt-editkit-unicode-assert :horizontal "Horizontal")
+ (casualt-editkit-unicode-assert :vertical "Vertical")
(casualt-editkit-unicode-assert :first "first")
(casualt-editkit-unicode-assert :last "last")
(casualt-editkit-unicode-assert :swap "Swap")
@@ -46,11 +62,26 @@
(let ((casual-lib-use-unicode t))
(casualt-editkit-unicode-assert :previous "↑")
(casualt-editkit-unicode-assert :next "↓")
+ (casualt-editkit-unicode-assert :point-up "↑")
+ (casualt-editkit-unicode-assert :point-down "↓")
+ (casualt-editkit-unicode-assert :point-left "←")
+ (casualt-editkit-unicode-assert :point-right "→")
+ (casualt-editkit-unicode-assert :window-above "↑")
+ (casualt-editkit-unicode-assert :window-below "↓")
+ (casualt-editkit-unicode-assert :window-left "←")
+ (casualt-editkit-unicode-assert :window-right "→")
+ (casualt-editkit-unicode-assert :other-window "»")
+ (casualt-editkit-unicode-assert :delete-other-windows "❏")
+ (casualt-editkit-unicode-assert :split-window-below "━")
+ (casualt-editkit-unicode-assert :split-window-horizontally "┃")
+ (casualt-editkit-unicode-assert :enlarge "+")
+ (casualt-editkit-unicode-assert :shrink "−")
+ (casualt-editkit-unicode-assert :horizontal "↔︎")
+ (casualt-editkit-unicode-assert :vertical "↕︎")
(casualt-editkit-unicode-assert :first "⤒")
(casualt-editkit-unicode-assert :last "⤓")
(casualt-editkit-unicode-assert :swap "⇄")
(casualt-editkit-unicode-assert :jump "🚀")))
-
(provide 'test-casual-editkit-constants)
;;; test-casual-editkit-constants.el ends here
diff --git a/tests/test-casual-editkit-utils.el
b/tests/test-casual-editkit-utils.el
index c2e9605f66..7472b463b1 100644
--- a/tests/test-casual-editkit-utils.el
+++ b/tests/test-casual-editkit-utils.el
@@ -375,6 +375,66 @@
'(lambda () (random 5000)))))
(casualt-editkit-breakdown tmpfile)))
+
+(ert-deftest test-casual-editkit-windows-tmenu ()
+ (let ()
+ (split-window-horizontally)
+ (split-window-vertically)
+ (cl-letf ((casualt-mock #'other-window)
+ (casualt-mock #'casual-editkit-windows-delete-tmenu)
+ (casualt-mock #'windmove-down)
+ (casualt-mock #'windmove-up)
+ (casualt-mock #'windmove-right)
+ (casualt-mock #'windmove-left)
+ (casualt-mock #'window-swap-states)
+ (casualt-mock #'window-swap-states-left)
+ (casualt-mock #'window-swap-states-right)
+ (casualt-mock #'window-swap-states-up)
+ (casualt-mock #'window-swap-states-down)
+
+ (casualt-mock #'split-window-below)
+ (casualt-mock #'split-window-horizontally)
+ (casualt-mock #'casual-editkit-windows-delete-tmenu)
+ (casualt-mock #'enlarge-window)
+ (casualt-mock #'shrink-window)
+ (casualt-mock #'enlarge-window-horizontally)
+ (casualt-mock #'shrink-window-horizontally)
+ (casualt-mock #'delete-other-windows))
+
+ (let ((test-vectors
+ '((:binding "o" :command other-window)
+ (:binding "n" :command windmove-down)
+ (:binding "p" :command windmove-up)
+ (:binding "f" :command windmove-right)
+ (:binding "b" :command windmove-left)
+ (:binding "s" :command window-swap-states)
+ (:binding "o" :command other-window)
+ ;;(:binding "M-b" :command window-swap-states-left)
+ ;;(:binding "M-f" :command window-swap-states-right)
+ ;;(:binding "M-p" :command window-swap-states-up)
+ ;;(:binding "M-n" :command window-swap-states-down)
+
+ (:binding "2" :command split-window-below)
+ (:binding "3" :command split-window-horizontally)
+ (:binding "DEL" :command casual-editkit-windows-delete-tmenu)
+
+ (:binding "+" :command enlarge-window)
+ (:binding "-" :command shrink-window)
+
+ (:binding "[" :command enlarge-window-horizontally)
+ (:binding "]" :command shrink-window-horizontally)
+
+ (:binding "1" :command delete-other-windows)
+ (:binding "RET" :command transient-quit-all))))
+
+ (casualt-suffix-testcase-runner test-vectors
+ #'casual-editkit-windows-tmenu
+ '(lambda () (random 5000)))))
+
+ (delete-other-windows)
+ ;;(casualt-editkit-breakdown)
+ ))
+
;; (ert-deftest test-casual-editkit-windows-tmenu ()
;; (let ((tmpfile "casual-editkit-windows-tmenu.txt"))
;; (casualt-editkit-setup tmpfile)