Rewrite README

README.org

@@ -1,29 +1,60 @@
-#+TITLE: Emacs Configuration
-* Emacs Configuration
-Oh boy.
+Any introduction would be insufficient.
 
-I don't even know what to say about this. I want to believe in the vim cult, but
-emacs just has me under its thrall. It's precisely what I've been looking for
-this whole time.
+A "literate" configuration would break many things.
 
-There's a lot of stuff here, but I've decided not to take the literate-config
-approach just yet. This needs to mostly work on Windows, after all.
+Thus I will write of random things included here in no particular order, as my
+file organization suggests.
 
-** From the old README:
-I have based most of this off of what I happened to have for neovim at the time,
-with the aid of [[https://systemcrafters.net][System Crafters]]. Since then it has grown into something more,
-something crazy. Or maybe it's really not that crazy and emacs is just a bad
-program with a good extension API. I do not know if I am a human dreaming of
-emacs, or an emacs dreaming of humanity.
+-----
 
-There are a few things to immediately note:
+Everything is in the file =lisp/mitch-packages.el=​. There are things in other
+files but they mostly never change - see the commit history.
 
-- The theme is my own. Every existing emacs (and vim, for that matter) colorscheme/theme is washed-in and gray-on-gray. Doom, spacemacs, solarized, nord, dracula, or any other name-able theme. Also, any "new and exciting" theme you see on Reddit will be the same. This infuriated me to no end, so in the early days of my nvim tweaking I pulled the most unique and contrastful theme I could find. It was called "sv" and it was hacked up by some guy on github once and then forgotten (https://github.com/alexkh/vimcolors). So I extended it for nvim, then recreated it in emacs with the aid of [[https://github.com/jasonm23/autothemer][autothemer]] (which you can find at [[.config/emacs/lisp/mitch-theme.el][.config/emacs/lisp/mitch-theme.el]]).
+* TRAMP
+Generally, tramp is mostly fine. But if there are problematic configurations, it
+will be very slow and time out and it will hang Emacs. I've had terrible luck
+with it until just today (at the time of writing) and I'm legitimately shocked
+it isn't terrible. Hooray! but also come on.
 
-- Typing ~qq~ will change your input method. This is sort-of a built-in feature, but the default trigger is to type ~C-\~, which is annoying to press. The ~qq~ behavior is built into Japanese-mode specifically and normally toggles in and out of ~japanese-ascii~, which is literally just normal text except ~qq~ switches back to Japanese.
-* 2022-09-26 12:57 pm
-This is the time of day that I wrote the thing that creates the above heading
-now. It works it works it works...
+* Evil
+vim keys are indispensable to me. Legit I cannot live without them very
+well. Most all of my evil configuration is very boilerplate, but I'd like to
+think that's fine.
 
-_this is underlined_ and that works with electric pairs now... "And" =so= does
-+this and this and+ *not this* either...
+VIPER is also a thing built into Emacs. It's probably not that bad, but the
+defaults are very unintuitive compared to evil-collection.
+
+* EShell
+I like eshell - it reminds me of the configuration I liked about zsh, and the
+composability I love about powershell.
+
+The EAT terminal is also just amazing.
+
+* NLinum-relative
+is a thing. It requires nlinum which requires linum which is deprecated. This is
+all for a single face declaration which is VERY UNNECESSARY. Just define it the
+same and force theme authors to add a declaration. or /inherit from the built-in
+display-line-numbers face/​.
+
+* mitch-theme
+In [[https://git.mitchmarq42.xyz/mitch/vimcolors][a separate repo]] there is a theme I made. It's not a good theme and I'm
+insane. But I can't stand normal themes. By all accounts there is something
+wrong with my eyes. Shut up.
+
+* YAscroll
+"yet another scroll" yet there is no other scrollbar. If anyone knows of one,
+tell me.
+
+I re-define a display function in my config because I'm using background
+transparency and otherwise it looks all chunky with the face declaration.
+
+* Org
+A good idea and usable, but I currently disable most fancy things because it
+gets very slow otherwise. I've ran profilers and debuggers and the problem is
+related to redisplay.
+
+* org-tempo
+I want to get rid of this and just use yasnippets, but oh well.
+
+* ox-hugo
+I have a function that automatically re-generates all the hugos.