Casual User Guide ¶

3.2.1 If you do not use use-package to configure Casual ¶

Before installing Casual, you should update all of your existing Casual packages. This is most easily done via the package menu buffer ((emacs)Package Menu) . After updating your packages, install the casual package.

Migrate your existing Casual packages from 1.x to 2.x by running the following commands:

M-x load-library casual
M-x casual-upgrade-base-to-version-2

Any Casual v1.x packages that have been superseded by this package will be uninstalled.

While not necessary, it is recommended to run M-x package-autoremove to purge any dangling dependent packages. Cautious readers can choose to audit any packages that are targeted to be removed.

3.2.2 If you have used use-package to configure Casual ¶

For version 2.x going forward, I (Charles Choi) have decided to not offer any documented guidance on using use-package to configure Casual due my lack of expertise in using it. I leave it to more skilled readers to determine how to best use use-package ((use-package)Top) for their configuration. Please also note that this is not a prohibition on using use-package with Casual. I am simply admitting that I don’t know how to use it.

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.

5.1.1 Agenda Install ¶

Add these lines to your Emacs initialization file with your binding of preference.

(keymap-set org-agenda-mode-map "C-o" #'casual-agenda-tmenu)

Use these bindings to configure Org Agenda to be consistent with bindings used by Casual Agenda. This is optional.

; bindings to make jumping consistent between Org Agenda and Casual Agenda
(keymap-set org-agenda-mode-map "M-j" #'org-agenda-clock-goto)
(keymap-set org-agenda-mode-map "J" #'bookmark-jump)

5.1.2 Agenda Usage ¶

The main menu for Casual Agenda is casual-agenda-tmenu. It is divided into five sections:

Agenda

Modify the view duration (day, week, year)

Filter

Filter displayed headlines with different criteria

Actions

Perform an activity on a headline, create/capture a headline or even generate a different agenda view.

Navigation

move the point to where you want it to be.

Utils

Set a timer, get almanac info.

Operating on Headlines (casual-agenda-operations-tmenu) ¶

Use “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.

Marking Headlines (casual-agenda-mark-tmenu) ¶

Use “M Mark›” menu from casual-agenda-tmenu to mark different headlines and perform a bulk action on them.

Almanac (casual-agenda-almanac-tmenu) ¶

Get sunrise/sunset times, lunar cycle dates, and holidays with respect to a date via the “l Almanac›” menu from casual-agenda-tmenu.

Changing Modes and Settings ¶

Agenda views have different display modes and behavior that can be modified from the “, Settings›” menu from casual-agenda-tmenu.

Agenda Unicode Symbol Support ¶

By enabling “u Use Unicode Settings” from the Settings menu, Casual Agenda will use Unicode symbols as appropriate in its menus.

For more info on using Unicode symbols, please refer to UX Conventions.

5.2.1 BibTeX Install ¶

In your initialization file, bind the Transient casual-bibtex-tmenu to your key binding of preference in bibtex-mode-map. The binding M-m is suggested so as to not conflict with C-o that is bound to casual-editkit-main-tmenu. (EditKit Install)

(keymap-set bibtex-mode-map "M-m" #'casual-bibtex-tmenu)

casual-bibtex-tmenu is opinionated in making editing and navigation commands emulate a form-based interface (form-based interface) in a bibtex-mode window. The following keybindings are recommended to support consistent behavior between bibtex-mode-map and casual-bibtex-tmenu.

(add-hook 'bibtex-mode-hook 'hl-line-mode)

(keymap-set bibtex-mode-map "<TAB>" #'bibtex-next-field)
(keymap-set bibtex-mode-map "<backtab>" #'previous-line)

(keymap-set bibtex-mode-map "C-n" #'bibtex-next-field)
(keymap-set bibtex-mode-map "M-n" #'bibtex-next-entry)
(keymap-set bibtex-mode-map "M-p" #'bibtex-previous-entry)

(keymap-set bibtex-mode-map "<prior>" #'bibtex-previous-entry)
(keymap-set bibtex-mode-map "<next>" #'bibtex-next-entry)

(keymap-set bibtex-mode-map "C-c C-o" #'bibtex-url)
(keymap-set bibtex-mode-map "C-c C-c" #'casual-bibtex-fill-and-clean)

(keymap-set bibtex-mode-map "<clear>" #'bibtex-empty-field)
(keymap-set bibtex-mode-map "M-<clear>" #'bibtex-kill-field)
(keymap-set bibtex-mode-map "M-DEL" #'bibtex-kill-field)

5.2.2 BibTeX Usage ¶

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.

Misc

Miscellaneous BibTeX commands.

• BibTeX Navigation
• Creating, Updating, and Deleting BibTeX Structures
• BibTeX Settings
• BibTeX Mode Unicode Symbol Support

Next: Creating, Updating, and Deleting BibTeX Structures, Up: BibTeX Usage   [Contents][Index]

5.2.2.1 BibTeX Navigation ¶

Casual BibTeX re-purposes conventional Emacs navigation bindings so that instead of navigating a text edit buffer, it instead navigates BibTeX structures (entry, field).

The following table shows the bindings for BibTeX navigation.

Binding	Command
C-n	bibtex-next-field (bound to n in menu)
C-p	previous-line (bound to p in menu)
C-a	casual-bibtex-beginning-of-field
C-e	casual-bibtex-end-of-field
M-p	bibtex-previous-entry
M-n	bibtex-next-entry
<	bibtex-beginning-of-entry
>	bibtex-end-of-entry

---

Next: BibTeX Settings, Previous: BibTeX Navigation, Up: BibTeX Usage   [Contents][Index]

5.2.2.2 Creating, Updating, and Deleting BibTeX Structures ¶

In Casual BibTeX, CRUD (CReate, Update, Delete) operations for entry and field structures are intended to be achieved through their respective commands. This contrasts with manual editing of a buffer to achieve the same end, which is prone to errors.

Creating an Entry ¶

To create a new entry, use the “A Add…” command. You will be prompted in the mini-buffer with completion support for the entry type. This new entry will be inserted relative to existing entry where the point is with all fields supported by the entry type enumerated. Fields with the temporary prefix of “ALT” or “OPT” denote a field that is alternate or optional. Use the command “o Remove OPT/ALT” to remove this prefix.

When all desired information for a BibTeX entry has been entered, it can be “cleaned” using the command “C-c Clean”. Cleaning an entry will:

1. Generate a unique citation key, if needed.
2. Remove all unused fields.

By default, cleaning an entry will not format (or “fill”) the entry. This can be changed by setting the customizable variable bibtex-clean-entry-hook to include the command bibtex-fill-entry. This can be done from “Hooks” section in the Settings menu (Settings).

Creating a Field ¶

To create a new field, use the “a Add…” command. You will be prompted in the mini-buffer with completion support for the field type. This new field will be inserted relative to existing field where the point is.

There are two components to a field:

key

the field name, referred to in the menu as ’k’.

value

the value of the field, referred to in the menu as ’v’.

A “brute-force” command to enumerate all fields for an entry is provided by the “u Update…” command. Clean the entry to remove all unpopulated fields after using it.

BibTeX mode has its own kill-ring ¶

BibTeX has its own kill-ring variable bibtex-entry-kill-ring which the following menu commands use:

c Copy∙ k,v

Copy the whole field, both key and value.

C Copy∙

Copy the entry.

k Kill∙

Kill the entry.

y Yank∙

Yank the entry or field.

M-y Yank-Pop∙

Yank-pop the entry or field.

The “∙” annotation in a menu label denotes commands that do not use the kill-ring, but bibtex-entry-kill-ring instead.

Search and Jump ¶

The ability to search and jump to a position in a BibTeX database are offered by the following menu commands:

/ Search…

Search the BibTeX database.

j Jump…

Move point to a citation key.

---

Next: BibTeX Mode Unicode Symbol Support, Previous: Creating, Updating, and Deleting BibTeX Structures, Up: BibTeX Usage   [Contents][Index]

5.2.2.3 BibTeX Settings ¶

The menu casual-bibtex-settings-tmenu offers access to commonly configured BibTeX mode settings.

Settings are organized into the following sections:

Settings

Miscellaneous BibTeX settings.

Files

File and path related settings.

Search

Search settings.

Hooks

Hook settings for cleaning and adding.

BibTeX Clean Hook ¶

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 “C Clean” command as shown below:

---

Previous: BibTeX Settings, Up: BibTeX Usage   [Contents][Index]

5.2.2.4 BibTeX Mode Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual BibTeX will use Unicode symbols as appropriate in its menus.

For more info on using Unicode symbols, please refer to UX Conventions.

---

5.3.1 Bookmarks Install ¶

To install Casual Bookmarks, add the following line to your Emacs initialization file with your binding of preference.

(keymap-set bookmark-bmenu-mode-map "C-o" #'casual-bookmarks-tmenu)

Use these keybindings to configure the bookmark list to be consistent with keybindings used by Casual Bookmarks.

(keymap-set bookmark-bmenu-mode-map "J" #'bookmark-jump)

Casual Bookmarks also includes the keymap casual-bookmarks-main-menu which inserts a Bookmarks menu into the main menu bar as shown below.

To enable this, add the following configuration to your initialization file.

(require 'casual-bookmarks)
(easy-menu-add-item global-map '(menu-bar)
                    casual-bookmarks-main-menu
                    "Tools")

While not necessary, having the current bookmark highlighted is convenient. Enable hl-line-mode for the bookmark list as shown below.

(require 'hl-line)
(add-hook 'bookmark-bmenu-mode-hook #'hl-line-mode)

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 Using Bookmarks in Emacs like you do in Web Browsers.

5.3.2 Bookmarks Usage ¶

Casual Bookmarks organizes its main menu into the following sections:

Operations

Commands that can operate on a bookmark such as editing or opening them.

Mark

Commands that allow for bulk operation on multiple bookmarks.

Display

Control how bookmarks are displayed and filtered.

Annotation

Commands for annotating a bookmark.

Navigation

Commands for navigating to a bookmark.

Column

Commands to navigate and control the display of the table layout for bookmarks.

Sorting ¶

Support for sorting the bookmarks list is provided by the menu casual-bookmarks-sortby-tmenu.

Unicode Symbol Support ¶

By enabling “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.

5.4.1 Calc Install ¶

To install Casual Calc, add the following lines to your Emacs initialization file with your binding of preference.

(keymap-set calc-mode-map "C-o" #'casual-calc-tmenu)
(keymap-set calc-alg-map "C-o" #'casual-calc-tmenu)

5.4.2 Calc Usage ¶

To launch Calc, invoke M-x calc. When the point is in the Calc window, invoke C-o (or a binding of your choosing) to launch the Casual Calc interface.

For nearly all menus, algebraic entry via the ' binding is available, as well as basic calculator operations (addition, subtraction, multiplication, division) and stack operations (pop, enter).

Casual Calc organizes its main menu into the following sections:

Calc

Commands for common calculator functions.

Constants

Common math constants.

Operators

Common math operators.

Stack

Commands for stack operations.

Arithmetic

Entry point for sub-menus of commands classified as arithmetic operations.

Functions

Entry point for sub-menus of commands organized into different classes of functionality.

Settings

Entry point for sub-menus of commands to configure Calc settings.

Calc Basics ¶

It helps to know some basics about Calc.

• Calc is a stack-based calculator that supports both RPN and algebraic style entry.
  • By default it uses RPN entry, but this can be changed to algebraic.
• Stack based operations are always RPN-style.
• Undo has the keybinding U, redo is D.
• The top of the stack is referred to as 1:
• Calc vectors are punctuated with [ and ] (e.g. [2 3]) Matrix values are represented as vectors within a vector. For example, [[1 0] [0 1]] is a square diagonal matrix.
• Calc vector indexes are 1-offset.
• Intervals
  • Inclusive intervals are represented as [𝑛..𝑚], where 𝑛 < 𝑚.
  • Exclusive intervals are represented as (𝑛..𝑚), where 𝑛 < 𝑚.
  • Any combination of lower and upper bounds set to be inclusive or exclusive is supported.
• Complex numbers are entered as (𝑟, 𝑖), where 𝑟 is the real part and 𝑖 is the imaginary.
• Radix numbers are entered as 𝑏#𝑛 where 𝑏 is the base value and 𝑛 is the number. For example entering 2#0101 will put 5 on the stack.
• H:M:S values are default entered as ℎ@ 𝑚" 𝑠’.
• Org-mode active timestamps can be entered into Calc.
• The top of the stack (1:) can be edited by pressing the ` key.
• Entering a single quote (’) will prompt you for an algebraic entry.

5.5.1 Calendar Install ¶

The main menu for Casual Calendar (casual-calendar-tmenu) is invoked by the command casual-calendar. Bind this command in the keymap calendar-mode-map as follows in your initialization file.

(keymap-set calendar-mode-map "C-o" #'casual-calendar)

5.5.2 Calendar Usage ¶

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. C-o).

Casual Calendar organizes its main menu into the following sections:

Navigation

Commands to move the point to a desired date, adjusting the view as necessary.

Conversions

Commands to convert a date across different calendar systems.

Holidays

Holiday related commands.

Misc

Commands related to the Diary and Org Agenda are placed here.

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
• Calendar System Date Conversion
• Calendar Settings Menu
• Calendar Unicode Symbol Support

Next: Calendar System Date Conversion, Up: Calendar Usage   [Contents][Index]

5.5.2.1 Diary & Goto Menu ¶

From the main menu, choosing “D Diary & Goto›” will present choices for diary event insertion and to “goto” a particular date via different specifications.

---

Next: Calendar Settings Menu, Previous: Diary & Goto Menu, Up: Calendar Usage   [Contents][Index]

5.5.2.2 Calendar System Date Conversion ¶

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.

Supported calendar systems:

• 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.

To convert a Gregorian date to Lunar (Chinese):

1. Move cursor (point) in Calendar window to desired date. (The command “(g) Goto…” can be used to accomplish this.)
2. Choose “(c) Date at Cursor”.

To convert a Lunar (Chinese) date to Gregorian:

1. Choose “(G) Goto…” and follow the prompts.

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.

Note that inserting non-Gregorian diary events require configuration of the variables diary-nongregorian-listing-hook and diary-nongregorian-marking-hook as detailed in Diary Entries using non-Gregorian Calendars ((emacs)Non-Gregorian Diary).

Both of these variables can be configured from the Calendar Settings menu.

---

Next: Calendar Unicode Symbol Support, Previous: Calendar System Date Conversion, Up: Calendar Usage   [Contents][Index]

5.5.2.3 Calendar Settings Menu ¶

From the main menu, choosing “, Settings›” will provide a menu (casual-calendar-settings-tmenu) of frequently configured calendar and diary-related variables.

---

Previous: Calendar Settings Menu, Up: Calendar Usage   [Contents][Index]

5.5.2.4 Calendar Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual Calendar will use Unicode symbols as appropriate in its menus.

For more info on using Unicode symbols, please refer to UX Conventions.

---

5.6.1 Compile Install ¶

In your initialization file, bind the Transient casual-compile-tmenu to your key binding of preference. It should be bound in two maps: compilation-mode-map and grep-mode-map.

(keymap-set compilation-mode-map "C-o" #'casual-compile-tmenu)
(keymap-set grep-mode-map "C-o" #'casual-compile-tmenu)

casual-compile-tmenu deviates from the default bindings of compilation-mode-map as shown in the table below to support using a single key on an ‘en.US’ keyboard.

The following keybindings are recommended to support consistent behavior between compilation-mode-map and casual-compile-tmenu.

(keymap-set compilation-mode-map "k" #'compilation-previous-error)
(keymap-set compilation-mode-map "j" #'compilation-next-error)
(keymap-set compilation-mode-map "o" #'compilation-display-error)
(keymap-set compilation-mode-map "[" #'compilation-previous-file)
(keymap-set compilation-mode-map "]" #'compilation-next-file)

Similar treatment for grep-mode-map can be done.

(keymap-set grep-mode-map "k" #'compilation-previous-error)
(keymap-set grep-mode-map "j" #'compilation-next-error)
(keymap-set grep-mode-map "o" #'compilation-display-error)
(keymap-set grep-mode-map "[" #'compilation-previous-file)
(keymap-set grep-mode-map "]" #'compilation-next-file)

5.6.2 Compile Usage ¶

After running compile, invoke casual-compile-tmenu in the buffer named ‘✳︎compilation✳︎’ using the binding C-o (or your binding of preference).

The following sections are offered in the menu:

Follow

Navigate the point while opening the location of the error in the source file in another window.

Error

Error commands for navigation and viewing.

File

If there are errors in multiple files, navigate to the file.

Compile

Get compile for different Elisp types. Note that the “k Kill” item is displayed when there is a running job.

If the output window is from a Grep command, casual-compile-tmenu will adjust its labels accordingly as shown below.

Compile Settings ¶

The menu casual-compile-settings-tmenu provides access to different compilation-mode settings.

Compile Mode Unicode Symbol Support ¶

By enabling “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.

5.7.1 CSS Install ¶

In your initialization file, bind the Transient casual-css-tmenu to your key binding of preference.

(keymap-set css-mode-map "M-m" #'casual-css-tmenu)

A different binding (M-m) is used as casual-css-tmenu is intended to work alongside with Casual EditKit.

5.7.2 CSS Usage ¶

The following sections are offered in the menu:

CSS

CSS specific commands.

• “l Lookup Symbol” will reference the symbol’s documentation from the Mozilla Developer Network (MDN) website.
• “c Cycle Color” should be selected when the point is on a color specification.

Edit

Editing commands.

• “f Indent CSS Rule” is a call to fill-paragraph whose behavior is adjusted for css-mode.

Misc

Miscellaneous commands.

• “h Highlight Line” toggles hl-line-mode to avoid interfering the display of color specifications.

CSS Settings ¶

The menu casual-css-settings-tmenu provides access to different css-mode settings.

CSS Unicode Symbol Support ¶

By enabling “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.

5.8.1 CSV Install ¶

In your initialization file, bind the Transient casual-csv-tmenu to your key binding of preference.

(keymap-set csv-mode-map "M-m" #'casual-csv-tmenu)

The binding M-m is intended to complement the binding C-o used by EditKit.

While not required, the following configuration is recommended for working with CSV files.

;; disable line wrap
(add-hook 'csv-mode-hook
          (lambda ()
            (visual-line-mode -1)
            (toggle-truncate-lines 1)))

;; auto detect separator
(add-hook 'csv-mode-hook #'csv-guess-set-separator)
;; turn on field alignment
(add-hook 'csv-mode-hook #'csv-align-mode)

5.8.2 CSV Usage ¶

The following sections are offered in the menu:

Navigation, Line, Buffer

Commands for moving the point, mostly with respect to a field.

Page

Move up or down a page.

Buffer/File

Commands associated the current buffer or file, such changing the buffer state from viewable (read-only) to editable (writeable), display alignment, or duplicating the file for subsequent editing.

Field

Commands to mark or copy a field.

Sort

Sorting commands. This section is displayed only if the buffer is editable.

Fields

Kill and yank commands dedicated for CSV mode. Note that these commands do not use the default kill-ring and are marked with a bullet (•). This section is displayed only if the buffer is editable.

Misc

Miscellaneous commands. Note if a region is selected containing multiple complete rows, the “C Copy as Table” command will reformat the selected rows as an Org table and copy them in the kill-ring for subsequent pasting.

CVS View/Edit, Duplicate ¶

If the buffer is in view (read-only) mode, then only relevant commands are displayed.

If the buffer is editable, a common to desire to instead work on a copy of the CSV file to avoid making unwanted changes. This can be done using the “d Duplicate” command.

CSV Align ¶

The display of the CSV buffer can be controlled with the menu casual-csv-align-tmenu.

CSV Settings ¶

The menu casual-csv-settings-tmenu provides access to different csv-mode settings.

CSV Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual CSV will use Unicode symbols as appropriate in its menus.

For more info on using Unicode symbols, please refer to UX Conventions.

5.9.1 Dired Requirements ¶

Casual Dired requires that the ls utility from GNU coreutils ≥ 8.32 be installed.

The following links provide guidance for installing GNU coreutils on different platforms.

• macOS
• Windows

5.9.2 Dired Install ¶

The main menu for Dired is casual-dired-tmenu. Bind this menu in the keymap dired-mode-map as follows in your initialization file.

(keymap-set dired-mode-map "C-o" #'casual-dired-tmenu)

In addition, it is convenient to have both the sort-by (casual-dired-sort-by-tmenu) and search & replace (casual-dired-search-replace-tmenu) menus bound. Listed below is an example of binding the sort-by and search & replace menus to s and / respectively.

(keymap-set dired-mode-map "s" #'casual-dired-sort-by-tmenu)
(keymap-set dired-mode-map "/" #'casual-dired-search-replace-tmenu)

Included is a standard keymap for Dired sorting commands (casual-dired-sort-menu) which can be included in a context menu for a mouse-driven workflow. An example of this is shown below:

(require 'casual-dired)

(defun casual-dired-context-menu-addons (menu click)
  "Customize context MENU with CLICK event."
  (easy-menu-add-item menu nil casual-dired-sort-menu)
  menu)

(add-hook 'context-menu-functions #'casual-dired-context-menu-addons)
(add-hook 'dired-mode-hook 'context-menu-mode)

Configuration ¶

As Dired has been around for a long time, the different ways of configuring it are myriad. Described below is a configuration used by the author that is consistent with the bindings used in Casual Dired.

(require 'dired)
(require 'dired-x)
(require 'wdired)
(require 'hl-line)
(require 'mouse)
(require 'image-dired)
(require 'image-dired-dired)
(require 'casual-dired)

(keymap-set dired-mode-map "C-o" #'casual-dired-tmenu)
(keymap-set dired-mode-map "s" #'casual-dired-sort-by-tmenu)
(keymap-set dired-mode-map "/" #'casual-dired-search-replace-tmenu)

(add-hook 'dired-mode-hook 'hl-line-mode)
(add-hook 'dired-mode-hook 'context-menu-mode)
(add-hook 'dired-mode-hook 'dired-async-mode)
(add-hook
 'dired-mode-hook
 (lambda ()
   (setq-local mouse-1-click-follows-link 'double)))

(keymap-set dired-mode-map "M-o" #'dired-omit-mode)
(keymap-set dired-mode-map "E" #'wdired-change-to-wdired-mode)
(keymap-set dired-mode-map "M-n" #'dired-next-dirline)
(keymap-set dired-mode-map "M-p" #'dired-prev-dirline)
(keymap-set dired-mode-map "]" #'dired-next-subdir)
(keymap-set dired-mode-map "[" #'dired-prev-subdir)
(keymap-set dired-mode-map "A-M-<mouse-1>" #'browse-url-of-dired-file)
(keymap-set dired-mode-map "<backtab>" #'dired-prev-subdir)
(keymap-set dired-mode-map "TAB" #'dired-next-subdir)
(keymap-set dired-mode-map "M-j" #'dired-goto-subdir)
(keymap-set dired-mode-map ";" #'image-dired-dired-toggle-marked-thumbs)

(keymap-set image-dired-thumbnail-mode-map "n" #'image-dired-display-next)
(keymap-set image-dired-thumbnail-mode-map "p" #'image-dired-display-previous)

Dired Variables ¶

The Casual Dired main menu offers “, Settings›” to customize a set of commonly used Dired variables.

If you have GNU ls installed and configured, use the l key to set the variable dired-use-ls-dired to t (“l Use GNU ‘ls’ with –dired”). Otherwise this should be disabled.

5.9.3 Dired Usage ¶

Invoke M-x dired to launch Dired. When the point is in the Dired window, invoke C-o (or a binding of your choosing) to launch the Casual Dired menu (casual-dired-tmenu).

Casual Dired organizes its main menu into the following sections:

File

File-related commands are placed here. Most of the commands will also operate on marked files (see Mark item below).

Directory

Directory-related commands. Subdir view commands are also made available in this section. To remove a subdir view, use the command prefix C-u before pressing the binding k to kill a subdir view.

Mark

Marking operations are available here. Commands in the “# Utils›” sub-menu can be used to operate on marked items. In addition, many commands from the File section can be operate on marked items.

The “r Regexp›” sub-menu provides commands to mark via regular expression.

Navigation

Navigation commands to move the point in Dired are offered here.

Quick

Convenience commands for bookmarks and listing buffers are made available in this section.

Search

Commands to find a filename via I-Search or to recursively search for pattern inside files contained in a directory tree (rgrep) are made available here.

New

Create a new file or directory with the commands in this section.

• Dired Enhanced Sorting
• Dired Search & Replace
• Bulk Dired Operations
• Dired Link
• Dired Elisp
• Dired Unicode Symbol Support

Next: Dired Search & Replace, Up: Dired Usage   [Contents][Index]

5.9.3.1 Dired Enhanced Sorting ¶

Casual Dired offers enhanced sorting capabilities through GNU ls. Use this to sort your Dired buffer to preference. Filter dot files (.*) by disabling the --all option is available here.

With the Sort By menu raised, one can save the switch settings for future use via the binding C-x C-s (transient-save). Note this is a global setting and will apply to all future calls to the Sort By menu.

---

Next: Bulk Dired Operations, Previous: Dired Enhanced Sorting, Up: Dired Usage   [Contents][Index]

5.9.3.2 Dired Search & Replace ¶

Search and replace in multiple marked files using the “/ 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.

While most Dired commands use Emacs-style regular expression syntax ((elisp)Regular Expressions), there are two commands that instead take instead grep-style syntax:

• g Find regex… (dired-do-find-regexp)
• G Find regex and replace… (dired-do-find-regexp-and-replace)

The grep-style syntax is dependent on the grep implementation that is installed and used by Emacs.

---

Next: Dired Link, Previous: Dired Search & Replace, Up: Dired Usage   [Contents][Index]

5.9.3.3 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 “# Utils›” menu (casual-dired-utils-tmenu) in casual-dired-tmenu.

---

Next: Dired Elisp, Previous: Bulk Dired Operations, Up: Dired Usage   [Contents][Index]

5.9.3.4 Dired Link ¶

Create symbolic and hard links via the “l Link›” menu (casual-dired-link-tmenu) in casual-dired-tmenu. Both absolute and relative symbolic links (symlinks) are supported.

---

Previous: Dired Elisp, Up: Dired Usage   [Contents][Index]

5.9.3.6 Dired Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual Dired will use Unicode symbols as appropriate in its menus. An example is shown below.

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.

---

5.10.1 Ediff Install ¶

In your initialization file, bind the Transient casual-ediff-tmenu to your key binding of preference.

(casual-ediff-install) ; run this to enable Casual Ediff
(add-hook 'ediff-keymap-setup-hook
          (lambda ()
            (keymap-set ediff-mode-map "C-o" #'casual-ediff-tmenu)))

If the current buffer is loaded with a version-controlled file, then the difference between that buffer’s content with its most recent commit can be seen with the command casual-ediff-revision. It is often convenient to bind this command. Shown below is an example of such a binding.

(keymap-global-set "<f15>" #'casual-ediff-revision)

Users who wish to call casual-ediff-revision via mouse can use the command casual-ediff-revision-from-menu. An example of its use is shown in the source example below (note this is a code fragment).

(easy-menu-add-item
     menu nil
     ["Ediff revision…"
      casual-ediff-revision-from-menu
      :visible (and (bound-and-true-p buffer-file-name)
                    (vc-registered (buffer-file-name)))
      :help "Ediff this file with revision"])

Ediff Variables ¶

Casual Ediff recommends the following variables be set as follows:

5.10.2 Ediff Usage ¶

Casual Ediff (casual-ediff-tmenu) is invoked from the Ediff control window, typically using the binding C-o (or your binding of preference).

The menu comprises of sections laid out horizontally that correspond to source of the diffs. The number of sections and their contents are context-dependent on the type of content to be compared.

The following sections are offered in the menu:

A

Context-dependent commands for Ediff buffer A.

B

Context-dependent commands for Ediff buffer B.

C

Context-dependent commands for Ediff buffer C, if available.

Diff

Ediff commands not related to a specific buffer.

Navigation between diffs are bound to the p and n keys for previous and next diff respectively.

• Ediff Basic Operation
• Comparing a Version-Controlled File
• Resolving a Merge Conflict
• Ediff Settings
• Ediff Unicode Symbol Support

Next: Comparing a Version-Controlled File, Up: Ediff Usage   [Contents][Index]

5.10.2.1 Ediff Basic Operation ¶

If two writeable files are compared, Casual Ediff provides the ability to write diffs from either side A or B to each other. Unwanted changes to a side can be restored.

---

Next: Resolving a Merge Conflict, Previous: Ediff Basic Operation, Up: Ediff Usage   [Contents][Index]

5.10.2.2 Comparing a Version-Controlled File ¶

Casual Ediff provides a dedicated command to compare a version-controlled file with its latest commit: casual-ediff-revision. This command short-circuits the prompts asked for by the command ediff-revision which asks for the source file and the revision to compare it to. Call casual-ediff-revision from the window of a version-controlled file, typically by key binding of preference.

The A side will hold the last committed revision of a file. The B side will hold current source file.

Users desiring a mouse-driven approach to calling casual-ediff-revision should use the command casual-ediff-revision-from-menu invoked from either the top-level or context menu.

Note that both casual-ediff-revision and casual-ediff-revision-from-menu will checkpoint the window configuration before invoking the Ediff session and restore it after the session is complete.

---

Next: Ediff Settings, Previous: Comparing a Version-Controlled File, Up: Ediff Usage   [Contents][Index]

5.10.2.3 Resolving a Merge Conflict ¶

Magit offers a means of invoking Ediff to resolve a merge conflict via the e binding from the magit-status ((magit) Status Buffer) window.

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 mab or mba, depending on the desired order the diffs are to be merged.

---

5.11.1 EditKit Install ¶

A reference menu (casual-editkit-main-tmenu) illustrating nearly all the different menus offered by Casual EditKit is provided. This menu can be used “as-is” with your binding of preference. For consistency with other Casual Packages, the binding C-o is used in the example below. Other candidate bindings include M-o and F10. To facilitate default access to this menu, the configuration below sets this binding to be global which can be overridden per mode. This is not mandatory and users are free to integrate Casual EditKit into their Emacs configuration however they see fit.

(keymap-global-set "C-o" #'casual-editkit-main-tmenu)

Also suggested is to globally bind the windows, rectangle, registers, and project menus as shown below.

(keymap-global-set "C-c w" #'casual-editkit-windows-tmenu)
(keymap-global-set "C-c r" #'casual-editkit-rectangle-tmenu)
(keymap-global-set "C-c g" #'casual-editkit-registers-tmenu)
(keymap-global-set "C-c p" #'casual-editkit-project-tmenu)

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.

5.11.2 EditKit Usage ¶

The main menu of Casual EditKit (casual-editkit-main-tmenu) is organized into the following sections:

File

Commands related to opening files or buffers are provided here.

Edit

Text editing commands are provided here.

From this section, rectangle commands are made available via the “e Edit›” → “R Rectangle›” binding combination.

Sexp

Text editing commands specific for a balanced expression (Sexp) are provided here.

Tools

Commands for invoking different tools are provided here.

Miscellaneous (unlabeled)

Commands related to bookmarks, window management, project (Emacs file organization), search & replace, and macros are found here.

Casual EditKit has numerous menus to cover a variety of edit related commands.

• Register commands
• Edit commands
• Window management
• Search & Replace commands
• Open commands
• Project commands
• Bookmark commands
• Emoji & Symbol Insertion
• Tool commands
• Narrow/Widen Commands
• Macro
• EditKit Settings

Next: Edit commands, Up: EditKit Usage   [Contents][Index]

5.11.2.1 Register commands ¶

Support for register commands ((emacs)Registers) is provided by the menu casual-editkit-registers-tmenu. It is available via the menu item “r Registers›” in the navigation row at the bottom of casual-editkit-main-tmenu.

Register commands for saving and recalling text, point, window configuration, and keyboard macros are provided by this menu.

---

Next: Window management, Previous: Register commands, Up: EditKit Usage   [Contents][Index]

5.11.2.2 Edit commands ¶

The menu casual-editkit-edit-tmenu contains commands and sub-menus related to editing text.

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.

Mark› (casual-editkit-mark-tmenu) ¶

Text can be marked with different granularity with this menu. Note that the menu item “d Defun” is only supported for modes derived from prog-mode.

Copy› (casual-editkit-copy-tmenu) ¶

Text can be copied with different granularity with this menu.

Kill (Cut)› (casual-editkit-kill-tmenu) ¶

Text can be cut (killed) with different granularity with this menu.

Move› (casual-editkit-move-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).

If “w Word›” is selected, then the following menu casual-editkit-move-word-tmenu is displayed.

Similar menus for moving a sentence (casual-editkit-move-sentence-tmenu) and balanced expression (casual-editkit-move-sexp-tmenu) are available.

Transpose› (casual-editkit-transpose-tmenu) ¶

Text can be transposed with different granularity with this menu.

Transform› (casual-editkit-transform-tmenu) ¶

Text can be transformed with different granularity with this menu. Supported transformations are capitalization, lower and upper casing of text.

Delete› (casual-editkit-delete-tmenu) ¶

Operations involving text deletion are included in this menu, including joining lines and zapping to a character.

Sort› (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.

Reformat› (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.

Rectangle› (casual-editkit-rectangle-tmenu) ¶

This menu offers all the rectangle commands. It is packaged as a sub-menu of casual-editkit-edit-tmenu.

Users wishing more direct access to this menu can bind casual-editkit-rectangle-tmenu as shown in the install section.

---

Next: Search & Replace commands, Previous: Edit commands, Up: EditKit Usage   [Contents][Index]

5.11.2.3 Window management ¶

The menu casual-editkit-windows-tmenu provides support for different Emacs window management commands. Note that in Emacs, a window ((elisp)Basic Windows) is defined differently than its usage in contemporary graphical user interfaces.

Note that the section “Transpose” is only available if the package transpose-frame is installed.

Users wishing more direct access to this menu can bind casual-editkit-windows-tmenu as shown in the install section.

Window Deletion ¶

This menu provides support for deleting windows. Note the commands apply to other windows, not the current one in focus.

Window Menu Unicode Symbol Support ¶

If the variable casual-lib-use-unicode is set to t, then Unicode symbols are used in the labels.

For more info on using Unicode symbols, please refer to UX Conventions.

---

Next: Open commands, Previous: Window management, Up: EditKit Usage   [Contents][Index]

5.11.2.4 Search & Replace commands ¶

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.

---

Next: Project commands, Previous: Search & Replace commands, Up: EditKit Usage   [Contents][Index]

5.11.2.5 Open commands ¶

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.

---

Next: Bookmark commands, Previous: Open commands, Up: EditKit Usage   [Contents][Index]

5.11.2.6 Project commands ¶

Project-related commands are listed in the menu casual-editkit-project-tmenu.

---

Next: Emoji & Symbol Insertion, Previous: Project commands, Up: EditKit Usage   [Contents][Index]

5.11.2.7 Bookmark commands ¶

Commands edit, add, or jump to a bookmark are captured in the menu casual-editkit-bookmarks-tmenu.

---

Next: Tool commands, Previous: Bookmark commands, Up: EditKit Usage   [Contents][Index]

5.11.2.8 Emoji & Symbol Insertion ¶

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 Q.

---

Next: Narrow/Widen Commands, Previous: Emoji & Symbol Insertion, Up: EditKit Usage   [Contents][Index]

5.11.2.9 Tool commands ¶

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.

---

Next: Macro, Previous: Tool commands, Up: EditKit Usage   [Contents][Index]

5.11.2.10 Narrow/Widen Commands ¶

Support for narrowing and widening ((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.

This menu can be modified ((transient)Modifying Existing Transients) to support narrowing in other modes, particularly those that are packaged with Emacs. For example, if one wanted narrowing support for Markdown (markdown-mode), the following initialization code can be used.

(transient-append-suffix 'casual-editkit-narrow-tmenu '(0 0)
   ["Markdown"
    :if (lambda () (derived-mode-p 'markdown-mode))
    ("s" "Subtree" markdown-narrow-to-subtree)
    ("b" "Block" markdown-narrow-to-block)
    ("p" "Page" markdown-narrow-to-page)])

---

Next: EditKit Settings, Previous: Narrow/Widen Commands, Up: EditKit Usage   [Contents][Index]

5.11.2.11 Macro ¶

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.

---

Previous: Macro, Up: EditKit Usage   [Contents][Index]

5.11.2.12 EditKit Settings ¶

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)”
• “Fill Column (set-fill-column)”

Those commands will instead apply to the current buffer. The variables listed above can be more permanently set via the customize-variable command.

---

5.12.1 Elisp Install ¶

In your initialization file, bind the Transient casual-elisp-tmenu to your key binding of preference. Suggested bindings include M-m and C-c m. This menu is intended to be auxiliary to Casual EditKit.

(keymap-set emacs-lisp-mode-map "M-m" #'casual-elisp-tmenu)

The binding M-m is intended to complement the binding C-o used by EditKit.

5.12.2 Elisp Usage ¶

Invoke the Casual Elisp main menu casual-elisp-tmenu via the binding M-m (or your binding of preference) in an Elisp window. Typically this is whenever an ‘.el’ file is opened.

The following sections are offered in the menu:

Evaluate

Commands to evaluate or execute an Elisp expression ((elisp)Eval).

Xref

Cross-referencing commands ((emacs)Xref).

Checkdoc

Checks docstrings in the file.

Byte-Compile

Commands for byte-compilation ((elisp)Byte Compilation).

Find

Find commands.

Navigate

Commands for Sexp (balanced expression) navigation.

Edebug Support ¶

Using the command prefix C-u when casual-elisp-tmenu is raised will change the “d Defun✦” menu item to “d Edebug” to support instrumenting a function for Edebug ((elisp)Edebug).

Elisp Settings ¶

The menu casual-elisp-settings-tmenu provides access to different emacs-lisp-mode settings.

Elisp Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual Elisp will use Unicode symbols as appropriate in its menus.

For more info on using Unicode symbols, please refer to UX Conventions.

5.13.1 Eshell Install ¶

In your initialization file, bind the Transient casual-eshell-tmenu to your key binding of preference.

(keymap-set eshell-mode-map "C-o" #'casual-eshell-tmenu)

5.13.2 Eshell Usage ¶

Eshell can be invoked via M-x eshell. In the Eshell window, press C-o (or your binding of preference) to raise the menu casual-eshell-tmenu.

The following sections are offered in the menu:

Input

Commands supporting input to the current prompt.

Argument

Commands supporting arguments in the current prompt.

Prompt

Navigation of previous prompt commands.

Output

Commands related to display of prompt. Commands marked with the glyph ✦ support an optional prefix (C-u) value.

Misc

Miscellaneous commands.

Process

Signal commands to send to the process. This section is only visible when a process is running.

Eshell Settings ¶

The menu casual-eshell-settings-tmenu provides access to different eshell-mode settings.

Eshell Info ¶

The menu casual-eshell-info-tmenu provides access to different eshell-mode documentation in its Info manual.

Eshell Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual Eshell will use Unicode symbols as appropriate in its menus.

For more info on using Unicode symbols, please refer to UX Conventions.

5.14.1 EWW Install ¶

In your initialization file, bind the Transient casual-eww-tmenu to your key binding of preference.

(keymap-set eww-mode-map "C-o" #'casual-eww-tmenu)

Do so similarly to access casual-eww-bookmarks-tmenu in the EWW bookmarks list.

(keymap-set eww-bookmark-mode-map "C-o" #'casual-eww-bookmarks-tmenu)

While not mandatory, the following bindings can make the EWW keymaps consistent with those used by Casual.

(keymap-set eww-mode-map "C-o" #'casual-eww-tmenu)
(keymap-set eww-mode-map "C-c C-o" #'eww-browse-with-external-browser)
(keymap-set eww-mode-map "j" #'shr-next-link)
(keymap-set eww-mode-map "k" #'shr-previous-link)
(keymap-set eww-mode-map "[" #'eww-previous-url)
(keymap-set eww-mode-map "]" #'eww-next-url)
(keymap-set eww-mode-map "M-]" #'eww-forward-url)
(keymap-set eww-mode-map "M-[" #'eww-back-url)
(keymap-set eww-mode-map "n" #'casual-lib-browse-forward-paragraph)
(keymap-set eww-mode-map "p" #'casual-lib-browse-backward-paragraph)
(keymap-set eww-mode-map "P" #'casual-eww-backward-paragraph-link)
(keymap-set eww-mode-map "N" #'casual-eww-forward-paragraph-link)
(keymap-set eww-mode-map "M-l" #'eww)

(keymap-set eww-bookmark-mode-map "C-o" #'casual-eww-bookmarks-tmenu)
(keymap-set eww-bookmark-mode-map "p" #'previous-line)
(keymap-set eww-bookmark-mode-map "n" #'next-line)
(keymap-set eww-bookmark-mode-map "<double-mouse-1>" #'eww-bookmark-browse)

5.14.2 EWW Usage ¶

In an EWW window, invoke casual-eww-tmenu as shown below.

The following sections are offered in the menu:

History

Commands for historical navigation.

Document

Commands for document navigation (<link rel="">) provided the HTML pages support it. HTML generated from Texinfo ((texinfo)Top) supports these commands.

Navigate

Commands to navigate within a page.

Link

Commands to navigate links within a page.

Misc

Miscellaneous commands.

URL

Commands associated with the current web page.

EWW Bookmarks

Commands associated with EWW bookmarks.

EWW Settings ¶

Customize common EWW settings from this menu. These settings can be persisted to be used across restarts of Emacs.

EWW Display ¶

The menu casual-eww-display-tmenu provides commands to toggle different display attributes of a web page.

EWW Bookmarks ¶

The menu casual-eww-bookmarks-tmenu provides commands for managing the EWW bookmark list.

Note that the EWW bookmarks list has a very limited feature set.

EWW Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual EWW will use Unicode symbols as appropriate in its menus.

For more info on using Unicode symbols, please refer to UX Conventions.

5.15.1 Help Install ¶

In your initialization file, bind the Transient casual-help-tmenu to your key binding of preference.

(keymap-set help-mode-map "C-o" #'casual-help-tmenu)

casual-help-tmenu deviates from the default bindings of help-mode-map as shown in the table below.

The following keybindings are recommended to support consistent behavior between help-mode and casual-help-tmenu.

(keymap-set help-mode-map "M-[" #'help-go-back)
(keymap-set help-mode-map "M-]" #'help-go-forward)
(keymap-set help-mode-map "p" #'casual-lib-browse-backward-paragraph)
(keymap-set help-mode-map "n" #'casual-lib-browse-forward-paragraph)
(keymap-set help-mode-map "P" #'help-goto-previous-page)
(keymap-set help-mode-map "N" #'help-goto-next-page)
(keymap-set help-mode-map "j" #'forward-button)
(keymap-set help-mode-map "k" #'backward-button)

5.15.2 Help Usage ¶

After invoking help via a describe- command, invoke casual-help-tmenu using the binding C-o (or your binding of preference).

The following sections are offered in the menu:

Navigation

Navigation commands with the document.

History

Navigate history of help invocations.

Link

Navigate to different references in the help buffer.

Describe

Get help for different Elisp types.

Info

If available, then open this help topic in Info.

Source

Show the Elisp source. If the help displayed is for a customizable variable, then show a customize menu item.

Help Mode Settings ¶

The menu casual-help-settings-tmenu provides access to different help-mode settings.

Help Mode Unicode Symbol Support ¶

By enabling “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.

5.16.1 HTML Install ¶

In your initialization file, bind the Transient casual-html-tmenu to your key binding of preference.

(keymap-set html-mode-map "M-m" #'casual-html-tmenu)

It is convenient to also bind casual-html-tags-tmenu as well.

(keymap-set html-mode-map "C-c m" #'casual-html-tags-tmenu)

The binding M-m is intended to complement the binding C-o used by EditKit.

If HTML Tree-sitter support is enabled, use the keymap html-ts-mode-map in place of html-mode-map.

5.16.2 HTML Usage ¶

The following sections are offered in the menu:

</>

SGML tag-related commands.

HTML

HTML tag-related commands.

Misc

Miscellaneous commands.

Navigation

Navigation commands.

Note that the item “d Delete” (bound to sgml-delete-tag) is not available when HTML Tree-sitter support is enabled.

HTML Tags ¶

This menu provides support for HTML tag-related commands provided by html-mode.

HTML Settings ¶

SGML/HTML mode related settings can be customized using the menu casual-html-settings-tmenu.

HTML Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual html will use Unicode symbols as appropriate in its menus.

For more info on using Unicode symbols, please refer to UX Conventions.

5.17.1 IBuffer Install ¶

In your initialization file, bind the Transinent casual-ibuffer-tmenu to your key binding of preference.

(keymap-set ibuffer-mode-map "C-o" #'casual-ibuffer-tmenu)

Like with Casual Dired, it is convenient to have the menus for filtering and sorting bound as well. Listed below shows an example of binding casual-ibuffer-filter-tmenu and casual-ibuffer-sortby-tmenu to F and s respectively.

(keymap-set ibuffer-mode-map "F" #'casual-ibuffer-filter-tmenu)
(keymap-set ibuffer-mode-map "s" #'casual-ibuffer-sortby-tmenu)

Use these keybindings to configure IBuffer to be consistent with keybindings used by Casual IBuffer.

(keymap-set ibuffer-mode-map "{" #'ibuffer-backwards-next-marked)
(keymap-set ibuffer-mode-map "}" #'ibuffer-forward-next-marked)
(keymap-set ibuffer-mode-map "[" #'ibuffer-backward-filter-group)
(keymap-set ibuffer-mode-map "]" #'ibuffer-forward-filter-group)
(keymap-set ibuffer-mode-map "$" #'ibuffer-toggle-filter-group)  

While not necessary for Casual IBuffer, enabling hl-line-mode and binding mouse clicks in IBuffer adds to a more comfortable IBuffer experience. Also, adding ibuffer-auto-mode to ibuffer-mode-hook will enable auto-updating.

(require 'hl-line)
(require 'mouse)
(add-hook 'ibuffer-mode-hook #'hl-line-mode)
(add-hook 'ibuffer-mode-hook #'ibuffer-auto-mode)
(keymap-set ibuffer-mode-map "<double-mouse-1>" #'ibuffer-visit-buffer)
(keymap-set ibuffer-mode-map "M-<double-mouse-1>" #'ibuffer-visit-buffer-other-window)

5.17.2 IBuffer Usage ¶

The main menu of Casual IBuffer (casual-ibuffer-tmenu) is organized into the following sections:

Operations

Commands to operate either on the buffer at point or on marked buffers.

Mark

Commands to support the marking of buffers.

Display

Commands to control the display of buffers. Buffers can be sorted by different criteria.

Navigation

Commands to navigate the buffer list.

Filter

Commands related to filtering/organizing buffers. Support for defining Filter Groups is provided here.

Find/Replace in Marked

Commands to search & replace text in marked buffers are provided here. Note that commands in this section that modify buffers do not save said buffers.

Quick

Command to jump to a bookmark.

• IBuffer Marking and Operating
• IBuffer Filtering
• IBuffer Sorting
• IBuffer Unicode Symbol Support

Next: IBuffer Filtering, Up: IBuffer Usage   [Contents][Index]

5.17.2.1 IBuffer Marking and Operating ¶

Buffers can be marked using different criteria. Marked buffers can be operated on. Common operations include saving and deleting buffers. Note that deleting a buffer populated with a visited file is not the same as deleting the visited file.

From the main menu shown above, control of the display and find/replace operations are offered.

Note that the menu item “RET Visit/Toggle” has “do what I mean” (DWIM) behavior. If the point is currently on a filter group (described below) then pressing the RET key will toggle the visibility of items matching that filter group. Otherwise, it will visit (open) the buffer.

As with other Casual user interfaces, the ability to jump to a bookmark is available.

---

Next: IBuffer Sorting, Previous: IBuffer Marking and Operating, Up: IBuffer Usage   [Contents][Index]

5.17.2.2 IBuffer Filtering ¶

IBuffer is embarrasingly rich in the ways it can filter buffers. Once mastered, IBuffer filtering offers a way to create different views on your buffer list, enabling you to tailor bespoke views for different workflows. Such capability comes with a price though: you’ll need to understand how IBuffer wants to organize filters.

Key is the concept of a Filter Group which is IBuffer’s analog to a Dired subdirectory ((emacs)Subdirectories in Dired). But whereas a subdirectory only maps to a file system directory, a filter group can be constructed from a diverse set of rules to categorize a buffer.

IBuffer organizes filtering with the following taxonomy:

1. Filter rule

   The smallest unit of filtering. There are many types of filter rules:

   • filter by major mode
   • filter by derived mode
   • filter by buffer name
   • filter by buffer content
   • filter by basename
   • filter by directory name
   • filter by filename
   • filter by file extension
   • filter by modified buffers
   • filter by an arbitrary Lisp predicate
   • filter by buffer size
   • filter by special buffers
   • filter by buffers visiting files

     Casual IBuffer makes the design decision to not enumerate the above in a menu, delegating the work of filter selection to the command ibuffer-filter-chosen-by-completion.

2. Filter

   A filter is a logical combination of filter rules. Logic operators such as AND (&), OR (|) and NOT (!) are used to compose rules into a filter. A single filter rule can also be construed as a filter.

   Properties of filters:

   • A filter can be defined and saved for subsequent use.
     • Filters are saved in the customizable variable ‘ibuffer-saved-filters’.
     • Multiple filters can be applied at the same time to a set of buffers.
   • Multiple filters are applied in LIFO order. Removing a filter is a “pop” operation.
     • Rules that are combined with a logic operator are treated as a single element of the LIFO stack.
     • To individually edit the combination, use the Decompose command to remove the logic operator first.
3. Filter Group

   A filter group is set of filters. The set itself is named with an identifier that is user-defined.

   Properties of filter groups:

   • A filter group can be defined and saved for subsequent use but with a special qualifier:
     • Filter groups are only saved as a collection (more below) in the customizable variable ‘ibuffer-saved-filter-groups’. A filter group can not be saved individually.
   • Multiple filter groups can be applied to partition the buffer list.
   • Multiple filter groups are applied in LIFO order. Removing a filter group is a “pop” operation.
     • Similar LIFO and decompose behavior applicable to a filter group is supported.
4. Filter Group Collection

   A collection is a set of filter groups that can be named with a user-defined identifier. Only one collection can be applied to a buffer list at a time. However, many different collections can be defined, allowing for different views of the same buffer list.

Creating Filters

The basic procedure for making a filter that applies to the entire buffer list is as follows:

1. From the Filter menu, create a filter via (SPC) Rule… and some desired combination of operators.
2. Save the filter via (s) Save…. You will be prompted to provide a name for the filter. This filter will be saved in the variable ‘ibuffer-saved-filters’.
3. To recall this filter at a subsequent time, use (r) Switch to… in the Add section of the Filter menu.

Creating a Collection of Filter Groups

Here is where the taxonomy becomes significant as the IBuffer command set unfortunately does not provide much observability on edit operations to filters.

1. Create a filter as described above.
2. In the Add section of the Filter menu, select (g) Create Filter Group… to convert the filter into a filter group. You will be prompted to name the filter group. This group name will be enclosed by square brackets [].
3. Multiple filter groups can be created by repeating steps 1 and 2 above. Note that when constructing a filter group, the IBuffer window will not provide observability of existing filter groups on the buffer list.
4. You can save the set of filter groups as a collection in the Collection section with the command (S) Save…. You will be prompted to name the collection. Note that only one collection can be used at a time in IBuffer.

Out of the box, it is best to think of the IBuffer commands for editing buffer filters as a kit of parts and an arguably incomplete one at that. The Casual IBuffer filter menu (‘casual-ibuffer-filter-tmenu’) is my attempt to build a comprehensible filter editor UI from this kit. Whether it succeeds in being comprehensible is left to user feedback.

---

Next: IBuffer Unicode Symbol Support, Previous: IBuffer Filtering, Up: IBuffer Usage   [Contents][Index]

5.17.2.3 IBuffer Sorting ¶

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.

---

5.18.1 Image Install ¶

The main menu for Casual Image is casual-image-tmenu. Bind this menu in the keymap image-mode-map as follows in your initialization file.

(keymap-set image-mode-map "C-o" #'casual-image-tmenu)

5.18.2 Image Usage ¶

The main menu for Casual Image (casual-image-tmenu) is organized into the following sections:

View

Commands to control the display of the image. None of these commands will mutate the image file.

Edit

Commands to edit the image file.

Scroll

Commands to scroll an image view that is larger than its window size.

Edge

Commands to navigate to the edges of an image view that is larger than its window size.

Traverse

Commands to navigate to other image files in the same directory as the current image.

Mark

Commands to mark in Dired the current image.

Misc

Miscellaneous commands.

• Image Resize
• Image Settings
• Image Unicode Symbol Support
• Image Mode Command Naming

Next: Image Settings, Up: Image Usage   [Contents][Index]

5.18.2.1 Image Resize ¶

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.

Note that if the image file has been modified, the resize interface will be disabled. Save the image file before resizing.

Image Resize Options ¶

• (g) Geometry - ImageMagick specifier for the resize geometry.
• (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.

---

Next: Image Mode Command Naming, Previous: Image Settings, Up: Image Usage   [Contents][Index]

5.18.2.3 Image Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual Image will use Unicode symbols as appropriate in its menus.

For more info on using Unicode symbols, please refer to UX Conventions.

---

5.19.1 Info Install ¶

The main menu for Casual Info is casual-info-tmenu. Bind this menu in the keymap Info-mode-map as follows in your initialization file.

(keymap-set Info-mode-map "C-o" #'casual-info-tmenu)

While not required, adding this configuration to your Emacs initialization file will synchronize keybindings between Casual Info and the Info reader. A nice visual improvement is to use hl-line-mode to highlight the line where the cursor is at. Enabling scroll-lock-mode will enable scrolling the buffer for content that is larger than its window size with the navigation keys.

;; # Info
;; Use web-browser history navigation bindings
(keymap-set Info-mode-map "M-[" #'Info-history-back)
(keymap-set Info-mode-map "M-]" #'Info-history-forward)
;; Bind p and n to paragraph navigation
(keymap-set Info-mode-map "p" #'casual-info-browse-backward-paragraph)
(keymap-set Info-mode-map "n" #'casual-info-browse-forward-paragraph)
;; Bind h and l to navigate to previous and next nodes
;; Bind j and k to navigate to next and previous references
(keymap-set Info-mode-map "h" #'Info-prev)
(keymap-set Info-mode-map "j" #'Info-next-reference)
(keymap-set Info-mode-map "k" #'Info-prev-reference)
(keymap-set Info-mode-map "l" #'Info-next)
;; Bind / to search
(keymap-set Info-mode-map "/" #'Info-search)
;; Set Bookmark
(keymap-set Info-mode-map "B" #'bookmark-set)

(add-hook 'Info-mode-hook #'hl-line-mode)
(add-hook 'Info-mode-hook #'scroll-lock-mode)

5.19.2 Info Usage ¶

Invoke M-x info to launch the Info reader. Move the point inside the Info window and invoke C-o (or a binding of your choosing) to launch the Casual Info menu.

The main menu for Casual Info is organized into the following sections:

Overview

Commands that navigate you to a starting point in the info documentation.

Goto

Commands that have you specify where to goto in the structure of an Info document.

Search

Commands for searching Info.

History

Commands related to the history of pages (nodes) navigated to in Info. Note that these commands should not be confused with structural navigation.

Scroll

Commands to scroll down or up the current Info page.

Navigation

Command related to structurally navigating an Info document. Note that these commands should not be confused with historical navigation.

Quick

Miscellaneous commands for working with an Info document. Included are commands for bookmarks, copying the current node name, and cloning the buffer.

Info Unicode Symbol Support ¶

By enabling “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.

5.20.1 I-Search Install ¶

The main menu for Casual I-Search is casual-isearch-tmenu. Bind this menu to C-o (or your binding of preference) in the keymap isearch-mode-map as follows in your initialization file.

(keymap-set isearch-mode-map "C-o" #'casual-isearch-tmenu)

5.20.2 I-Search Usage ¶

The main menu for Casual I-Search is organized into the following sections:

Edit Search String

Commands to edit the search string. The type/extent of the string (word, symbol, line, thing) can be specified here.

Replace

Invoke query-replace or query-replace-regexp on matched strings.

Toggle

Commands to configure the type of search. Toggling any menu item in this section will dismiss the Transient menu and return you back to the I-Search minibuffer prompt.

Misc

Miscellaneous commands. From here the search string can be fed into occur or be highlighted.

Navigation

Navigation commands for matched strings.

When in search mode (typically via the keybinding C-s or C-r), pressing the keybinding 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 C-g to dismiss this Transient menu.

I-Search Settings ¶

The menu casual-isearch-settings-tmenu provides access to different I-Search settings.

I-Search Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual I-Search will use Unicode symbols as appropriate in its menus.

For more info on using Unicode symbols, please refer to UX Conventions.

5.21.1 Make Install ¶

In your initialization file, bind the Transient casual-make-tmenu to your key binding of preference. Two suggested bindings are M-m or C-c m.

(keymap-set makefile-mode-map "M-m" #'casual-make-tmenu)

The binding M-m is intended to complement the binding C-o used by EditKit.

5.21.2 Make Usage ¶

It is recommended that some basic knowledge of the make command is known before using Casual Make.

When in a Makefile buffer, use M-m (or your binding of choice) to raise the menu casual-make-tmenu. You will be presented with a menu with the following sections:

Edit

Commands for editing the makefile. Note that the backslash and comment commands require a region to be selected.

Pickup as targets

Commands for synchronizing make-mode with the target definitions in the makefile. Use these commands to refresh the known list of targets.

Misc

Miscellaneous commands related to working with a makefile.

Navigate

Commands to support navigation within the makefile.

Unless you edit makefiles frequently, it is unlikely to recall what an automatic variable declaration means. Casual Make provides the command casual-make-identify-autovar-region to identify a region-selected automatic variable via the menu item “. Identify Auto Var” in casual-make-tmenu. A short description of the automatic variable is shown in the mini-buffer.

• Makefile Type Selection
• Automatic Variables
• Make Unicode Symbol Support

Next: Automatic Variables, Up: Make Usage   [Contents][Index]

5.21.2.1 Makefile Type Selection ¶

As there are different variants of make and makefile formats, you can configure the mode for different specific makefile types. This can be done by selecting “t Makefile Type›” in casual-make-tmenu.

The symbol for this menu is casual-make-mode-select-tmenu.

---

Next: Make Unicode Symbol Support, Previous: Makefile Type Selection, Up: Make Usage   [Contents][Index]

5.21.2.2 Automatic Variables ¶

Casual Make provides a menu to enter GNU Make-style automatic variables. Note that each keybinding is identical to the automatic variable it represents to both reinforce its declaration and to avoid making another mapping. This menu is available from the menu item “a Automatic Variables›” in casual-make-tmenu.

The symbol for this menu is casual-make-automatic-variables-tmenu.

---

5.22.1 Man Install ¶

In your initialization file, bind the Transient casual-man-tmenu to your key binding of preference.

(keymap-set Man-mode-map "C-o" #'casual-man-tmenu)

casual-man-tmenu deviates from the default bindings of Man-mode-map as shown in the table below.

The following keybindings are recommended to support consistent behavior between Man-mode and casual-man-tmenu.

(keymap-set Man-mode-map "n" #'casual-lib-browse-forward-paragraph)
(keymap-set Man-mode-map "p" #'casual-lib-browse-backward-paragraph)
(keymap-set Man-mode-map "[" #'Man-previous-section)
(keymap-set Man-mode-map "]" #'Man-next-section)
(keymap-set Man-mode-map "j" #'next-line)
(keymap-set Man-mode-map "k" #'previous-line)
(keymap-set Man-mode-map "K" #'Man-kill)
(keymap-set Man-mode-map "o" #'casual-man-occur-options)

5.22.2 Man Usage ¶

The Man page reader can be invoked via M-x man, where the user is prompted for a search key. This search key is typically the name of a command that has an associated Man page. In the Man page window, pressing C-o (or your binding of preference) will raise the menu casual-man-tmenu.

The following sections are offered in the menu:

Navigation

Navigation commands with the document.

Paragraph

Navigation commands by paragraph.

Section

Navigation commands by section.

Link

Jump to other Man pages referenced in the current Man page.

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.

Options Navigation ¶

casual-man-tmenu provides the menu item 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.

Man Settings ¶

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 , in casual-man-tmenu.

Press ‘s’ and configure Man-switches to have the value “-a” to get all manual pages.

Man Unicode Symbol Support ¶

By enabling “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.

5.23.1 Org Install ¶

In your initialization file, bind the Transient menus casual-org-tmenu and casual-org-table-fedit-tmenu to your key binding of preference.

(keymap-set org-mode-map "M-m" #'casual-org-tmenu)
(keymap-set org-table-fedit-map "M-m" #'casual-org-table-fedit-tmenu)

The binding M-m is intended to complement the binding C-o used by EditKit.

5.23.2 Org Usage ¶

Usage of Casual Org is primarily done through the Transient menu casual-org-tmenu. This menu dynamically adjusts with respect to where the point (cursor) is in an Org document’s structure (org#Document Structure). For example, if the point is in a headline the menu displayed will be different from that of a table.

Based on where the point is in an Org buffer, the following variants of casual-org-tmenu are supported:

• Headline
• Body
• List
• Table
• Block
• Keyword
• Property Drawer
• Property
• Drawer
• Clock Log

Many of the menu variants have a common set of command sections. These sections include:

Link

Commands related to Org links and citation.

Timestamp

Timestamp-related commands.

Clock

Clock-related commands.

Display

Display-related commands.

Mark

Structural-marking commands.

Util

Org utility commands.

Note that not all of these command sections are offered in all menu variants. This is because the design intent for Casual Org is to constrain choice based on context.

Navigation ¶

The menus in the Casual Org package (casual-org) are designed to allow for navigation of the current Org buffer using key bindings not used by the Casual menu. This means that basic Emacs point (cursor) navigation not involving the arrow keys will be available (emacs#Moving Point). It is also possible to inadvertently insert text when a Casual Org menu is raised. Accidental changes can be undone using the “U Undo” command.

To use Casual Org effectively, it is recommended that the user is familiar with Org outline editing (org#Structure Editing).

• Org Headline
• Org Body
• Org List
• Org Table
• Org Block
• Org Keyword
• Org Property Drawer
• Org Property
• Org Drawer
• Org Clock Log
• Org Settings

Next: Org Body, Up: Org Usage   [Contents][Index]

5.23.2.1 Org Headline ¶

When the point is in a headline (org#Headlines) the following command sections are displayed in casual-org-tmenu:

Headline

Commands that operate on a headline.

Add

Commands that add a headline.

Annotate

Commands that add annotations (metadata) to a headline.

Date

Date-related commands.

Priority

Prioritization-related commands.

Misc

Miscellaneous commands.

---

Next: Org List, Previous: Org Headline, Up: Org Usage   [Contents][Index]

5.23.2.2 Org Body ¶

If the point is in a part of an Org document that is not considered structure, this menu variant of casual-org-tmenu is displayed.

Variant-specific command sections provided are:

To

Commands to convert the Org element under point to either a heading or a list.

Add

Commands to add either a block, drawer, or keyword.

---

Next: Org Table, Previous: Org Body, Up: Org Usage   [Contents][Index]

5.23.2.3 Org List ¶

When the point is in a list item (org#Plain Lists), the following list-related commands are displayed in casual-org-tmenu:

a Add

Inserts a list item.

b To Checkbox

Converts a list item to a checkbox.

c Cycle

Changes the list style from a cycle of styles.

s Sort

Sorts the list given user-specified criteria.

If the point is at the very start of the list, then then certain commands like “b To Checkbox” will affect all items in the list.

Checkbox ¶

When an item is converted to a checkbox, the heading of the section changes from “Item” to “Checkbox”. The following two commands are added:

C-c Toggle

Toggle the checkbox from an unchecked ([ ]) to a checked ([X]) state or vice-versa.

- In Progress

Change a checkbox from an unchecked ([ ]) to an in-progress ([-]) state. Use the “C-c Toggle” command to reset from the in-progress state.

Use the “b To Item” command to revert a checkbox back to a plain item.

---

Next: Org Block, Previous: Org List, Up: Org Usage   [Contents][Index]

5.23.2.4 Org Table ¶

When the point is in a table (org#Tables) the following sections are displayed in casual-org-tmenu:

Table

Miscellaneous table-related commands.

Edit

Table-specific editing commands.

Region

Region-specific editing commands.

Compute

Table-specific compute commands.

Display

Table-specific display commands.

Table Formulas (TBLFM) ¶

If the point is on a TBLFM keyword (org#Field and range formulas), then the following menu variant of casual-org-tmenu is shown.

Org Table Layout ¶

From the Table section in casual-org-tmenu, selecting “l Layout” will raise the table layout menu (casual-org-table-structure-tmenu). Use this menu to make structural edits to the table.

Org Table Formula Edit ¶

When editing formulas for a table, the menu casual-org-table-fedit-tmenu can be raised to provide assistance with table references.

---

Next: Org Keyword, Previous: Org Table, Up: Org Usage   [Contents][Index]

5.23.2.5 Org Block ¶

When the point is in a block (org#Blocks) the following variant is displayed in casual-org-tmenu:

Numerous different block types are recognized by casual-org-tmenu. They are:

• Source (#+BEGIN_SRC)
• Example (#+BEGIN_EXAMPLE)
• Quote (#+BEGIN_QUOTE)
• Export (#+BEGIN_EXPORT)
• Center (#+BEGIN_CENTER)
• Verse (#+BEGIN_VERSE)

Org In Source Block ¶

If the point is within an Org source block, then the following menu variant is shown.

---

Next: Org Property Drawer, Previous: Org Block, Up: Org Usage   [Contents][Index]

5.23.2.6 Org Keyword ¶

When the point is in an Org keyword the following variant is displayed in casual-org-tmenu:

---

Next: Org Property, Previous: Org Keyword, Up: Org Usage   [Contents][Index]

5.23.2.7 Org Property Drawer ¶

This menu variant of casual-org-tmenu is shown when the point is on a property drawer (org#Properties and Columns).

With this menu, one can add a property.

---

Next: Org Drawer, Previous: Org Property Drawer, Up: Org Usage   [Contents][Index]

5.23.2.8 Org Property ¶

This menu variant of casual-org-tmenu is shown when the point is on a property (org#Property Syntax).

With this menu, one can either add another property or perform an action on the current property.

---

Next: Org Clock Log, Previous: Org Property, Up: Org Usage   [Contents][Index]

5.23.2.9 Org Drawer ¶

This menu variant of casual-org-tmenu is shown when the point is on a drawer (org#Drawers).

---

Next: Org Settings, Previous: Org Drawer, Up: Org Usage   [Contents][Index]

5.23.2.10 Org Clock Log ¶

This menu variant of casual-org-tmenu is shown when the point is on a clock log (org#Clocking commands).

Two command sections are provided:

Clock

Clock in or out of the current item.

Timestamp

If the point is on an Org timestamp, commands to adjust up or down a timestamp component (e.g. year, month, day) is provided.

---

Previous: Org Clock Log, Up: Org Usage   [Contents][Index]

5.23.2.11 Org Settings ¶

Use the Casual Org Settings menu to gain access to commonly customized Org settings.

Org Unicode Symbol Support ¶

By enabling “u Use Unicode Symbols” from the Settings menu, Casual Org will use Unicode symbols as appropriate in its menus.

---

5.24.1 RE-Builder Install ¶

The main menu for Casual RE-Builder is casual-re-builder-tmenu. Bind this menu to your preference in the keymaps reb-mode-map and reb-lisp-mode-map as follows in your initialization file.

(keymap-set reb-mode-map "C-o" #'casual-re-builder-tmenu)
(keymap-set reb-lisp-mode-map "C-o" #'casual-re-builder-tmenu)

5.24.2 RE-Builder Usage ¶

When the command re-builder is invoked, a buffer named “✳︎RE-Builder✳︎” is created. Activate Casual RE-Builder with the binding {{{kbd(C-o}}} (or one of your preference).

At the top of the menu shows the title “RE-Builder” with the target buffer enclosed in parenthesis. The regexp pattern will be applied to the target buffer. The target buffer can be changed with the “b Target buffer” menu item.

Emacs supports three different regexp syntax: 1) read, 2) string, 3) Rx. Use the “x Syntax” menu item to alter it. The current syntax is shown in parenthesis.

If multiple sub-expressions are in the regexp pattern, then they can be observed via the “s Subexp mode” menu item.

If the regexp pattern entered in “✳︎RE-Builder✳︎” finds multiple matches, a match can be navigated to via the “p Previous” and “n Next” menu items.

Exporting the Regexp Pattern ¶

Once a desired regexp pattern is defined, there are two menu items that can be used to export (copy) it to the kill-ring for further use.

• “w Interactive” will copy the regexp to the kill-ring so that it can be yanked in an interactive command that requires a regexp (e.g. query-replace-regexp).
  • This can only be used when the regexp syntax is set to string.
  • ❗️When yanking (typically C-y) a regexp into an interactive prompt, you must have the point/focus in the minibuffer prompt (typically via mouse). Otherwise the desired content can be altered with extra escaping.
• “c Code” will copy the regexp to the kill-ring so that it can be yanked into a Elisp code that requires a regexp argument.
• “g Interactive grep” will copy the regexp so that it can be used with command that take a GNU grep regex argument.
  • Example commands that do this are dired-do-find-regexp and dired-do-find-regexp-and-replace.
  • This command presumes that you have GNU grep installed and configured for use by Emacs.
  • ❗️At current this is an experimental feature. The regexp exported from RE-Builder may not work. If so please report an issue describing the desired regexp and the target text.
  • This can only be used when the regexp syntax is set to string.

Regexp Syntax Help ¶

The menu item i will invoke the Info page for regexp syntax with respect to the current syntax type.

Quitting RE-Builder ¶

Select “q Quit” to exit the RE-Builder tool.

RE-Builder Settings ¶

The menu casual-re-builder-settings-tmenu provides access to different RE-Builder settings.

RE-Builder Unicode Symbol Support ¶

By enabling “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.

5.25.1 Timezone Install ¶

Casual Timezone is configured as part of Casual EditKit in the Tools menu (casual-editkit-tools-tmenu). Refer to the EditKit Install section for instructions on how to install it.

The main menu for Casual Timezone can be invoked directly using M-x casual-timezone-tmenu.

5.25.2 Timezone Usage ¶

The main menu for Casual Timezone (casual-timezone-tmenu) offers the following commands:

• casual-timezone-local-time-to-remote (menu binding: l) will convert a local date to its equivalent in remote time zone.
• casual-timezone-remote-time-to-local (menu binding: r) will convert a date in a remote time zone to its local equivalent.
• casual-timezone-planner (menu binding: z) will generate a table comparing hours between the local and a remote time zone on a certain date. Multiple remote time zones can be specified.

Timezone Planner ¶

The command casual-timezone-planner will prompt the user for one or more time zones and a date to compare in tabular form the local time with the zones selected. Multiple time zones are comma-separated.

In this table, the point can be navigated using the p, n, TAB, and S-TAB bindings.

Use the T binding to copy the timestamp under the current point to the kill-ring. The t binding will copy all timestamps on the current line to the kill-ring.

• Timezone Formatting
• Planner Configuration
• Zoneinfo Database
• Timezone Settings
• Timezone Unicode Symbol Support