+usage

README.md

@@ -40,6 +40,16 @@ the first line of a config file:
 
     # -*-config-general-*-
 
+### Usage
+
+Edit your config  file as usual. Use <kbd>tab</kbd>  for completion of
+values and  variables. Use  <kbd>C-c C-t</kbd>  to toggle  flags (like
+true to  false). Use <kbd>C-c  C-=</kbd> on a region  to automatically
+align on the `=` character. Use <kbd>C-c C-/</kbd> to breakup a region
+with  long lines  into  shorter ones  using  backslash notation.   Use
+<kbd>C-return</kbd> to visit an included file  or (when not on a link)
+insert a new line below the current one, indent and move point there.
+
 ### Customize
 
 You can customize the mode with:

config-general-mode.el

@@ -61,6 +61,16 @@
 
 ;;     # -*-config-general-*-
 
+;;;; Usage
+
+;; Edit  your config  file as  usual.  Use `<tab>'  for completion  of
+;; values and variables.  Use `C-c C-t' to toggle flags  (like true to
+;; false). Use `C-c C-=' on a region to automatically align on the `=`
+;; character. Use `C-c  C-/' to breakup a region with  long lines into
+;; shorter ones  using backslash notation.  Use  `<C-return>' to visit
+;; an included file  or (when not on  a link) insert a  new line below
+;; the current one, indent and move point there.
+
 ;;;; Customize
 
 ;; You can customize the mode with: