Standardize module READMEs

modules/app/irc/README.org

@@ -1,11 +1,17 @@
-* :app irc
+#+TITLE: :app irc
 
 This module turns adds an IRC client to Emacs ([[https://github.com/jorgenschaefer/circe][~circe~)]] with native notifications ([[https://github.com/eqyiel/circe-notifications][circe-notifications]]).
 
-** Dependencies
+* Table of Contents :TOC:
+- [[#dependencies][Dependencies]]
+- [[#configure][Configure]]
+  - [[#pass-the-unix-password-manager][Pass: the unix password manager]]
+  - [[#emacs-auth-source-api][Emacs' auth-source API]]
+
+* Dependencies
 This module has no dependencies, besides =gnutls-cli= or =openssl= for secure connections.
 
-** Configure
+* Configure
 Use the ~:irc~ setting to configure IRC servers. Its second argument (a plist) takes the same arguments as ~circe-network-options~.
 
 #+BEGIN_SRC emacs-lisp :tangle no
@@ -19,7 +25,7 @@ Use the ~:irc~ setting to configure IRC servers. Its second argument (a plist) t
 
 *It is a obviously a bad idea to store auth-details in plaintext,* so here are some ways to avoid that:
 
-*** Pass: the unix password manager
+** Pass: the unix password manager
 [[https://www.passwordstore.org/][Pass]] is my tool of choice. I use it to manage my passwords. If you activate the [[/modules/tools/password-store/README.org][:tools password-store]] module you get an elisp API through which to access your password store.
 
 ~:irc~'s plist can use functions instead of strings. ~+pass-get-user~ and ~+pass-get-secret~ can help here:
@@ -46,7 +52,7 @@ But wait, there's more! This stores your password in a public variable which cou
 
 And you're good to go!
 
-*** Emacs' auth-source API
+** Emacs' auth-source API
 ~auth-source~ is built into Emacs. As suggested [[https://github.com/jorgenschaefer/circe/wiki/Configuration#safer-password-management][in the circe wiki]], you can store (and retrieve) encrypted passwords with it.
 
 #+BEGIN_SRC emacs-lisp :tangle no