From 65632113fe6f33dd878c73138303bf90c333e272 Mon Sep 17 00:00:00 2001 From: Aryadev Chavali Date: Tue, 11 Jun 2024 18:35:05 +0100 Subject: (Emacs/config)~Cleaned up some descriptions --- Emacs/.config/emacs/config.org | 97 ++++++++++++++++++++++++++---------------- 1 file 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 -- cgit v1.2.3-13-gbd6f