summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--blendoit/blendoit-init.org54
-rw-r--r--blendoit/blendoit-init.pdfbin245818 -> 246844 bytes
2 files changed, 36 insertions, 18 deletions
diff --git a/blendoit/blendoit-init.org b/blendoit/blendoit-init.org
index c0b55e4..95d634c 100644
--- a/blendoit/blendoit-init.org
+++ b/blendoit/blendoit-init.org
@@ -1,4 +1,4 @@
-#+TITLE: My literate GNU Emacs config
+#+TITLE: My Literate GNU Emacs Config
#+AUTHOR: Marius Peter
#+DATE: <2020-07-23 Thu>
#+EMAIL: blendoit@gmail.com
@@ -22,13 +22,22 @@ this is the endgame of \textit{literate programming}.
#+LATEX: \end{abstract}
* Introduction
-:PROPERTIES:
-:UNNUMBERED: t
-:END:
-The following sections were laid out very deliberately, so that our Emacs Lisp
-environment loads in a logical fashion. For instance, we only begin loading
-packages once we ensured ~use-package~ was working properly.
+The following sections were laid out very deliberately. When we start Emacs,
+Emacs Lisp source blocks contained in this document are evaluated
+sequentially. This means that our editing environment is bootstrapped at every
+Emacs startup! For instance, we only begin loading packages once we ensured
+~use-package~ is working properly.
+
+Customizing Emacs goes far, far beyond this document---feel free to experiment
+and discover.
+
+- ~C-h f~ describe function
+- ~C-h v~ describe variable
+- ~C-h k~ describe key
+
+These three commands will attempt to describe the element currently under our
+cursor, however you can start typing to search for another symbol.
* TODO First-time setup
@@ -82,8 +91,8 @@ activated.
** Profiling --- start
-We start the profiler now , and will interrupt it in section [[Profiling ---
-stop]]. We will then present profiling report in section [[Profiling --- report]].
+We start the profiler now , and will interrupt it in Section [[Profiling ---
+stop]]. We will then present profiling report in Section [[Profiling --- report]].
#+NAME: profiler-start
#+BEGIN_SRC emacs-lisp
@@ -246,7 +255,15 @@ It seems that starting with Emacs 27.1, Control + mousewheel works.
Packages are collections of =.el= files providing added functionality to Emacs.
-** Package archives
+** Meta
+
+How do we bootstrap packages? First, let's figure out:
+
+1. Where we get our packages from
+2. How we upgrade packages
+3. How we ensure our required packages are installed
+
+*** Package archives
List of package archives.
@@ -258,7 +275,7 @@ List of package archives.
(package-initialize)
#+END_SRC
-** TODO Convenient package update
+*** TODO Convenient package update
One-function rollup of upgradeable package tagging, download and lazy install.
@@ -266,10 +283,10 @@ One-function rollup of upgradeable package tagging, download and lazy install.
#+END_SRC
-** ~use-package~
+*** ~use-package~
-First and foremost, we ensure =use-package= is installed, as well as all
-packages described in this configuration file.
+We ensure =use-package= is installed, as well as all packages described in this
+configuration file.
#+BEGIN_SRC emacs-lisp
(unless (package-installed-p 'use-package)
@@ -281,10 +298,11 @@ packages described in this configuration file.
(require 'bind-key)
#+END_SRC
-** ~delight~
+*** ~delight~
With this package, we suppress the mention of certain minor modes in the mode
-line/powerline.
+line/powerline. We include it in Meta (cf. [[Meta]]) because it concerns all
+other packages.
#+BEGIN_SRC emacs-lisp
(use-package delight)
@@ -481,7 +499,7 @@ Syntax highlighting for Emacs.
(add-hook 'text-mode-hook 'flyspell-mode)
#+END_SRC
-*** ~yas-nippet~
+*** ~yasnippet~
#+NAME: yasnippet
#+BEGIN_SRC emacs-lisp
@@ -664,7 +682,7 @@ This highlights hexadecimal numbers which look like colors, in that same color.
:delight)
#+END_SRC
-* Theme
+* Themes
We load my custom theme.
diff --git a/blendoit/blendoit-init.pdf b/blendoit/blendoit-init.pdf
index a97ab4d..845bedc 100644
--- a/blendoit/blendoit-init.pdf
+++ b/blendoit/blendoit-init.pdf
Binary files differ
Copyright 2019--2024 Marius PETER