mirror of
https://github.com/NixOS/nixpkgs.git
synced 2024-12-16 10:43:27 +00:00
0a6e6cf7e6
this converts meta.doc into an md pointer, not an xml pointer. since we no longer need xml for manual chapters we can also remove support for manual chapters from md-to-db.sh since pandoc converts smart quotes to docbook quote elements and our nixos-render-docs does not we lose this distinction in the rendered output. that's probably not that bad, our stylesheet didn't make use of this anyway (and pre-23.05 versions of the chapters didn't use quote elements either). also updates the nixpkgs manual to clarify that option docs support all extensions (although it doesn't support headings at all, so heading anchors don't work by extension).
104 lines
3.0 KiB
Nix
104 lines
3.0 KiB
Nix
{ config, lib, pkgs, ... }:
|
|
|
|
with lib;
|
|
|
|
let
|
|
|
|
cfg = config.services.emacs;
|
|
|
|
editorScript = pkgs.writeScriptBin "emacseditor" ''
|
|
#!${pkgs.runtimeShell}
|
|
if [ -z "$1" ]; then
|
|
exec ${cfg.package}/bin/emacsclient --create-frame --alternate-editor ${cfg.package}/bin/emacs
|
|
else
|
|
exec ${cfg.package}/bin/emacsclient --alternate-editor ${cfg.package}/bin/emacs "$@"
|
|
fi
|
|
'';
|
|
|
|
desktopApplicationFile = pkgs.writeTextFile {
|
|
name = "emacsclient.desktop";
|
|
destination = "/share/applications/emacsclient.desktop";
|
|
text = ''
|
|
[Desktop Entry]
|
|
Name=Emacsclient
|
|
GenericName=Text Editor
|
|
Comment=Edit text
|
|
MimeType=text/english;text/plain;text/x-makefile;text/x-c++hdr;text/x-c++src;text/x-chdr;text/x-csrc;text/x-java;text/x-moc;text/x-pascal;text/x-tcl;text/x-tex;application/x-shellscript;text/x-c;text/x-c++;
|
|
Exec=emacseditor %F
|
|
Icon=emacs
|
|
Type=Application
|
|
Terminal=false
|
|
Categories=Development;TextEditor;
|
|
StartupWMClass=Emacs
|
|
Keywords=Text;Editor;
|
|
'';
|
|
};
|
|
|
|
in
|
|
{
|
|
|
|
options.services.emacs = {
|
|
enable = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = lib.mdDoc ''
|
|
Whether to enable a user service for the Emacs daemon. Use `emacsclient` to connect to the
|
|
daemon. If `true`, {var}`services.emacs.install` is
|
|
considered `true`, whatever its value.
|
|
'';
|
|
};
|
|
|
|
install = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = lib.mdDoc ''
|
|
Whether to install a user service for the Emacs daemon. Once
|
|
the service is started, use emacsclient to connect to the
|
|
daemon.
|
|
|
|
The service must be manually started for each user with
|
|
"systemctl --user start emacs" or globally through
|
|
{var}`services.emacs.enable`.
|
|
'';
|
|
};
|
|
|
|
|
|
package = mkOption {
|
|
type = types.package;
|
|
default = pkgs.emacs;
|
|
defaultText = literalExpression "pkgs.emacs";
|
|
description = lib.mdDoc ''
|
|
emacs derivation to use.
|
|
'';
|
|
};
|
|
|
|
defaultEditor = mkOption {
|
|
type = types.bool;
|
|
default = false;
|
|
description = lib.mdDoc ''
|
|
When enabled, configures emacsclient to be the default editor
|
|
using the EDITOR environment variable.
|
|
'';
|
|
};
|
|
};
|
|
|
|
config = mkIf (cfg.enable || cfg.install) {
|
|
systemd.user.services.emacs = {
|
|
description = "Emacs: the extensible, self-documenting text editor";
|
|
|
|
serviceConfig = {
|
|
Type = "forking";
|
|
ExecStart = "${pkgs.bash}/bin/bash -c 'source ${config.system.build.setEnvironment}; exec ${cfg.package}/bin/emacs --daemon'";
|
|
ExecStop = "${cfg.package}/bin/emacsclient --eval (kill-emacs)";
|
|
Restart = "always";
|
|
};
|
|
} // optionalAttrs cfg.enable { wantedBy = [ "default.target" ]; };
|
|
|
|
environment.systemPackages = [ cfg.package editorScript desktopApplicationFile ];
|
|
|
|
environment.variables.EDITOR = mkIf cfg.defaultEditor (mkOverride 900 "${editorScript}/bin/emacseditor");
|
|
};
|
|
|
|
meta.doc = ./emacs.md;
|
|
}
|