docs(mu4e): update NixOS installation instructions

Recently, the Emacs package 'mu4e' has been moved into a separate
derivation output. Now you need both the 'mu' package (installing the
program) as well as its 'mu4e' output, which adds the Emacs package to
the system.

Ref: ac4f5079f7
This commit is contained in:
Johannes Maier 2023-10-16 09:42:10 +02:00 committed by Henrik Lissner
parent a940ac5614
commit 0c8dff66de

View file

@ -93,12 +93,24 @@ If you use =msmtp=:
#+begin_src nix #+begin_src nix
environment.systemPackages = with pkgs; [ environment.systemPackages = with pkgs; [
mu mu
# For nixpkgs versions after 23.05: this installs Emacs with mu4e already
# included (you still need mu above; it just doesn't ship with mu4e anymore)
((emacsPackagesFor emacs).emacsWithPackages (epkgs: [ epkgs.mu4e ]))
# And one of the following # And one of the following
isync isync
offlineimap offlineimap
]; ];
#+end_src #+end_src
If you use ~home-manager~ you should specify ~mu4e~ as an additionally included
package as follows (requires ~nixpkgs~ > 23.05):
#+begin_src nix
programs.emacs = {
enable = true;
extraPackages = epkgs: [ epkgs.mu4e ];
}
#+end_src
[[https://github.com/Emiller88/dotfiles/blob/5eaabedf1b141c80a8d32e1b496055231476f65e/modules/shell/mail.nix][An example of setting up mbsync and mu with home-manager]] [[https://github.com/Emiller88/dotfiles/blob/5eaabedf1b141c80a8d32e1b496055231476f65e/modules/shell/mail.nix][An example of setting up mbsync and mu with home-manager]]
* TODO Usage * TODO Usage
@ -356,9 +368,9 @@ mail retrieval/indexing, change the value of ~mu4e-update-interval~:
You will get =No such file or directory, mu4e= errors if you don't run ~$ doom You will get =No such file or directory, mu4e= errors if you don't run ~$ doom
sync~ after installing =mu= through your package manager. sync~ after installing =mu= through your package manager.
Some times the ~mu~ package does not include ~mu4e~ (*cough Ubuntu*). if Sometimes the ~mu~ package does not include ~mu4e~ (*cough Ubuntu*). If that's
that's the case you will need to [[https://github.com/djcb/mu][install]] it and add it to your ~load-path~ you the case you will need to [[https://github.com/djcb/mu][install]] it and add it to your ~load-path~. You can
can do that by: do that by:
#+begin_src emacs-lisp #+begin_src emacs-lisp
(add-to-list 'load-path "your/path/to/mu4e") (add-to-list 'load-path "your/path/to/mu4e")
;; if you installed it using your package manager ;; if you installed it using your package manager