(Emacs/config)~Cleaned up some descriptions

1 files changed, 61 insertions, 36 deletions

diff --git a/Emacs/.config/emacs/config.org b/Emacs/.config/emacs/config.org
index 4badc6f..e77f573 100644
--- a/Emacs/.config/emacs/config.org
+++ b/Emacs/.config/emacs/config.org
@@ -2207,11 +2207,16 @@ to elfeed for loading the system.
 #+end_src
 ** Magit
 Magit is *the* git porcelain for Emacs, which perfectly encapsulates
-the git cli.  In this case I just need to setup the bindings for it.
-As magit will definitely load after evil (as it must be run by a
-binding, and evil will load after init), I can use evil-collection
-freely.  Also, define an auto insert for commit messages so that I
-don't need to write everything myself.
+the git CLI.  It's so good that some people use Emacs just to use it.
+It's difficult to describe well without using it, in my opinion, and
+it integrates so well with Emacs that there is very little need to use
+the git CLI ever.
+
+In this case I just need to setup the bindings for it.  As magit will
+definitely load after evil (as it must be run by a binding, and evil
+will load after init), I can use evil-collection freely.  Also, define
+an auto insert for commit messages so that I don't need to write
+everything myself.
 
 #+begin_src emacs-lisp
 (use-package magit
@@ -2288,21 +2293,26 @@ Core proced config, just a few bindings and evil collection setup.
 ** Calculator
 Surprise, surprise Emacs comes with a calculator.
 
-Greater surprise, this thing is over powered.  It can perform the
-following (and more):
-- Matrix calculations
-- Generalised calculus operations
-- Equation solvers for n-degree multi-variable polynomials
-- Embedded mode (check below)!
-
 ~calc-mode~ is a calculator system within Emacs that provides a
 diverse array of mathematical operations.  It uses reverse polish
-notation to do calculations (though there is a standard infix
-algebraic notation mode).
-
-Embedded mode allows computation with the current buffer as the echo
-area.  This basically means I can compute stuff within a buffer
-without invoking calc directly: $1 + 2\rightarrow_{\text{calc-embed}} 3$.
+notation, but there is a standard infix algebraic notation mode so
+don't be too shocked.  It can do a surprising amount of stuff, such
+as:
++ finding derivatives/integrals of generic equations
++ matrix operations
++ finding solutions for equations, such as for finite degree multi
+  variable polynomials
+
+It also has this thing called embedded mode.  This allows one to
+perform computation within a non ~calc-mode~ buffer.  Surround any
+equation with dollar signs (such as 2^20, for example) and call
+~(calc-embedded)~ with your cursor on it to compute it.  It'll replace
+the equation with the result it computed.
+
+Say I want to find the 4th power of 2 cos I'm writing some bit
+manipulation code and I need to set the 4th bit of some variable to 1.
+Instead of computing it outside of my editor then copying the result
+back in, I can just do it within Emacs.  Pretty nifty, right?
 
 #+begin_src emacs-lisp
 (use-package calc
@@ -2881,24 +2891,33 @@ Counsel integration for projectile commands, very nice.
     "K" #'devdocs-lookup))
 #+end_src
 * Org mode
-2023-03-30: finally decided to give org mode its own section.
-
-Org is, at its most basic, a markup language.  Files use the ".org"
-extension and use =org-mode= to write text, with the ability to export
-to a few formats, all within Emacs.  Some other features include:
-+ A complete spreadsheet system, with formulas (including
+Org is, at its most basic, a markup language.  =org-mode= is a major
+mode for Emacs to interpret org buffers.  org-mode provides a lot of
+capabilities, some are:
++ A complete table based spreadsheet system, with formulas (including
   [[*Calculator][calc-mode]] integration)
-+ Evaluation of code blocks, even using the results of them in exports
-  (to, say, a $\LaTeX$ or HTML document)
-  + This includes exporting code blocks to a code file.  All the
-    emacs-lisp code blocks in this file are compiled to =config.el=
-    ([[file:elisp/literate.el][literate]])
-+ Complete calendar/todo system with deadlines, scheduling and
-  repeaters
++ Code blocks with proper syntax highlighting and editing experience
+  + Evaluation
+  + Export of code blocks to a variety of formats
+  + Export of code blocks to a code file (so called "tangling", which
+    is what occurs in this document)
++ Feature complete scheduling system with [[*Calendar][calendar]]
+  integration
+  + A clock-in system to time tasks
++ TODO system
 + Export to a variety of formats or make your own export engine using
-  the org AST!
-+ Writing $\LaTeX$ inline, with the ability to render the fragments on
-  demand
+  the org AST.
++ Inline $\LaTeX$, with the ability to render the fragments on
+  demand within the buffer
++ Links to a variety of formats:
+  + Websites (via http or https)
+  + FTP
+  + SSH
+  + Files (even to a specific line)
+  + Info pages
+
+I'd argue this is a bit more than a markup language.  Like
+[[*Magit][Magit]], some use Emacs just for this system.
 ** Org Essentials
 Org has a ton of settings to tweak, which change your experience quite
 a bit.  Here are mine, but this took a lot of just reading other
@@ -3157,8 +3176,14 @@ a very tidy way to manage your time.
     "r" #'org-agenda-redo))
 #+end_src
 ** Org capture
-2024-04-24: I actually need to clean this up, in particular explain
-what org-capture does.
+Org capture provides a system for quickly "capturing" some information
+into an org file.  A classic example is creating a new TODO in a
+todo file, where the bare minimum to record one is:
++ where was it recorded?
++ when was it recorded?
++ what is it?
+Org capture provides a way to do that seamlessly without opening the
+todo file directly.
 #+begin_src emacs-lisp
 (use-package org-capture
   :defer t