| 16 Mar 2024 |
 danielsidhion | I agree with the other arguments though - python is more approachable than c | 04:10:07 |
 @jade_:matrix.org | (for what it's worth i would be very suspicious of any man page generation plugin) | 04:10:08 |
| *  infinisil agrees with giving nrd a fairer try. Having looked at the code base, it seems very approachable | 04:10:46 |
| @jade_:matrix.org | (generally man page generators (especially if they are bolted on the side of something else) are very very much trying to fit something that's not a man page into the shape of a man page and not considering the range of semantic expressiveness of the format) | 04:11:26 |
| danielsidhion | In reply to @jade_:matrix.org
i still can't understand why everyone's immediate thought is constantly to replace nrd other than for lack of desire to look at the code and how it can achieve the goals set out I've looked at the code already, and the effort to get it to where I'd like it to be is not insignificant | 04:11:42 |
| danielsidhion | Which is why I'm looking at other options too | 04:11:55 |
 kait | now for my main motivation for joining: what happened to the main manual? is there any announcement or documentation regarding the changes? | 04:25:16 |
| infinisil | kait/: Oh you mean because it looks different now? | 04:25:43 |
| kait | it does! | 04:25:50 |
| infinisil | kait/: That's a regression caused by the marketing team, see https://github.com/NixOS/nixos-homepage/issues/1251, unfortunately it was ignored.. | 04:27:04 |
| infinisil | danielsidhion here is the hero stepping in with a fix in https://github.com/NixOS/nixpkgs/pull/295847 🚀 | 04:28:09 |
| kait | oh gosh! | 04:28:51 |
| kait | so it is not permanent (relieved 😌) | 04:29:14 |
| danielsidhion | (that PR is just waiting for approvals or more requests for changes btw!) | 04:29:23 |
| infinisil | kait/: Good rule in Nix in general: Things can be shitty for arbitrarily long, untli somebody decides to improve them | 04:30:53 |
| infinisil | And arbitrary long can be really long, like decades lol | 04:31:19 |
| kait | i am starting to see that. though, i do not mind pitching in where i can :) | 04:31:55 |
| danielsidhion | That PR won't get the manuals to exactly like they were before, but I'd say it gets ~95% of the way there, which is enough to give us time to resume improving the content and keep researching options to find where we want to be in the long term | 04:32:50 |
 ryantm | The need for a fast and very low dependency tool for building the NixOS manual during builds was the original motivation behind mmdoc. | 04:40:21 |
| infinisil | ryantm: Can you compare the numbers between nrd and mmdoc? | 04:41:28 |
| infinisil | I don't think nrd is heavy on dependencies, and it seems really fast too | 04:41:52 |
| ryantm | Does someone have nrd building NixOS or Nixpkgs? | 04:42:24 |
| ryantm | NixOS or Nixpkgs manuals* | 04:43:10 |
| danielsidhion | nrd is the tool that builds them by default right now | 04:43:21 |
| danielsidhion | (we shorten it to nrd to avoid writing nixos-render-docs) | 04:43:42 |
| ryantm | Oh okay. I wasn't aware of the acronym. | 04:44:14 |
| ryantm | It probably won't be a fair comparison since my mmdoc thing isn't doing anything with the options currently. | 04:45:53 |
| ryantm | [ryantm@replit1:~/p/nixpkgs]$ /run/current-system/sw/bin/time nix build --rebuild .#nixpkgs-manual-mmdoc
error: derivation '/nix/store/7fgbi0ril4y59cmfdsnsiv68v044l1h4-nixpkgs-minimal-manual.drv' may not be deterministic: output '/nix/store/zyax\
mgz2lknn4jgd9600g0j9bdxfyjh6-nixpkgs-minimal-manual' differs
Command exited with non-zero status 1
0.06user 0.18system 0:02.05elapsed 12%CPU (0avgtext+0avgdata 25868maxresident)k
0inputs+0outputs (0major+6371minor)pagefaults 0swaps
[ryantm@replit1:~/p/nixpkgs]$ /run/current-system/sw/bin/time nix build --rebuild .#nixos-manual-mmdoc
error: derivation '/nix/store/8288zinh5j2v1w920ra7p5yw5dbp72pl-nixos-minimal-manual.drv' may not be deterministic: output '/nix/store/z2mllr\
8w9wrppxhz8vn87sw1qd3vmb43-nixos-minimal-manual' differs
Command exited with non-zero status 1
0.06user 0.19system 0:01.17elapsed 21%CPU (0avgtext+0avgdata 25840maxresident)k
0inputs+0outputs (0major+6369minor)pagefaults 0swaps
| 04:50:50 |
| ryantm | closures of inputDerivations https://gist.github.com/ryantm/e7fde94d7f0aeb7ebd334015b310b659 | 04:53:53 |
| ryantm | I don't really know how to run nixos-render-docs will try to learn though. | 04:57:53 |
