Nixpkgs/Manuals: Difference between revisions
Isabelroses (talk | contribs) update link to nix-darwin manual |
Phanirithvij (talk | contribs) m minor formatting change, use latest url which redirects for nix manual |
||
| Line 11: | Line 11: | ||
https://nix.dev/manual/nix/stable | https://nix.dev/manual/nix/stable | ||
https://nix.dev/manual/nix/ | https://nix.dev/manual/nix/latest | ||
=== Nixpkgs === | === Nixpkgs === | ||
| Line 76: | Line 76: | ||
checkout the specific revision (branch or commit) | checkout the specific revision (branch or commit) | ||
<syntaxhighlight lang="bash">git checkout nixos-24.05 | <syntaxhighlight lang="bash"> | ||
nix build .#nixpkgs-manual --print-out-paths --no-link</syntaxhighlight> | git checkout nixos-24.05 | ||
nix build .#nixpkgs-manual --print-out-paths --no-link | |||
</syntaxhighlight> | |||
=== nix manual === | === nix manual === | ||
| Line 83: | Line 85: | ||
{{Warning|Building the nix manual requires building nix, for master branch it will build from source and it will take quite a while.}} | {{Warning|Building the nix manual requires building nix, for master branch it will build from source and it will take quite a while.}} | ||
<syntaxhighlight lang="bash"># before nix version 2.25.0 | <syntaxhighlight lang="bash"> | ||
# before nix version 2.25.0 | |||
nix build github:nixos/nix/2.24.11#nix^doc --print-out-paths --no-link | nix build github:nixos/nix/2.24.11#nix^doc --print-out-paths --no-link | ||
| Line 93: | Line 96: | ||
# for other system | # for other system | ||
nix build github:nixos/nix/2.25.0#packages.aarch64-darwin.nix-manual --print-out-paths --no-link</syntaxhighlight> | nix build github:nixos/nix/2.25.0#packages.aarch64-darwin.nix-manual --print-out-paths --no-link | ||
</syntaxhighlight> | |||
=== home-manager manual === | === home-manager manual === | ||
Latest revision as of 17:48, 27 November 2025
Links
In the nix ecosystem these are important manuals
Nix
The manual for nix, the package manager
https://nix.dev/manual/nix/unstable
https://nix.dev/manual/nix/stable
https://nix.dev/manual/nix/latest
Nixpkgs
The manual for nixpkgs, the package repository
https://nixos.org/manual/nixpkgs/unstable
https://nixos.org/manual/nixpkgs/stable
Nixos
The manual for nixos, the linux based operating system
https://nixos.org/manual/nixos/unstable
https://nixos.org/manual/nixos/stable
home-manager
The manual for Home Manager
https://nix-community.github.io/home-manager
nix-darwin
The manual for Nix-darwin
https://nix-darwin.github.io/nix-darwin/manual/index.html
Building the manuals yourself
To build the manuals above
nixos manual
cd nixpkgs
nix-build nixos/release.nix --no-out-link -A manualHTML.x86_64-linux # or aarch64-linux
nixpkgs manual
# master
nix build github:nixos/nixpkgs#nixpkgs-manual --print-out-paths --no-link
# nixos-unstable
nix build github:nixos/nixpkgs/nixos-unstable#nixpkgs-manual --print-out-paths --no-link
older versions of the manual
If you want to build the manual for older versions of nixpkgs for e.g. nixos-24.05
nix build github:nixos/nixpkgs/nixos-24.05#nixpkgs-manual --print-out-paths --no-link
To build the manual for a specific revision of nixpkgs
clone nixpkgs locally and cd into nixpkgs
checkout the specific revision (branch or commit)
git checkout nixos-24.05
nix build .#nixpkgs-manual --print-out-paths --no-link
nix manual
# before nix version 2.25.0
nix build github:nixos/nix/2.24.11#nix^doc --print-out-paths --no-link
# after 2.25.x
nix build github:nixos/nix/2.25.0#nix-manual --print-out-paths --no-link
# master
nix build github:nixos/nix#nix-manual --print-out-paths --no-link
# for other system
nix build github:nixos/nix/2.25.0#packages.aarch64-darwin.nix-manual --print-out-paths --no-link
home-manager manual
# unstable
nix build github:nix-community/home-manager#docs-html --print-out-paths --no-link
# stable version, e.g. 25.05
nix build github:nix-community/home-manager/release-25.05#docs-html --print-out-paths --no-link
nix-darwin manual
# unstable
nix build github:LnL7/nix-darwin#manualHTML --print-out-paths --no-link
# stable version, e.g. 25.05
nix build github:LnL7/nix-darwin/nix-darwin-25.05#manualHTML --print-out-paths --no-link
# in local clone with nix-build
nix-build release.nix -A docs.manualHTML