Emacs config

This is my new new simplified Emacs config based on straight.el and use-package.

Install

The following shell script will clone this repository and symlink the elisp files into a new, empty ~/.emacs.d directory. You may want to fork this repository and claim this config as your own. If you do, simply update the REMOTE and REPO variables for your own forked version:

[email protected]:EnigmaCurry/emacs.git
REPO=${HOME}/git/vendor/enigmacurry/emacs
BRANCH=straight

(set -e
test -d ~/.emacs.d && (echo "~/.emacs.d already exists. Aborting install." && exit 1)
test -d ${REPO} || git clone -b ${BRANCH} ${REMOTE} ${REPO}
mkdir ~/.emacs.d && ls -1 ${REPO}/*.el | xargs -iXX ln -s XX ~/.emacs.d
mkdir ~/.emacs.d/straight && ln -s ${REPO}/straight-versions ~/.emacs.d/straight/versions
)

You will treat your entire ~/.emacs.d directory as ephemeral (ie. not a git repository). All of your saved configuration should go here instead, saved in this repository (cloned locally to ~/git/vendor/enigmacurry/emacs). The main emacs configuration, init.el and early-init.el, are both symlinked into the freshly created ~/.emacs.d directory. The straight-versions directory is also symlinked to ~/.emacs.d/straight/versions, which keeps your package lock file (default.el) versioned inside of git, so as to maintain exactly reproducible installs.

You can install the optional ec script as an alias to control emacsclient and start/connect to your emacs sever. Add the directory to your PATH (~/.bashrc):

PATH=$PATH:/home/ryan/git/vendor/enigmacurry/emacs

If you use dmenu with i3, you can add your PATH directly to the dmenu launcher keybinding:

# excerpt from ~/.config/i3/config
bindsym $mod+d exec --no-startup-id env PATH=$PATH:$HOME/git/vendor/enigmacurry/emacs dmenu_run

Upgrade

From time to time, you should review the versions of your dependencies in your lockfile (default.el).

To upgrade a single package, run M-x straight-pull-package

To upgrade a single package and all of its dependencies, run M-x straight-pull-package-and-deps

To upgrade all packages, run M-x straight-pull-all

After you're done upgrading packages, add the new versions to the lockfile:

## Write new upgraded versions to the lockfile:
M-x straight-freeeze-versions

If you maintain multiple installations, you will also need to run the following on each other machine after you git pull:

## Update the installed versions according to the lockfile
M-x straight-thaw-versions

Credits and other useful links

Some code samples taken from:

• susam/emfy
• Emacs Configuration Generator

My older emacs configs

Here's my old spacemacs config branch

Here's my old old literate config branch

If you want to see my old old old config from the late 2000s, see the ancient-history branch