aboutsummaryrefslogtreecommitdiff
path: root/emacs/README.md
diff options
context:
space:
mode:
authoralex <alex@pdp7.net>2025-04-29 22:05:46 +0200
committeralexpdp7 <alex@corcoles.net>2025-04-29 22:06:25 +0200
commit0544650ea18a72842f46d7c0cea971f66fa7b0de (patch)
tree1e4049ce82e296a112f2d63991d6fe6953a1b053 /emacs/README.md
parent7036543658efa1ba2816edae035d24494bc73c82 (diff)
Tidy emacs.el, update README
Diffstat (limited to 'emacs/README.md')
-rw-r--r--emacs/README.md29
1 files changed, 15 insertions, 14 deletions
diff --git a/emacs/README.md b/emacs/README.md
index d028189c..a888fbe7 100644
--- a/emacs/README.md
+++ b/emacs/README.md
@@ -7,21 +7,22 @@ Just do it!
It's a bit alien at first, but I didn't need much time to do all my editing in Emacs.
I haven't learnt Emacs Lisp and I haven't adopted any large configuration package.
-[My `emacs.el` right now is 130 lines](https://github.com/alexpdp7/alexpdp7/blob/4cbc783bbe406051bbcf88995316c9994518cbd9/emacs/emacs.el).
-Perhaps when you read this, my current config will be much bigger..
-But I'm definitely happy today with my 130-line config.
+Start with the following `.emacs`:
+
+```
+(fido-vertical-mode)
+(which-key-mode)
+```
-You can start without a configuration.
-Whenever you can't do something, search Internet.
-You will quickly learn the hotkeys you need the most.
-Once you can search, undo, cut, copy, and paste, you can take your time with the rest.
-Don't avoid the menus.
-Sometimes it's just easier to hit F10 and find something in the menus.
-You can also M-x to execute commands, like `indent-region`.
+You can execute Emacs commands with `M-x` (alt-x).
+`fido-vertical-mode` adds incremental search to `M-x`
+You can learn many keybindings through the hints that the Emacs menu and `M-x` show.
-Many other stuff is support for things I do: Vale, Rust, Python, Java, YAML, Puppet.
-You probably need other plugins, and maybe you don't need them right now.
+When you pause after pressing an incomplete shortcut, `which-key-mode` shows the next keys and shortcuts available.
+By pressing `C-x` (control-x), `C-c`, or `C-h, you can see the global, mode, and help shortcuts respectively.
-Maybe try out some of the large configurations, to learn what fancy stuff is available and add it as you become comfortable with the previous thing you configured.
+[My `emacs.el` is about 120 lines](emacs.el).
+Perhaps when you read this, my current config will be much bigger..
+But I'm definitely happy today with my 120-line config.
-(Be sure to check [emacs.bash](https://github.com/alexpdp7/alexpdp7/blob/master/emacs/emacs.bash) for something you can source in your bash to keep Emacs running and prevent slow startup.)
+Check [emacs.bash](https://github.com/alexpdp7/alexpdp7/blob/master/emacs/emacs.bash) for something you can source in your bash to keep Emacs running and prevent slow startup.