Nixpkgs/Manuals: Difference between revisions
Phanirithvij (talk | contribs) |
Isabelroses (talk | contribs) update link to nix-darwin manual |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 6: | Line 6: | ||
The manual for nix, the package manager | The manual for nix, the package manager | ||
https://nix.dev/manual/nix/unstable | |||
https://nix.dev/manual/nix/stable | https://nix.dev/manual/nix/stable | ||
https://nix.dev/manual/nix/2.29 | |||
https://nix.dev/manual/nix/2. | |||
=== Nixpkgs === | === Nixpkgs === | ||
| Line 24: | Line 24: | ||
The manual for nixos, the linux based operating system | The manual for nixos, the linux based operating system | ||
https://nixos.org/manual/nixos/unstable | |||
https://nixos.org/manual/nixos/stable | https://nixos.org/manual/nixos/stable | ||
=== home-manager === | === home-manager === | ||
| Line 39: | Line 39: | ||
The manual for [[Nix-darwin]] | The manual for [[Nix-darwin]] | ||
https:// | https://nix-darwin.github.io/nix-darwin/manual/index.html | ||
== Building the manuals yourself == | == Building the manuals yourself == | ||
| Line 76: | Line 76: | ||
checkout the specific revision (branch or commit) | checkout the specific revision (branch or commit) | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash">git checkout nixos-24.05 | ||
git checkout nixos-24.05 | nix build .#nixpkgs-manual --print-out-paths --no-link</syntaxhighlight> | ||
nix build .#nixpkgs-manual --print-out-paths --no-link | |||
</syntaxhighlight> | |||
=== nix manual === | === nix manual === | ||
| Line 85: | Line 83: | ||
{{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"> | <syntaxhighlight lang="bash"># before nix version 2.25.0 | ||
# 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 96: | Line 93: | ||
# for other system | # for other system | ||
nix build github:nixos/nix/2.25.0#packages.aarch64-darwin.nix-manual --print-out-paths --no-link | nix build github:nixos/nix/2.25.0#packages.aarch64-darwin.nix-manual --print-out-paths --no-link</syntaxhighlight> | ||
</syntaxhighlight> | |||
=== home-manager manual === | === home-manager manual === | ||
| Line 105: | Line 101: | ||
nix build github:nix-community/home-manager#docs-html --print-out-paths --no-link | nix build github:nix-community/home-manager#docs-html --print-out-paths --no-link | ||
# stable version, e.g. | # stable version, e.g. 25.05 | ||
nix build github:nix-community/home-manager/release- | nix build github:nix-community/home-manager/release-25.05#docs-html --print-out-paths --no-link | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| Line 115: | Line 111: | ||
nix build github:LnL7/nix-darwin#manualHTML --print-out-paths --no-link | nix build github:LnL7/nix-darwin#manualHTML --print-out-paths --no-link | ||
# stable version, e.g. | # stable version, e.g. 25.05 | ||
nix build github:LnL7/nix-darwin/nix-darwin- | nix build github:LnL7/nix-darwin/nix-darwin-25.05#manualHTML --print-out-paths --no-link | ||
# in local clone with nix-build | # in local clone with nix-build | ||
nix-build release.nix -A docs.manualHTML | nix-build release.nix -A docs.manualHTML | ||
</syntaxhighlight> | </syntaxhighlight> | ||
Latest revision as of 16:02, 17 July 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/2.29
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
⚠︎
Warning: Building the nix manual requires building nix, for master branch it will build from source and it will take quite a while.
# 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