NixOS/nix
NixOS/nix
1
0
Fork 0
mirror of https://github.com/NixOS/nix synced 2024-10-18 14:32:45 -04:00
Code Activity
nix/doc/manual/source/command-ref/files/channels.md

27 lines
748 B
Markdown
Raw Normal View History

increase heading level otherwise the headings won't match at the point where they are included. this is a bit hacky and brittle, but works for now.
2023-04-26 09:07:26 -04:00
## Channels
Document user files of nix
2023-02-17 12:57:15 -05:00
add colons to connect listings with descriptions
2023-04-26 04:57:41 -04:00
A directory containing symlinks to Nix channels, managed by [`nix-channel`]:
Document user files of nix
2023-02-17 12:57:15 -05:00
- `$XDG_STATE_HOME/nix/profiles/channels` for regular users
list information regular users first this is to make it consistent everywhere
2023-04-26 04:56:35 -04:00
- `$NIX_STATE_DIR/profiles/per-user/root/channels` for `root`
Document user files of nix
2023-02-17 12:57:15 -05:00
display documentation on manifest files separately it's probably better not to show the manifest file documentation in the command-specific pages, because these are implementation details that are not really practically useful. this means no additional hassle for building the manual, but clutters the table of contents a bit.
2023-04-27 05:56:52 -04:00
[`nix-channel`] uses a [profile](@docroot@/command-ref/files/profiles.md) to store channels.
Document user files of nix
2023-02-17 12:57:15 -05:00
This profile contains symlinks to the contents of those channels.
## Subscribed channels
The list of subscribed channels is stored in
- `~/.nix-channels`
- `$XDG_STATE_HOME/nix/channels` if [`use-xdg-base-directories`] is set to `true`
in the following format:
```
<url> <name>
...
```
[`nix-channel`]: @docroot@/command-ref/nix-channel.md
[`use-xdg-base-directories`]: @docroot@/command-ref/conf-file.md#conf-use-xdg-base-directories
Copy permalink