README

Windows Pretest

https://alpha.gnu.org/gnu/emacs/pretest/windows/

Building Windows with Native Compilation

I actually haven't actually tried this so I don't really know whether this works.

https://gist.github.com/nauhygon/f3b44f51b34e89bc54f8

Security Tokens

If you find yourself somehow magically using a security token, you can disable it by running

git config commit.gpgsign false

local.el

We define a local.el to store local links

• Do not expect local.el to exist all the time
• Do not expect local.el to define a consistent set of variables
• Expect local.el to vary wildly in content throughout different machines
• Basically don't trust local.el. It is a necessary evil

Linux

Edit /etc/apt/sources.list to comment back in deb-src lines. Then sudo apt update.

sudo apt build-dep emacs

# depends on which version of gcc is installed
sudo apt install autoconf build-essential texinfo libx11-dev \
     libmagick++-dev                                         \
     libsqlite3-dev                                          \
     libgccjit0 libgccjit-11-dev                             \
     libtree-sitter-dev                                      \
     gnutls-bin                                              \
     libxft-dev                                              \
     libwebp-dev

./autogen.sh
./configure --with-imagemagick        \
            --with-native-compilation \
            --with-mailutils          \
            --with-pgtk

We would normally also use --with-tree-sitter if it's libtree-sitter-dev is present.

make
sudo make install

WSL2

There's an issue currently where windows look weird.

Workaround:

• Create a ~/.wslgconfig with

[system-distro-env]
;disable GPU in system-distro
LIBGL_ALWAYS_SOFTWARE=1

Emacs-Plus

on macos (here the M1 specifically) issue

# Optional step
brew uninstall emacs-plus

(Alternatively, use reinstall)

LIBRARY_PATH="$(brew --prefix)/lib" brew install --debug -v emacs-plus@30 --with-mailutils --with-imagemagick --with-native-comp --with-xwidgets --with-poll

There might be a problem with the install. Verify if running make bootstrap makes sense here.

Daemon

arch -arm64 emacs --daemon
emacsclient -a "" -c "SOME FILENAME"

TODO

• consult-* functions are not correctly adding themselves to the evil jump list