54b9929434
## Changelog for doom-emacs: Commits: [hlissner/doom-emacs@adff1aa6...57ef63d6](adff1aa68d...57ef63d6ba) * [`3d993286`](3d993286c0) Licences: Add tabstops with defaults to gpl3 * [`a110b6ab`](a110b6ab5f) Disable idle completion in nix-mode * [`64ac1609`](64ac1609dd) emacs/vc: enable bug-reference-mode * [`9bbdacc7`](9bbdacc79b) Prefix tramp auto-save files * [`a6959b75`](a6959b75f3) Minor refactors & reformatting * [`e333feaf`](e333feaf54) Add mathjax support for markdown preview in pandoc * [`89019c66`](89019c66a2) Clarify doom-store-put docstring * [`3788fd2c`](3788fd2c44) Add Keybinding for testing all functions in the project with pytest * [`a904b718`](a904b718f8) Default to showing dotfiles in ripgrep searches * [`01922219`](0192221981) Fix 'doom build' skipping straight * [`d1cef4ac`](d1cef4ac94) Bind SPC b {c,C} to clone buffer indirectly * [`ecddd347`](ecddd347f3) lang/php: use php-language-server.php if in PATH * [`9e1ac0c0`](9e1ac0c0be) Reduce active message-log-max; scale in debug mode * [`fe37a590`](fe37a590cc) Set doom--initial-load-path in sandbox * [`ff3248d0`](ff3248d022) Disable lsp indentation in scala mode * [`f33b1416`](f33b141650) term/eshell: fix eshell resetting eshell-mode-map * [`164b997c`](164b997cb0) Add q text-object for all quotes * [`e574c347`](e574c3470d) Limit evil-textobj-anyblock to non-quotes * [`471028ce`](471028ce94) Bump :editor snippets * [`d21d86aa`](d21d86aafc) Add single quotes to ‘any quote’ text objects * [`d784509a`](d784509abf) Fix hlissner/doom-emacs#4172: different build path per Emacs version * [`9ce9c683`](9ce9c6838e) Add emacs version to autoloads file path * [`fd6984f2`](fd6984f2e7) Sort which-key labels alphabetically * [`e408c045`](e408c04548) Rebind rotate-text to ]r / [r * [`8eb8f41b`](8eb8f41b33) EMACS28+ gate eshell keymap fix * [`1b44cf92`](1b44cf9215) Fix hlissner/doom-emacs#4176: eshell keybinds bound too soon * [`dbeaa8e2`](dbeaa8e238) Remove emacs-version check in autoloads file * [`61ec1d96`](61ec1d9698) mac-right-option-modifier = none * [`57ef63d6`](57ef63d6ba) Fix hlissner/doom-emacs#4176: wrong-type-arg keymapp opening eshell
nix-doom-emacs
Nix expression to install and configure doom-emacs.
The expression builds a doom-emacs distribution with dependencies
pre-installed based on an existing ~/.doom.d directory.
It is not a fully fledged exprerience as some dependenices are not installed and
some may not be fully compatible as the version available in NixOS or
emacs-overlay may not be
compatible with the doom-emacs requirements.
Getting started
Using home-manager:
{ pkgs, ... }:
let
doom-emacs = pkgs.callPackage (builtins.fetchTarball {
url = https://github.com/vlaci/nix-doom-emacs/archive/master.tar.gz;
}) {
doomPrivateDir = ./doom.d; # Directory containing your config.el init.el
# and packages.el files
};
in {
home.packages = [ doom-emacs ];
home.file.".emacs.d/init.el".text = ''
(load "default.el")
'';
}
Under the hood
This expression leverages nix-straight.el under the hood for installing depdendencies. The restrictions of that package apply here too.
Usage
instead of running emacs.d/bin/doom, once you have update your config files (packages.el, init.el, config.el), rebuild doom-emacs with nix. If you are using home-manager, simply run home-manager switch
Troubleshooting
On macOS on a fresh install, you might run into the error Too many files open. running ulimit -S -n 2048 will only work for the duration of your shell and will fix the error
Installing emacs packages
In the initial packages.el instructions for how to install packages can be found.
However some packages might require a particular software dependency to be installed.
Trying to install those would give you an error of the type:
Searching for program: No such file or directory, git (Missing git dependency)
Here is how you would go installing magit-delta for example (which requires git).
under the line:
doomPrivateDir = ./doom.d;
in your configuration, you would add the following:
emacsPackagesOverlay = self: super: {
magit-delta = super.magit-delta.overrideAttrs (esuper: {
buildInputs = esuper.buildInputs ++ [ pkgs.git ];
});
};
to make the git dependency available.
trying to rebuild doom-emacs with home-manager switch should work correctly now.