[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/ergoemacs-mode dc2f666 54/87: Add info on how to get sy
From: |
Stefan Monnier |
Subject: |
[elpa] externals/ergoemacs-mode dc2f666 54/87: Add info on how to get system-wide Ergoemacs bindings in macOS |
Date: |
Wed, 14 Apr 2021 18:47:07 -0400 (EDT) |
branch: externals/ergoemacs-mode
commit dc2f666db5ae9f7a65a7cb8ca0f36ce5a82f4338
Author: Marlon Richert <marlonrichert@users.noreply.github.com>
Commit: Marlon Richert <marlonrichert@users.noreply.github.com>
Add info on how to get system-wide Ergoemacs bindings in macOS
Also clean up and correctly renumber the section headings in
ergoemacs-mode.info
---
ergoemacs-mode.info | 106 +++++++++++++++++++++++++++++++++++++---------------
1 file changed, 76 insertions(+), 30 deletions(-)
diff --git a/ergoemacs-mode.info b/ergoemacs-mode.info
index 32e637f..da0e500 100644
--- a/ergoemacs-mode.info
+++ b/ergoemacs-mode.info
@@ -379,7 +379,14 @@ anything that enters the minibuffer removes the movement
mode. - Any
undefined key in the keymap (like 1) would exit the mode and insert the
character - Shift and the key is the unshifted command. Therefore
[Menu] [i] [i] [Shift+k] would be Page Up followed by down one
-character. ## Layouts Supported ## Tips for adopting ErgoEmacs
+character.
+
+1.5 Layouts Supported
+=====================
+
+1.6 Tips for adopting ErgoEmacs
+===============================
+
Keybindings If you are a long time emacs user, you may find it painful
to adopt this setup.
@@ -390,7 +397,7 @@ changing muscle memory.
File: ergoemacs-mode.info, Node: Where Did My Command Go?, Next: Shortcut To
Open Cheatsheet, Prev: Ergoemacs Key Chord Reduction, Up: Banish Key Chords
-1.4.4 Where Did My Command Go?
+1.6.1 Where Did My Command Go?
------------------------------
The ergonomic-mode minor mode features the command
@@ -401,16 +408,24 @@ Emacs, and the new shortcut for it under ErgoEmacs?.
File: ergoemacs-mode.info, Node: Shortcut To Open Cheatsheet, Prev: Where
Did My Command Go?, Up: Banish Key Chords
-1.4.5 Shortcut To Open Cheatsheet
+1.6.2 Shortcut To Open Cheatsheet
---------------------------------
You can open a cheatsheet by pressing [Control+h] [']. On the first
run, this will create a svg and (possibly) create a png based on the
svg (if `ergoemacs-inkscape' points to the inkscape executable). Once
these are created, the cheatsheet will be opened displaying all the
-keys based on your layout. ### Gradual Adoption for an Emacs User
-Here's some tips that may help you adopt. #### Level 1 If you find it
-too painful to switch, don't use the whole package. Instead, start off
+keys based on your layout.
+
+1.6.3 Gradual Adoption for an Emacs User
+----------------------------------------
+
+Here's some tips that may help you adopt.
+
+1.6.3.1 Level 1
+...............
+
+If you find it too painful to switch, don't use the whole package. Instead,
start off
with just the arrow key movements.
(setq ergoemacs-variant "lvl1") (ergoemacs-mode 1)
@@ -437,7 +452,7 @@ adopt.
File: ergoemacs-mode.info, Node: Level 2, Next: Level 3, Up: Shortcut To
Open Cheatsheet
-1.4.5.1 Level 2
+1.6.3.2 Level 2
...............
Adding keys for moving around words and deleting words.
@@ -447,7 +462,7 @@ Adding keys for moving around words and deleting words.
File: ergoemacs-mode.info, Node: Level 3, Next: Full Ergoemacs Keys, Prev:
Level 2, Up: Shortcut To Open Cheatsheet
-1.4.5.2 Level 3
+1.6.3.3 Level 3
...............
Full ergoemacs keyset without the unchorded keys.
@@ -457,8 +472,8 @@ Full ergoemacs keyset without the unchorded keys.
File: ergoemacs-mode.info, Node: Full Ergoemacs Keys, Next: Guru, Prev:
Level 3, Up: Shortcut To Open Cheatsheet
-1.4.5.3 Full Ergoemacs Keys
-...........................
+1.6.3.4 Full Ergoemacs Keys
+............................
Try to use the full ergoemacs mode.
@@ -467,8 +482,8 @@ Try to use the full ergoemacs mode.
File: ergoemacs-mode.info, Node: Guru, Next: Master, Prev: Full Ergoemacs
Keys, Up: Shortcut To Open Cheatsheet
-1.4.5.4 Guru
-............
+1.6.3.5 Guru
+.............
The guru variant takes away the arrow keys and page up/page down keys.
@@ -477,7 +492,7 @@ The guru variant takes away the arrow keys and page up/page
down keys.
File: ergoemacs-mode.info, Node: Master, Prev: Guru, Up: Shortcut To Open
Cheatsheet
-1.4.5.5 Master
+1.6.3.6 Master
..............
The Master variant takes away the backspace. This key is not
@@ -490,7 +505,7 @@ everywhere.
File: ergoemacs-mode.info, Node: Changing key layouts or adding variants,
Next: Ergoemacs Keys System wide, Prev: Banish Key Chords, Up: Ergoemacs
Keybindings
-1.5 Changing key layouts or adding variants
+1.7 Changing key layouts or adding variants
===========================================
* Menu:
@@ -500,17 +515,25 @@ File: ergoemacs-mode.info, Node: Changing key layouts or
adding variants, Next
File: ergoemacs-mode.info, Node: Globally defined keys, Up: Changing key
layouts or adding variants
-1.5.1 Globally defined keys
+1.7.1 Globally defined keys
---------------------------
These keys are defined on the global keymap and should be retained
regardless of the variant or layout used. However, these keys will not
show up on keyboard documentation generated by ergoemacs. Additionally,
-these keys may be masked or remapped by other programs. ### Ergoemacs
-defined keys These keys are defined in the ergoemacs-keymap. When the
+these keys may be masked or remapped by other programs.
+
+1.7.2 Ergoemacs defined keys
+----------------------------
+
+These keys are defined in the ergoemacs-keymap. When the
layout changes by changing options, these keys are lost. However, you
-may create your own variant to allow these keys to be saved. ####
-Adding a ergonomic key Ergonomic keys can be added by:
+may create your own variant to allow these keys to be saved.
+
+1.7.2.1 Adding a ergonomic key
+..............................
+
+Ergonomic keys can be added by:
(ergoemacs-key "M-a" 'execute-extended-command "Execute")
@@ -519,7 +542,12 @@ layout. This only applies to the currently selected
keyboard variant.
Note the last parameter is optional and allows Ergoemacs to document
that this is an "Execute" command when generating keyboard layout
-diagrams. #### Adding a fixed key Fixed keys can be added by:
+diagrams.
+
+1.7.2.2 Adding a fixed key
+..........................
+
+Fixed keys can be added by:
(ergoemacs-fixed-key "C-o" 'ido-find-file "Open File")
@@ -536,7 +564,7 @@ that this is an "Open" command when generating keyboard
layout diagrams.
File: ergoemacs-mode.info, Node: Adding an ergonomic key map with fixed
mappings, Next: Creating a keyboard variant, Up: Globally defined keys
-1.5.1.1 Adding an ergonomic key map with fixed mappings
+1.7.2.3 Adding an ergonomic key map with fixed mappings
.......................................................
When you want to add an ergonomic keymap with fixed mappings such as
@@ -550,13 +578,13 @@ save buffer
File: ergoemacs-mode.info, Node: Creating a keyboard variant, Prev: Adding
an ergonomic key map with fixed mappings, Up: Globally defined keys
-1.5.1.2 Creating a keyboard variant
+1.7.2.4 Creating a keyboard variant
...................................
File: ergoemacs-mode.info, Node: Ergoemacs Keys System wide, Prev: Changing
key layouts or adding variants, Up: Ergoemacs Keybindings
-1.6 Ergoemacs Keys System wide
+1.8 Ergoemacs Keys System wide
==============================
* Menu:
@@ -569,19 +597,33 @@ File: ergoemacs-mode.info, Node: Ergoemacs Keys System
wide, Prev: Changing ke
File: ergoemacs-mode.info, Node: Bash, Next: Windows, Up: Ergoemacs Keys
System wide
-1.6.1 Bash
+1.8.1 Bash
----------
File: ergoemacs-mode.info, Node: Windows, Next: Extras, Prev: Bash, Up:
Ergoemacs Keys System wide
-1.6.2 Windows
+1.8.2 Windows
-------------
In windows some of the ergoemacs keys are implemented system wide by
assuming apps follow the CUA-style keys like CTRL-f for find, CTRL-h
for replace. This also optionally implements: - CapsLock as Menu in
-emacs ### Mac OS X ## Developer information ### Layouts All the layouts
+emacs
+
+1.8.2 macOS
+-----------
+[Ergoemacs for
Karabiner-Elements](https://twitter.com/MarlonRichert/status/1240279799484071936)
+implements system-wide support for [levels 1 and 2](#toc20) of Ergoemacs (plus
some additional keys from
+level 3).
+
+1.9 Developer information
+=========================
+
+1.9.1 Layouts
+-------------
+
+All the layouts
in ergoemacs are easy to generate. To add your own personal layout you
just need to match the keybindings for your in a layout variable from
`ergoemacs-layout-XXX'. For the US and UK layouts, the defining
@@ -610,14 +652,18 @@ and shifted states of he keyboard. After listing the
keyboard
descriptions it provides a description of the layout which is used for
the customization variable `ergoemacs-keyboard-layout'. By simply
defining your layout before ergoemacs-mode is loaded, you add it to the
-ergoemacs-keyboard-layout variable with its description. ###
-Customizing/Saving the variables You can customize the ergoemacs
+ergoemacs-keyboard-layout variable with its description.
+
+1.9.2 Customizing/Saving the variables
+--------------------------------------
+
+You can customize the ergoemacs
keybindings by typing M-x customize-group ergoemacs-mode
File: ergoemacs-mode.info, Node: Extras, Next: Updating Ergoemacs for the
latest version of emacs, Prev: Windows, Up: Ergoemacs Keys System wide
-1.6.3 Extras
+1.9.3 Extras
------------
To generate keyboard binding diagrams and scripts that allow you to use
@@ -633,7 +679,7 @@ layout variant.
File: ergoemacs-mode.info, Node: Updating Ergoemacs for the latest version of
emacs, Prev: Extras, Up: Ergoemacs Keys System wide
-1.6.4 Updating Ergoemacs for the latest version of emacs
+1.9.4 Updating Ergoemacs for the latest version of emacs
--------------------------------------------------------
To tell if a key was a globally defined emacs key, ergoemacs needs to
- [elpa] externals/ergoemacs-mode 4710b5f 14/87: Fix eating of the variable, (continued)
- [elpa] externals/ergoemacs-mode 4710b5f 14/87: Fix eating of the variable, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode daec6a1 38/87: May Fix Issue #453, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 7b06006 44/87: Merge pull request #465 from MicroAnibal/FixLayoutsTypo, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 3e6fea9 41/87: Possibly fix #453, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 6231ee0 47/87: Merge pull request #468 from m00natic/emacs26-fixes, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode d5d7e5b 26/87: Partial fix for C-c and C-x. See Issue #444, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 7d36565 53/87: Merge pull request #481 from TinaRussell/exclude-more-hooks, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 4e188fd 46/87: Escape quotes on use as characters in, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 131b3fb 62/87: Fix command-loop errors, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 2091646 65/87: Merge pull request #497 from wlandry/space_in_filenames, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode dc2f666 54/87: Add info on how to get system-wide Ergoemacs bindings in macOS,
Stefan Monnier <=
- [elpa] externals/ergoemacs-mode 4a6ba06 55/87: Merge pull request #488 from marlonrichert/macos, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode aa649b2 52/87: Add hooks to ergoemacs-map-properties--modify-run-mode-hooks-excluded, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode ade132c 67/87: Remap ergoemacs-paste to calc-yank in calc-mode, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 26c2150 68/87: Merge pull request #498 from wlandry/calc_yank, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 8b437ad 70/87: Merge pull request #500 from wlandry/term_fixes, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode c7907aa 69/87: In term-mode, modify both term-raw-map and current-local-map, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode ea9b60f 71/87: Make the bash bindings work, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 72b0292 72/87: Make ergoemacs-handle-ctl-c-or-ctl-x==only-C-c-and-C-x work, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode bd805c3 80/87: More suppression of warnings, Stefan Monnier, 2021/04/14
- [elpa] externals/ergoemacs-mode 081fcbd 84/87: Fix #503, Stefan Monnier, 2021/04/14