!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

404 Members
Discussion about documentation improvements around the Nix ecosystem78 Servers

Load older messages


SenderMessageTime
22 Jul 2021
@linus.heckemann:matrix.mayflower.deLinux Hackerman pixelfog: you can also build the manual for your exact nixpkgs version by running nix-build path/to/nixpkgs/doc 17:28:50
@pixelfog:matrix.orgpixelfog
In reply to @linus.heckemann:matrix.mayflower.de
pixelfog: you can also build the manual for your exact nixpkgs version by running nix-build path/to/nixpkgs/doc
Linux Hackerman: I'll attach a screenshot of what happens when I try to build the 18.09 docs using 20.09 tools.
18:57:49
@pixelfog:matrix.orgpixelfogDownload building_nix_docs.png18:58:16
@linus.heckemann:matrix.mayflower.deLinux Hackerman pixelfog: huh, works for me. You're on 6a3f5bcb061e1822f50e299f5616a0731636e4e7 with no changes? 19:20:42
@linus.heckemann:matrix.mayflower.deLinux Hackermanoh right, I'm on 21.05, not 20.09, but it looks like you are too19:21:01
@pixelfog:matrix.orgpixelfogCorrect...on 6a3f5b, and 21.05. Oh...interesting. You said "no changes?", so in my nixpkgs tree, I ran "git clean -ndx", and there were a bunch of generated files in the doc/ tree. So I ran "git clean -fdx", and then "nix-build ./doc", and the manual built successfully. Woohoo! 19:25:41
@pixelfog:matrix.orgpixelfogThanks!19:27:10
23 Jul 2021
Room Avatar Renderer.23:22:54
28 Jul 2021
@edlimerkaj:matrix.orgedlimerkaj joined the room.09:24:44
@edlimerkaj:matrix.orgedlimerkajHi everyone, I hope you all are doing great. I'm very new to this community and I'm not sure whether this is the right discussion to join to ask questions, but I'm giving it a try. I am currently trying to build a Go package and I'm trying to use buildFlagsArray, which from my understanding can be used to pass the same options as go build. Even though I'm not sure how to pass more than one option, so let's say "-X ..." and "-o ...". Is that possible? Also, can somebody please provide me with any explanation about the "-s" and "-w" options passed to buildFlagsArray. I was not able to find anything relatable to this in the nix manual or pills, so didn't know where else to ask. Thank you so much for your time in advance. 09:25:57
@infinisil:matrix.orginfinisil edlimerkaj: Both this channel and #nix-lang:nixos.org are the wrong place to ask. For help with nix/nixpkgs you'll want to ask in #nix:nixos.org 10:47:24
@edlimerkaj:matrix.orgedlimerkajSure, thank you for letting me know. 10:48:53
@matto153:matrix.orgMatthias Meschede joined the room.13:06:26
2 Aug 2021
@domenkozar:matrix.orgDomen Kožaras I wrote https://nix.dev/tutorials/building-bootable-iso-image I got a question where are all modules inputs documented, are they anywhere?13:37:16
@domenkozar:matrix.orgDomen KožarI couldn't find it13:37:19
@blaggacao:matrix.orgDavid Arnold (blaggacao)
In reply to @domenkozar:matrix.org
as I wrote https://nix.dev/tutorials/building-bootable-iso-image I got a question where are all modules inputs documented, are they anywhere?
Why sync at the end? 🧐
13:42:30
@domenkozar:matrix.orgDomen Kožardd doesn't ensure things are written to the disk13:43:40
@domenkozar:matrix.orgDomen Kožaralmost no program does that and given that you're likely to unplug it very soon..13:44:15
@blaggacao:matrix.orgDavid Arnold (blaggacao)Yeah good point! 🙂13:44:37
@infinisil:matrix.orginfinisil domenkozar: You mean the lib, config, options, etc..? 14:39:07
@domenkozar:matrix.orgDomen Kožaryeah14:39:33
@infinisil:matrix.orginfinisildomenkozar: I don't think they're documented anywhere, but in general NixOS modules, these three are always there14:40:22
@infinisil:matrix.orginfinisil But you can have arbitrary others via _module.args, specialArgs or args 14:41:00
@infinisil:matrix.orginfinisil NixOS specifically sets some more, like _module.args.pkgs, specialArgs.modulesPath, args.{baseModules,extraModules,modules} 14:41:54
@infinisil:matrix.orginfinisilI think that's all of them, relevant file is https://github.com/NixOS/nixpkgs/blob/master/nixos/lib/eval-config.nix14:42:16
@domenkozar:matrix.orgDomen Kožar infinisil: could you add that to https://github.com/NixOS/nixpkgs/issues/132419 14:43:44
@infinisil:matrix.orginfinisilYeah can do14:44:14
@domenkozar:matrix.orgDomen Kožarthanks!14:53:04
3 Aug 2021
@blaggacao:matrix.orgDavid Arnold (blaggacao) Does anybody associate a certain known failure mode with such strange example rendering? 03:17:44
5 Aug 2021
@jtojnar:matrix.orgJan Tojnar David Arnold: your renderer needs to support literalExample, e.g. https://github.com/NixOS/nixpkgs/blob/71b64e83077762aa44c6c7346e913c9bacb9fa73/nixos/lib/make-options-doc/options-to-docbook.xsl#L66-L68 07:31:17

Show newer messages


Back to Room ListRoom Version: 6