How to build the Nix manual? (not the Nix man pages)

@NobbZ to the rescue from chat - thanks again!

NobbZ:

$ nix build nix/2.10.2\#nix^doc
$ ll result-doc/share/doc/nix/manual/ | head
Permissions Links  Size User Group Date Modified    Name
dr-xr-xr-x     13     - root root  1970-01-01 01:00 ./
dr-xr-xr-x      3     - root root  1970-01-01 01:00 ../
dr-xr-xr-x      2     - root root  1970-01-01 01:00 advanced-topics/
dr-xr-xr-x      3     - root root  1970-01-01 01:00 command-ref/
dr-xr-xr-x      2     - root root  1970-01-01 01:00 contributing/
dr-xr-xr-x      2     - root root  1970-01-01 01:00 css/
dr-xr-xr-x      2     - root root  1970-01-01 01:00 expressions/
dr-xr-xr-x      2     - root root  1970-01-01 01:00 figures/
dr-xr-xr-x      4     - root root  1970-01-01 01:00 FontAwesome/

I built from the tag to leverage the cache, as it is a multi-output derivation, building the manual also requires building nix

toraritte:

Thank you! Will give it a try as soon as I can. As for the args nix/2.10.2\#nix^doc - where can I read about this syntax? 2.10.2 is the git tag, but the rest is a bit of a mystery.

NobbZ:

The Nix manual’s “7.5.1.” section (Installables) covers parts of it. The caret ( ^ ) is only mentioned in a recent release note though
It’s the 2.9 release that introduced it: Nix 2.9.0 released