!avYyleMexqjFHoqrME:nixos.org

Nix Documentation

416 Members
Discussion about documentation improvements around the Nix ecosystem88 Servers

Load older messages


SenderMessageTime
30 Jan 2022
@joepie91:pixie.townjoepie91 🏳️‍🌈 * wasn't deprecated according to the manual, at least00:06:47
@joepie91:pixie.townjoepie91 🏳️‍🌈it does have a caveat on what it is and isn't suitable for00:07:23
@jtojnar:matrix.orgJan Tojnaryeah, one probably would want to use the lib wrappers around it anyway00:08:27
@jtojnar:matrix.orgJan Tojnaror something like https://github.com/numtide/nix-filter00:08:38
@joepie91:pixie.townjoepie91 🏳️‍🌈once flakes stabilize, I will probably update the cheatsheet to include such single-responsibility libraries00:09:21
@jtojnar:matrix.orgJan Tojnar typo in dirOf: director 00:10:02
@joepie91:pixie.townjoepie91 🏳️‍🌈whoops :D00:10:24
@jtojnar:matrix.orgJan Tojnar I would probably list stdenv.mkDerivation first 00:13:00
@jtojnar:matrix.orgJan Tojnarif list the builtin at all00:13:13
@jtojnar:matrix.orgJan TojnarI have already seen some beginners confused by it00:13:33
@jtojnar:matrix.orgJan Tojnarsimilarly the fetching section – people will want nixpkgs fetchers 99 % of the time00:14:17
@jtojnar:matrix.orgJan Tojnar * similarly the fetching section – people will want nixpkgs fetchers 90 % of the time00:14:35
@joepie91:pixie.townjoepie91 🏳️‍🌈the nixpkgs fetchers! I knew I was forgetting something00:14:57
@joepie91:pixie.townjoepie91 🏳️‍🌈swapped around the derivation functions and added a note to only use the builtin if nixpkgs is not available00:15:21
@joepie91:pixie.townjoepie91 🏳️‍🌈will add the nixpkgs fetchers at some later time :p00:15:42
@joepie91:pixie.townjoepie91 🏳️‍🌈I've left a FIXME in my sheet00:15:49
@jtojnar:matrix.orgJan Tojnar DocBook is spelt with capital B e.g. in literalDocBook 00:16:19
@joepie91:pixie.townjoepie91 🏳️‍🌈oops00:16:48
@joepie91:pixie.townjoepie91 🏳️‍🌈fixed00:17:04
@jtojnar:matrix.orgJan Tojnar there is also pkgs.nix-gitignore if you want to avoid flakes https://nixos.org/manual/nixpkgs/stable/#sec-pkgs-nix-gitignore 00:21:20
@joepie91:pixie.townjoepie91 🏳️‍🌈ah, handy00:22:39
@joepie91:pixie.townjoepie91 🏳️‍🌈will have a look at that later00:22:49
@jtojnar:matrix.orgJan Tojnar but the functions I had in mind and actually used are lib.sources.cleanSource & co. 00:23:05
@jtojnar:matrix.orgJan Tojnar which are based on builtins.path 00:23:13
@joepie91:pixie.townjoepie91 🏳️‍🌈are those documented?00:23:21
@jtojnar:matrix.orgJan Tojnarnot sure, I mostly just look to code for docs00:23:53
@joepie91:pixie.townjoepie91 🏳️‍🌈right :p00:24:20
@jtojnar:matrix.orgJan Tojnarlooks like it is incomplete for some reason00:25:51
@jtojnar:matrix.orgJan Tojnarhttps://nixos.org/manual/nixpkgs/stable/#sec-functions-library-sources00:25:52
@joepie91:pixie.townjoepie91 🏳️‍🌈yeah that section looked weirdly empty to me00:26:46

Show newer messages


Back to Room ListRoom Version: 6