!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
@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
@allrealmsoflife:matrix.orgallrealmsoflifeSomeone on the stream following along is on flakes with nixos unstable and they have nix on 2.25.309:02:25
@allrealmsoflife:matrix.orgallrealmsoflife Yeah, I updated the nix by adding nix.Versions.latest to my configuration.nix and it renders fine now. Still, does something like this warrant a PR since it does look broken on the current nix version in stable/unstable. 09:13:17
@allrealmsoflife:matrix.orgallrealmsoflifeActually we just found that someone already opened an issue about this: https://github.com/NixOS/nix/issues/1195809:17:33
@allrealmsoflife:matrix.orgallrealmsoflifeRoberth mentioned in a comment that the fix accidentally was not backported to 24.11, and is unreleased as of writing (last week)09:31:31
18 Jan 2025
@draketdl:matrix.orgDrakeTDL joined the room.01:08:38
20 Jan 2025
@federicodschonborn:matrix.orgThe Worm 🏳️‍🌈 (he/they) changed their display name from LEGO® Worm™ to Leg O'Worm.01:31:10

Show newer messages


Back to Room ListRoom Version: 6