~grtcdr/emacs.d

Configuration files of my text editor/processor
Refactor my/engine-alist form
Unset org priority settings
Add MAYBE todo keyword

refs

main
browse  log 

clone

read-only
https://git.sr.ht/~grtcdr/emacs.d
read/write
git@git.sr.ht:~grtcdr/emacs.d

You can also use your local clone with git send-email.

#Introduction

This repository hosts my personal configuration files for GNU Emacs (29.1) – the libre, extensible editor (and kitchen sink).

#Bootstrapping

To get started with this configuration, ensure you have git and make installed and then run the following in a shell:

git clone https://git.sr.ht/~grtcdr/emacs.d ~/.config/emacs
cd ~/.config/emacs
make bootstrap-borg
make bootstrap

If you'd rather take it for a spin without affecting your existing user-emacs-directory, clone to whichever path you like and start emacs with the --init-directory flag.

#Commentary

While the vast majority of this configuration can be found in init.el and early-init.el — the initialization and early initialization files, respectively — certain things have evolved into their own self-contained packages which are located in the module directory and can be (optionally) activated by running the my/load-modules command.

Package configuration init.el is organized under broad, yet logical sections, commonly referred to as "pages", use forward-page or backward-page to navigate between them. Customizations specific to a particular machine are located in its respective entry in the machine directory.

Borg is the default package manager, which relies entirely on Git's submodule feature (see the package directory) meaning packages are always pinned to the revision that had been explicitly checked out. While this approach introduces some amount of overhead for me, it provides strong guarantees that the configuration remains reproducible throughout time provided the upstream repositories do not disappear into thin air (this has happened and it's annoying to deal with).

#Copying

This software is provided to you under the terms of the 0BSD license.