From: Amin Bandali <amin@aminb.org>
Date: Sat, 21 Apr 2018 15:55:11 +0000 (-0400)
Subject: [emacs] add naming conventions
X-Git-Url: https://git.shemshak.org/~bandali/configs/commitdiff_plain/e4cd0d4952436f8fdc2c009aaf1a8d8ab25a8006?ds=inline

[emacs] add naming conventions
---

diff --git a/emacs/init.org b/emacs/init.org
index 5f96e69..5aa530e 100644
--- a/emacs/init.org
+++ b/emacs/init.org
@@ -59,6 +59,24 @@ file.
 ;; THIS FILE IS AUTO-GENERATED FROM `init.org'.
 #+end_src
 
+** Naming conventions
+
+The conventions below were inspired by [[https://github.com/hlissner/doom-emacs][Doom]]'s conventions, found
+[[https://github.com/hlissner/doom-emacs/blob/5dacbb7cb1c6ac246a9ccd15e6c4290def67757c/core/core.el#L3-L17][here]]. Naturally, I use my initials, =ab=, instead of =doom=.
+
+#+begin_src emacs-lisp :comments none
+;; Naming conventions:
+;;
+;;   ab-...   public variables or non-interactive functions
+;;   ab--...  private anything (non-interactive), not safe for direct use
+;;   ab/...   an interactive function; safe for M-x or keybinding
+;;   ab:...   an evil operator, motion, or command
+;;   ab|...   a hook function
+;;   ab*...   an advising function
+;;   ab@...   a hydra command
+;;   ab!...   a macro
+#+end_src
+
 * Initial setup
 :PROPERTIES:
 :CUSTOM_ID: initial-setup
@@ -101,9 +119,6 @@ Reset the variables back to default after init.
 	       ,load-file-name elapsed))))
 #+end_src
 
-Note that I'll be using my initials, =ab=, as a prefix for the
-variables and functions I define throughout my init file.
-
 ** Package management
 
 *** =straight.el=