Emacs configuration

This repository simultaneously contains and documents my GNU Emacs configuration using the literate initialisation style. The configuration is written using org-mode and executed using org-babel-load-file. The init.el file is only used to boot-strap the process.

The main aims and features of this configuration are:

• Literate programming paradigm via Org-mode Babel
• Configuration simultaneously versioned and documented on GitHub
• Package installation and updates managed by use-package
• Modular configuration

General

General	Basic user interface settings
Line numbers	Line and column numbering
Global map	Define modifications to global key map
Backups	Configure backup~ and #auto-save# management
Spelling	Spelling program and on-the-fly spell checking
Undo	Configure undo system
Whitespace	Whitespace management
Recent files	Configure recently opened files management
Repeat	Convenient way to repeat previous commands

Completion

Backend	Configure completion style (backend)
Minibuffer	Configure minibuffer completions
At point	Configure completion at point

Navigation

Hydra	Hydra menu definitions
Cursor	Modifications to default cursor movements
isearch	Incremental search
Window	Window movement and management

Text processing

Text	Global configuration for text modes
LaTeX	Configurations for LaTeX documents
Markdown	Configurations for Markdown documents

Programming

Programming	Global configuration for programming modes
Project management	Project management
Git	Git configuration
Ediff	Ediff configuration
Python	Configurations for python development
Docker	Docker configuration
YAML	Configurations for YAML development

Compiling Emacs from source

The Emacs sources can be retrieved from the FTP server of the the GNU project or the development sources can be access via Git on Savannah. An overview of compiling Emacs 29 on a Debian-based distribution is given here. For more information, see the manual and the build instructions in the sources INSTALL file.

Clone the Emacs repository

git clone git://git.savannah.gnu.org/emacs.git
cd emacs

Checkout desired tag

git checkout emacs-29.4

Install dependencies

sudo apt install build-essential
sudo apt build-dep emacs
sudo apt install gcc-12 libgccjit0 libgccjit-12-dev libtree-sitter-dev

Review configuration options

./configure --help

Configure build

./autogen.sh
CC="gcc-12" ./configure         \
  --build=x86_64-linux-gnu      \
  --with-x                      \
  --with-x-toolkit=gtk3         \
  --with-sound=alsa             \
  --without-mailutils           \
  --with-imagemagick            \
  --without-compress-install    \
  --with-tree-sitter            \
  --with-native-compilation=aot \
  --with-json

Compile

make NATIVE_FULL_AOT=1 -j16

Install

sudo make install