(mostly small doc and comment changes)

firmware/keyboard/ergodox/layout/common/definitions.h

@@ -117,12 +117,14 @@ static _layout_t PROGMEM _layout;
  *   keypresses on this run of the function (see the documentation in
  *   ".../firmware/lib/timer.h" for more precisely what this means)
  *     - This is useful for defining things like sticky keys, if, e.g., you
-   *     want to make it so that you can press more than one and have none of
-   *     them release until the press of the next normal key.
+ *       want to make it so that you can press more than one and have none of
+ *       them release until the press of the next normal key.
  */
 static struct {
     bool tick_keypresses : 1;
-} _flags = { .tick_keypresses = true };
+} _flags = {
+    .tick_keypresses = true,
+};
 
 
 // ----------------------------------------------------------------------------

firmware/keyboard/ergodox/layout/common/keys.c.h

@@ -11,8 +11,6 @@
  * Meant to be included *only* by the layout using it.
  */
 
-// TODO: make a KF for windows/mac style unicode input
-
 // TODO: write a chordmak (or asetniop) layout, on top of a standard colemak
 // layout, using chained sticky keys for the modifiers
 

firmware/lib/timer.h

@@ -21,10 +21,10 @@
  *   counter and running any scheduled events).
  *
  * - A "timer" is a collection of related `...get...()`, `...schedule...()`,
- *   and `...tick...()` functions, all dealing with the same (not externally
- *   visible) variables.
+ *   and `...tick...()` functions, all dealing with the same (private)
+ *   variables.
  *
- * - For milliseconds
+ * - Table, for milliseconds
  *
  *     ---------------------------------------------------------------------
  *      number     highest value        in          in        in        in
@@ -90,15 +90,15 @@ void timer___tick_milliseconds (void);
  * - Should be called exactly once by `main()` before entering the run loop.
  */
 
-// === (group) get() ===
+// === (group) get ===
 /**                                           functions/(group) get/description
  * Return the number of "ticks" since the given timer was initialized
  * (mod 2^16)
  *
  * Members:
- * - `timer__get_cycles`
- * - `timer__get_keypresses`
- * - `timer__get_milliseconds`
+ * - `timer__get_cycles`: Counts the number of scan cycles
+ * - `timer__get_keypresses`: Counts the number of applicable key presses
+ * - `timer__get_milliseconds`: Counts real time milliseconds
  *
  * Returns:
  * - success: The number of "ticks" since the timer was initialized (mod 2^16)
@@ -153,7 +153,7 @@ void timer___tick_milliseconds (void);
  *   except within the first 2^8 milliseconds of the timer being initialized.
  */
 
-// === (group) schedule() ===
+// === (group) schedule ===
 /**                                      functions/(group) schedule/description
  * Schedule `function` to run in the given number of "ticks"
  *

firmware/lib/timer/event-list.h

@@ -14,6 +14,8 @@
  * Warnings:
  * - These functions are not safe for use within interrupt vectors.  Just in
  *   case you were tempted to try :)
+ *     - It is safe to `...append()` while `...tick()`ing though (as when a
+ *       function reschedules itself)
  */
 
 

firmware/main.c

@@ -41,8 +41,6 @@
 
 // ----------------------------------------------------------------------------
 
-// --- for main() loop ---
-
 bool (* is_pressed) [OPT__KB__ROWS][OPT__KB__COLUMNS]
           = &( bool [OPT__KB__ROWS][OPT__KB__COLUMNS] ){};
 bool (* was_pressed) [OPT__KB__ROWS][OPT__KB__COLUMNS]
@@ -53,9 +51,6 @@ uint8_t col;
 
 struct main__flags_t flags = { .update_leds = true };
 
-
-// ----------------------------------------------------------------------------
-// --- main() loop ------------------------------------------------------------
 // ----------------------------------------------------------------------------
 
 /**                                                  functions/main/description