diff options
| author | Valentin Gagarin <valentin.gagarin@tweag.io> | 2023-06-20 12:12:03 +0200 |
|---|---|---|
| committer | Valentin Gagarin <valentin.gagarin@tweag.io> | 2023-06-20 12:13:26 +0200 |
| commit | bc7324e912578cdbeb1f10bf1c8d9b447a416dbd (patch) | |
| tree | 544e234a785a7463bcab05ae0034af7d21006047 /doc/manual/src/command-ref | |
| parent | 38bd1cc9bc80e6dec59e56a7d1ce19379915a910 (diff) | |
clarify read order for configuration settings
Diffstat (limited to 'doc/manual/src/command-ref')
| -rw-r--r-- | doc/manual/src/command-ref/conf-file-prefix.md | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/doc/manual/src/command-ref/conf-file-prefix.md b/doc/manual/src/command-ref/conf-file-prefix.md index 29325ee45..3cd622247 100644 --- a/doc/manual/src/command-ref/conf-file-prefix.md +++ b/doc/manual/src/command-ref/conf-file-prefix.md @@ -8,19 +8,19 @@ Nix supports a variety of configuration settings, which are read from configurat ## Configuration file -By default Nix reads settings from the following places: +By default Nix reads settings from the following places, in that order: - - The system-wide configuration file `sysconfdir/nix/nix.conf` (i.e. `/etc/nix/nix.conf` on most systems), or `$NIX_CONF_DIR/nix.conf` if [`NIX_CONF_DIR`](./env-common.md#env-NIX_CONF_DIR) is set. +1. The system-wide configuration file `sysconfdir/nix/nix.conf` (i.e. `/etc/nix/nix.conf` on most systems), or `$NIX_CONF_DIR/nix.conf` if [`NIX_CONF_DIR`](./env-common.md#env-NIX_CONF_DIR) is set. - Values loaded in this file are not forwarded to the Nix daemon. - The client assumes that the daemon has already loaded them. + Values loaded in this file are not forwarded to the Nix daemon. + The client assumes that the daemon has already loaded them. - - If [`NIX_USER_CONF_FILES`](./env-common.md#env-NIX_USER_CONF_FILES) is set, then each path separated by `:` will be loaded in reverse order. +1. If [`NIX_USER_CONF_FILES`](./env-common.md#env-NIX_USER_CONF_FILES) is set, then each path separated by `:` will be loaded in reverse order. - Otherwise it will look for `nix/nix.conf` files in `XDG_CONFIG_DIRS` and [`XDG_CONFIG_HOME`](./env-common.md#env-XDG_CONFIG_HOME). - If unset, `XDG_CONFIG_DIRS` defaults to `/etc/xdg`, and `XDG_CONFIG_HOME` defaults to `$HOME/.config` as per [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html). + Otherwise it will look for `nix/nix.conf` files in `XDG_CONFIG_DIRS` and [`XDG_CONFIG_HOME`](./env-common.md#env-XDG_CONFIG_HOME). + If unset, `XDG_CONFIG_DIRS` defaults to `/etc/xdg`, and `XDG_CONFIG_HOME` defaults to `$HOME/.config` as per [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html). - - If [`NIX_CONFIG`](./env-common.md#env-NIX_CONFIG) is set, its contents are treated as the contents of a configuration file. +1. If [`NIX_CONFIG`](./env-common.md#env-NIX_CONFIG) is set, its contents are treated as the contents of a configuration file. ### File format @@ -38,7 +38,7 @@ Other files can be included with a line like `include <path>`, where `<path>` is A missing file is an error unless `!include` is used instead. A configuration setting usually overrides any previous value. -However, you can prefix the name of the setting by `extra-` to *append* to the previous value. +However, for settings that take a list of items, you can prefix the name of the setting by `extra-` to *append* to the previous value. For instance, |