aboutsummaryrefslogtreecommitdiffstats
path: root/keyboards/planck
diff options
context:
space:
mode:
authorChristopher Browne <cbbrowne@acm.org>2019-03-05 15:22:51 -0500
committerMechMerlin <30334081+mechmerlin@users.noreply.github.com>2019-03-05 12:22:51 -0800
commitdbfbe0d7f0d829fdebb3be5dff1c1dcc4b677568 (patch)
tree30f0f2ba52a8ca4f645e2216eebb58f0be8d7348 /keyboards/planck
parent8c2a23dee16077b5906ea090cd6fac268d0079f2 (diff)
downloadfirmware-dbfbe0d7f0d829fdebb3be5dff1c1dcc4b677568.tar.gz
firmware-dbfbe0d7f0d829fdebb3be5dff1c1dcc4b677568.tar.bz2
firmware-dbfbe0d7f0d829fdebb3be5dff1c1dcc4b677568.zip
Adopted LAYOUT, added some keys (#5320)
* Add HOME/END keys as upper/lower on arrow-up/down * Reduce .hex file size by turning off unneeded options * Put digit keypad onto left hand upon RAISE; this will sometimes be preferable to double-hits of right hand * Latest super latest version merge * cbbrowne keymap for XD75re * starting notes on XD75re keymap plans * First draft of bottom row of QWERTY * Switch my special bottom line over to QCENT * Dunno * Filling in wanted keys, bit by bit... * Add copyright, extra macro * Clean up comments, remove some experimental code I didn't like * TODO plans for xd75re * clean up keyboard layout * QCENT2 is my new experiment for the main keyboard... * Add a few more main layer keys, and modify LOWER to shift things outwards to conform with main layer * Clean up RAISE layer to conform with main layer, remove QCENT layer as QCENT2 is the new thing * More xd75 changes, now that I actually have it in hand * shift keymap around, as original attempt was a bit too aggressive in keeping to the edges * more revs to XD75 * Dropping parts of the centre keypad in favor of Keys I Really Need * Improve documentation to conform with how builds are done now * Improve documentation to conform with how builds are done now * Add cbbrowne rules file as alternative to having the rules in Makefile * Makefile not needed anymore for individual keymap * Some revs to my keymapping * Add {} * Add PGUP/PGDN * Shifted some middle-range keys around * Needed Tilde, Backquote, and to shift RESET onto FUNCTION layer * Wanted ~ * cbbrowne hasn't anything to do with hadron keymaps * trim unneeded bits * I prefer OrgMode for my notes * Have a right-alt * Layer keys make LED colors change * Add sample user rules for cbbrowne * Add source of xd75 rules * Individualized xd75 rules * Adopt LAYOUT to genericize the layout as an ortholinear 5x15 keyboard
Diffstat (limited to 'keyboards/planck')
-rw-r--r--keyboards/planck/keymaps/cbbrowne/readme.org (renamed from keyboards/planck/keymaps/cbbrowne/readme.md)63
1 files changed, 29 insertions, 34 deletions
diff --git a/keyboards/planck/keymaps/cbbrowne/readme.md b/keyboards/planck/keymaps/cbbrowne/readme.org
index e55b130ef..2b1005858 100644
--- a/keyboards/planck/keymaps/cbbrowne/readme.md
+++ b/keyboards/planck/keymaps/cbbrowne/readme.org
@@ -1,20 +1,18 @@
-cbbrowne custom keyboard
-==============================
+* cbbrowne custom keyboard
-Due to cbbrowne@acm.org
-Christopher Browne
+ Due to cbbrowne@acm.org
+ Christopher Browne
-This was originally based on the default keyboard map, but I have been
-doing sundry experimentation:
+ This was originally based on the default keyboard map, but I have
+ been doing sundry experimentation:
-1. Useful Experiments
-----------------------------------------
+** Useful Experiments
- * It made sense to mess around some with keyboard maps.
+ - It made sense to mess around some with keyboard maps.
- I added a keypad, originally based on keymaps/numpad.c, but
mighty substantially revised, as that one seems to be rotated 90
degrees from usual conventions for number pads
- * The keypad layer also includes some sample "hacks" of cool things,
+ - The keypad layer also includes some sample "hacks" of cool things,
all using actions attached in using the function action_get_macro()
- Key [1][2] aka "q" types out my name, cbbrowne, as a fun example
of a key generating a bunch of keystrokes. The keystroke is
@@ -24,7 +22,7 @@ doing sundry experimentation:
- Key [2][2] aka "a" uses a random number generator to select a digit 0-9 at random
- Key [3][2] aka "z" uses a random number generator to select a letter a-z at random
- Key [1][3] aka "e" spits out the keymap version number
- * Trying out sgoodwin's "hold Enter down to get Shift"
+ - Trying out sgoodwin's "hold Enter down to get Shift"
- Liking this Quite Well Enough...
- Applied this to both Shift and Quote
- It seems likely that Alt should get a right-hand-side, akin to this...
@@ -33,11 +31,11 @@ doing sundry experimentation:
- Emacs likes this!!! :-)
- I'm suspicious that I'll want to shift ROT_LED another location over,
so some modifier can replace the OS/KC_LGUI key
- * I have added an alternate ADJUST layer that is activated via update_tri_layer()
+ - I have added an alternate ADJUST layer that is activated via update_tri_layer()
- e.g. - LOWER+RAISE simultaneously
- This seems entirely more useful for handling my "special keys"
like the random numbers, user name, and such, than the keypad layer
- * The _ADJUST layer provides a good place to have RESET
+ - The _ADJUST layer provides a good place to have RESET
- But this isn't strictly enough; I want RESET somewhat accessible from
main layer lest an error hide that layer
- I never use the OS/KC_LGUI key (that's Command on MacOS, Windows
@@ -45,8 +43,7 @@ doing sundry experimentation:
some sort
-2. Some code structure ideas
----------------------------------------------------
+** Some code structure ideas
Each layer is given a name to aid in readability, which is then
used in the keymap matrix below. The underscores do not denote
@@ -65,57 +62,55 @@ doing sundry experimentation:
to care (beyond "start at 0", and arguably even that's not needed)
about their values.
-3. Things I did not like about the default mapping
----------------------------------------------------------
+** Things I did not like about the default mapping
- * I found control too hard to get to. I use it more than Tab, so
+
+ - I found control too hard to get to. I use it more than Tab, so
switched it there.
- * Having dash on [lower-j] is a bit nonintuitive, but may be OK
- * I switched ESC/TAB/M(0) around
- * I'm suspicious that I want to shift M(0) from [4][1] to [4][2],
+ - Having dash on [lower-j] is a bit nonintuitive, but may be OK
+ - I switched ESC/TAB/M(0) around
+ - I'm suspicious that I want to shift M(0) from [4][1] to [4][2],
and shift ESC off the first column so KC_LCTL and KC_LALT can
be on the first column.
- * I needed to swap ' and ENTER
+ - I needed to swap ' and ENTER
-4. Unuseful experiments
----------------------------------------------------------
+** Unuseful experiments
I have tried some things out that didn't turn out particularly well.
I'll note some of these for posterity, hopefully helpful in not doing
unwise things again...
- * I tried added Workman alongside Dvorak and Colemak
+ - I tried added Workman alongside Dvorak and Colemak
- Boy, oh boy, these don't help!!!
- I have done 30 years of learning of Emacs key mappings, and
these alternative keyboards massively mess me up
- * Space Cadet Shift; switching L_SHIFT to KC_LSP0, so that when I
+ - Space Cadet Shift; switching L_SHIFT to KC_LSP0, so that when I
just hit SHIFT, I get a left parens. In principle, this is great
for Lisping.
- Unfortunately, there are times when mouse interfaces use SHIFT
to allow selecting multiple items, and this really interferes
with that
-5. TODO
----------------------------------------------------------
+** TODO
- * I use tmux quite a lot; the mollat keymap seems to have some
+ - I use tmux quite a lot; the mollat keymap seems to have some
interesting helpers. It might be interesting to add a "tmux
layer," or to have a few keys in a layer oriented towards that
- Keys for...
- Picking windows 0 thru 8
- next/prev/new window
- * The mollat tmux layer also suggests some thoughts about Emacs
+ - The mollat tmux layer also suggests some thoughts about Emacs
helpers.
- * I do not presently have anything that handles X11 screen
+ - I do not presently have anything that handles X11 screen
switching, as with Control-Alt-various
- * I ought to probably look into KC_LEAD, to have some key combos
+ - I ought to probably look into KC_LEAD, to have some key combos
that do not need to be concurrent
- * The jeebak keymap seems to have some neat ideas:
+ - The jeebak keymap seems to have some neat ideas:
- Number layer which is aggressive about having numbers in several places
- TouchCursor layer seems interesting
- It sets up a layer with cursor keys on the home keys
- * The jeremy-dev keymap has some very interesting concepts
+ - The jeremy-dev keymap has some very interesting concepts
- Shift hands outwards; the special keys go in the center
- Symbol layer has some compound keys for C operators like /=, *=, -=, +=, ...
- This is likely what I'll use for my XD75re, and maybe I'll fork a