spacemacs/layers/+os/nixos/README.org
Benjamin Hipple 6781dfe157
[nixos] Update recommended method for disabling nixos-company-options
Per discussion in #13164, we have a standard, consistent technique for doing
this across any layer. Provided that `global-company-mode` is not set, this
works as expected to disable company without requiring custom variables.
2020-02-08 09:05:44 +00:00

40 lines
1.4 KiB
Org Mode

#+TITLE: NixOS layer
#+TAGS: layer|os
[[file:img/nixos.png]]
* Table of Contents :TOC_5_gh:noexport:
- [[#description][Description]]
- [[#features][Features:]]
- [[#install][Install]]
- [[#layer][Layer]]
- [[#configuration][Configuration]]
- [[#key-bindings][Key bindings]]
- [[#nixos-options][NixOS Options]]
* Description
This layer adds tools for better integration of Emacs in NixOS.
** Features:
- Nix-mode using [[https://github.com/NixOS/nix-mode][nix-mode]]
- Auto-completion of NixOS Options using [[https://github.com/travisbhartwell/nix-emacs/blob/master/company-nixos-options.el][company-nixos-options]]
- Helm Lookup for NixOS Options [[https://github.com/travisbhartwell/nix-emacs/blob/master/helm-nixos-options.el][helm-nixos-options]]
* Install
** Layer
To use this configuration layer, add it to your =~/.spacemacs=. You will need to
add =nixos= to the existing =dotspacemacs-configuration-layers= list in this
file.
* Configuration
On some systems, =company-nixos-options= may be very slow. If this is the case,
see the section on disabling the [[https://github.com/syl20bnr/spacemacs/blob/develop/doc/DOCUMENTATION.org#disabling-layer-services-in-other-layers][disabling auto-complete]] for the =nixos= layer.
* Key bindings
** NixOS Options
| Key binding | Description |
|-------------+-------------------------|
| ~SPC h >~ | Call helm-nixos-options |