Nix/doc/manual
Alexander Bantyev 2384d36083
A setting to follow XDG Base Directory standard
XDG Base Directory is a standard for locations for storing various
files. Nix has a few files which seem to fit in the standard, but
currently use a custom location directly in the user's ~, polluting
it:

- ~/.nix-profile
- ~/.nix-defexpr
- ~/.nix-channels

This commit adds a config option (use-xdg-base-directories) to follow
the XDG spec and instead use the following locations:

- $XDG_STATE_HOME/nix/profile
- $XDG_STATE_HOME/nix/defexpr
- $XDG_STATE_HOME/nix/channels

If $XDG_STATE_HOME is not set, it is assumed to be ~/.local/state.

Co-authored-by: Théophane Hufschmitt <7226587+thufschmitt@users.noreply.github.com>
Co-authored-by: Tim Fenney <kodekata@gmail.com>
Co-authored-by: pasqui23 <pasqui23@users.noreply.github.com>
Co-authored-by: Artturin <Artturin@artturin.com>
Co-authored-by: John Ericson <Ericson2314@Yahoo.com>
2023-02-10 20:14:06 +04:00
..
src A setting to follow XDG Base Directory standard 2023-02-10 20:14:06 +04:00
theme doc/manual: don't need to copy `highlight.js` manually 2021-08-04 19:47:05 -07:00
anchors.jq doc: Port anchors preprocessor to jq script 2022-05-26 18:17:21 +02:00
book.toml manual: Check links 2023-01-10 22:30:41 +01:00
custom.css Improve margins between sections 2020-08-19 12:31:18 +02:00
generate-builtins.nix refactor rendering documentation of builtins 2022-11-24 14:15:43 +01:00
generate-manpage.nix add missing newline, for consistent formatting 2022-11-30 23:40:53 +01:00
generate-options.nix use HTML anchors for config parameters 2022-12-07 16:18:50 +01:00
local.mk doc/manual/hacking: Document @docroot@ variable 2023-01-10 22:30:41 +01:00
quote-literals.xsl Generate release notes again 2014-03-12 14:24:29 +01:00
redirects.js Remove repeat and enforce-determinism options 2022-12-07 11:36:48 +01:00
utils.nix refactor showOptions 2022-09-30 01:43:53 +02:00