diff options
author | Aryadev Chavali <aryadev@aryadevchavali.com> | 2024-06-11 04:24:21 +0100 |
---|---|---|
committer | Aryadev Chavali <aryadev@aryadevchavali.com> | 2024-06-11 04:24:21 +0100 |
commit | 172be6aa784194cf573d8ad7f8148a604fb1a13b (patch) | |
tree | e204415f98ad68c7f59742f4453496a55294f32d /Emacs/.config/emacs/config.org | |
parent | ba4d0cabf5e4c9ef0cac1bf433092625625b28bd (diff) | |
download | dotfiles-172be6aa784194cf573d8ad7f8148a604fb1a13b.tar.gz dotfiles-172be6aa784194cf573d8ad7f8148a604fb1a13b.tar.bz2 dotfiles-172be6aa784194cf573d8ad7f8148a604fb1a13b.zip |
(Emacs/config)~Reworked introduction
Diffstat (limited to 'Emacs/.config/emacs/config.org')
-rw-r--r-- | Emacs/.config/emacs/config.org | 42 |
1 files changed, 36 insertions, 6 deletions
diff --git a/Emacs/.config/emacs/config.org b/Emacs/.config/emacs/config.org index 494a13b..5250da0 100644 --- a/Emacs/.config/emacs/config.org +++ b/Emacs/.config/emacs/config.org @@ -9,15 +9,45 @@ #+latex_class_options: [a4paper,12pt] * Introduction -Welcome to my Emacs configuration. This thing is quite big, but a lot -of it has been "write and forget" i.e. I've only needed to configure -it once. Sections tagged =WAIT= are currently unused, usually with -some reasoning given. +Welcome to my Emacs configuration. You may be confused by the fact +it's a readable document rather than some code; this file serves as +both documentation *and* code. Here's an example: +#+begin_src emacs-lisp +;; Copyright (C) 2024 Aryadev Chavali +;; All rights reserved. You may not distribute or modify this code +;; without explicit legal permission from the author "Aryadev Chavali" + +;; Welcome to my Emacs configuration. This file is considered +;; volatile i.e. any edits made to this file will be overwritten if +;; and when the configuration is compiled again. + +;; To propagate edits from this file to the literate document, call +;; (org-babel-detangle) while in the file. +#+end_src + +This is an Emacs Lisp code block, something you will see a *LOT* of +throughout. Each Emacs Lisp code block from this document is +collected, concatenated together then fed into a file (=config.el=). +This file is then evaluated by Emacs +[[file:init.el::+literate/load-config][at boot-up]]. + +My reason for using this rather than just a straight up code file was +mainly due to =org-mode=: it has many facilities for organising and +looking at text structurally. I could put the configuration for each +package under its own heading, within a neatly organised heading tree. +I can search these headings efficiently (even outside of Emacs by +using a regex). These things are semantically encouraged by org-mode, +whereas in a code file I'd have to enforce a standard on myself. + +Sections tagged =WAIT= are not compiled and are, hence, unused. +Usually I provide some reasoning as to why. A lot of code here is +essentially write and forget; nothing needs to change unless I find a +more efficient way to do things. Some sections border on blog posts justifying why I think they're good applications or giving some greater reasoning about my specific -configuration of a package. If you don't really want that, you may -tangle this file and just read the source code. +configuration of a package. That can be distracting, so tangling this +file and looking at the source code may be more helpful. * Basics Let's setup a few things: + My name and mail address |