!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

364 Members
This is the official channel for documentation in the Nix ecosystem. The documentation team meets here. More information: https://nixos.org/community/teams/documentation Video conference: https://jitsi.lassul.us/nix-documentation Meeting notes scratch pad: https://pad.lassul.us/p-Y8MjU2SdSD5qO1fnpCPA Past meeting notes: https://discourse.nixos.org/search?q=documentation%20team%20meeting%20order%3Alatest 74 Servers

Load older messages


SenderMessageTime
7 Jan 2025
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @allrealmsoflife:matrix.org

Also when I try the third option, enter the development shell, and run:

[nix-shell:~/src/nix]$ make manual-html-open -j $NIX_BUILD_CORES
make: *** No rule to make target 'manual-html-open'.  Stop.
Make has been decommissioned in favor of Meson, that part can be removed from the instructions.
15:16:05
@fricklerhandwerk:matrix.orgfricklerhandwerk I won’t be able to make time to address this myself, so I’d greatly appreciate PRs to iron out these kinks and will review and merge them when I find a few quiet minutes 15:18:21
@fricklerhandwerk:matrix.orgfricklerhandwerk* I won’t be able to make time to address this myself in the next couple of weeks at the very least, so I’d greatly appreciate PRs to iron out these kinks and will review and merge them when I find a few quiet minutes15:18:45
@allrealmsoflife:matrix.orgallrealmsoflife

Okay, I built it. I do nix --version to get the version number and add that to the flake command: nix build nix/2.24.11\#nix^doc. Otherwise just the #nix^doc it won't work. One way to grab the version inside the command: nix build nix/$(nix --version | awk '{print $3}')#nix^doc

Now the flake command builds the result-doc while the nix-build command builds the result directories. Both results do have the index.html within the ./result-doc/share/doc/nix/manual/index.html or ./result/share/doc/nix/manual/index.html.

17:31:05
@allrealmsoflife:matrix.orgallrealmsoflife *

Okay, I built it. I do nix --version to get the version number and add that to the flake command: nix build nix/2.24.11#nix^doc. Otherwise just the #nix^docit won't work. One way to grab the version inside the command:nix build nix/$(nix --version | awk '{print $3}')#nix^doc`

Now the flake command builds the result-doc while the nix-build command builds the result directories. Both results do have the index.html within the ./result-doc/share/doc/nix/manual/index.html or ./result/share/doc/nix/manual/index.html.

17:31:27
@allrealmsoflife:matrix.orgallrealmsoflife *

Okay, I built it. I do nix --version to get the version number and add that to the flake command:

nix build nix/2.24.11#nix^doc

Otherwise just the #nix^docit won't work. One way to grab the version inside the command:

nix build nix/$(nix --version | awk '{print $3}')#nix^doc\

Now the flake command builds the result-doc while the nix-build command builds the result directories. Both results do have the index.html within the ./result-doc/share/doc/nix/manual/index.html or ./result/share/doc/nix/manual/index.html.

17:32:05
@allrealmsoflife:matrix.orgallrealmsoflife *

Okay, I built it. I do nix --version to get the version number and add that to the flake command:

nix build nix/2.24.11#nix^doc

Otherwise just the #nix^docit won't work. One way to grab the version inside the command:

nix build nix/$(nix --version | awk '{print $3}')#nix^doc\

Now the flake command builds the result-doc while the nix-build command builds the result directories. Both results do have the index.html within the ./result-doc/share/doc/nix/manual/index.html or ./result/share/doc/nix/manual/index.html.

17:32:43
@allrealmsoflife:matrix.orgallrealmsoflife *

Okay, I built it. I do nix --version to get the version number and add that to the flake command:

nix build nix/2.24.11#nix^doc

Otherwise just the #nix^docit won't work. One way to grab the version inside the command:

nix build nix/$(nix --version | awk '{print $3}')#nix^doc

Now the flake command builds the result-doc while the nix-build command builds the result directories. Both results do have the index.html within the ./result-doc/share/doc/nix/manual/index.html or ./result/share/doc/nix/manual/index.html.

17:33:18
@fricklerhandwerk:matrix.orgfricklerhandwerkHm, but does that build from the working directory? Why does one have to specify the version?17:40:29
@allrealmsoflife:matrix.orgallrealmsoflife

it says:

❯ nix build .#nix^doc
error: derivation '/nix/store/hddqxzfqgx2fhj8q66ss3idym7pk7aj1-nix-2.26.0pre20250107_383ab87.drv' does not have wanted outputs 'doc'

Is it missing in the flake? the nix^doc as output? I'll check

17:43:06
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @allrealmsoflife:matrix.org

it says:

❯ nix build .#nix^doc
error: derivation '/nix/store/hddqxzfqgx2fhj8q66ss3idym7pk7aj1-nix-2.26.0pre20250107_383ab87.drv' does not have wanted outputs 'doc'

Is it missing in the flake? the nix^doc as output? I'll check

Yeah it must be missing in the flake
18:09:28
@allrealmsoflife:matrix.orgallrealmsoflife

Simply running nix build .#nix-manual generates two outputs:

  • result: Contains the HTML manual, located at ./result/share/doc/nix/manual/index.html.
  • result-man: Contains the compressed man pages, located in ./result-man/man1/*.gz.

Perhaps nix^doc was used in the past, but .#nix-manual is the correct output now.

21:00:51
@allrealmsoflife:matrix.orgallrealmsoflife *

Simply running nix build .#nix-manual generates two outputs:

  • result: Contains the HTML manual.
  • result-man: Contains the compressed man pages.

Perhaps nix^doc was used in the past, but .#nix-manual is the correct output now.

21:02:22
@allrealmsoflife:matrix.orgallrealmsoflife* Simply running nix build .#nix-manual generates two outputs: result: Contains the HTML manual. result-man: Contains the compressed man pages. Perhaps nix^doc was used in the past, but .#nix-manual is the correct output now. 21:06:11
@allrealmsoflife:matrix.orgallrealmsoflife* Simply running nix build .#nix-manual generates two outputs: result: Contains the HTML manual. result-man: Contains the compressed man pages. 21:07:24
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @allrealmsoflife:matrix.org
Simply running nix build .#nix-manual generates two outputs:
result: Contains the HTML manual.
result-man: Contains the compressed man pages.
Ah, cool. Thanks for investigating! PR appreciated
21:44:44
8 Jan 2025
@allrealmsoflife:matrix.orgallrealmsoflife Interesting, the nix^doc command does work in the nixpkgs root directory where it generates then the NixOS manual. I'm making a pr though 08:18:16
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @allrealmsoflife:matrix.org
Interesting, the nix^doc command does work in the nixpkgs root directory where it generates then the NixOS manual. I'm making a pr though
You mean cd nixpkgs; nix build .#nix^doc? This is because the change to Nix's flake.nix isn't in Nixpkgs yet (2.24 in Nixpkgs vs 2.25 on master)
08:43:57
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @allrealmsoflife:matrix.org
Interesting, the nix^doc command does work in the nixpkgs root directory where it generates then the NixOS manual. I'm making a pr though
* You mean cd nixpkgs; nix build .#nix^doc? This is because the change to Nix's flake.nix isn't in Nixpkgs yet (2.24 in Nixpkgs vs 2.25 on Nix master)
08:43:59
@fricklerhandwerk:matrix.orgfricklerhandwerk * You mean cd nixpkgs; nix build .#nix^doc? This is because the change to Nix's flake.nix isn't in Nixpkgs yet (2.24.11 in Nixpkgs vs 2.25 on Nix master) 08:44:15
@allrealmsoflife:matrix.orgallrealmsoflifeI see, not sure then if changing to nix-manual is correct? I made a PR though for now08:55:14
@fricklerhandwerk:matrix.orgfricklerhandwerk
In reply to @allrealmsoflife:matrix.org
I see, not sure then if changing to nix-manual is correct? I made a PR though for now
The PR does the right thing. The most important part is that instructions are correct for each release, and primarily master
09:45:25
@fricklerhandwerk:matrix.orgfricklerhandwerk Thanks a lot for helping out, this is really valuable stuff. It prevents others from bailing out before even starting to contribute 09:45:54
@allrealmsoflife:matrix.orgallrealmsoflifeThank you, very happy to help out, I actually stream while doing all this, it's fun, hey more PR's for me xD10:14:24
10 Jan 2025
@orangepeach:matrix.orgSamir changed their display name from orangepeach to Samir.21:23:49
12 Jan 2025
@nakibrayane:matrix.orgRayane Nakib (ريّان نقيب) joined the room.12:39:38
16 Jan 2025
@fliegendewurst:matrix.orgFliegendeWurst (@GPN23) joined the room.09:38:44
17 Jan 2025
@allrealmsoflife:matrix.orgallrealmsoflife

nix-hash --help outputs:

Synopsis

    nix hash [option...] subcommand

    where subcommand is one of the following:

    Available commands:

      · 8;;./nix3-hash-file.mdnix hash file8;; - print cryptographic hash of a regular file
      · 8;;./nix3-hash-path.mdnix hash path8;; - print cryptographic hash of the NAR serialisa>
      · 8;;./nix3-hash-to-base16.mdnix hash to-base168;; - convert a hash to base-16 represent>
        hash convert instead)

I'm looking into it now, will check why the broken formatting

08:32:02
@allrealmsoflife:matrix.orgallrealmsoflife I'm should be on unstable but my nix --version shows 2.24.11 08:58:03
@allrealmsoflife:matrix.orgallrealmsoflife * I should be on unstable but my nix --version shows 2.24.11 08:58:10

Show newer messages


Back to Room ListRoom Version: 6