[Nix#9622] Document the cursed advanced derivation attributes #84

New issue

Open

opened 2024-03-16 06:44:49 +00:00 by lix-bot · 0 comments

lix-bot commented

2024-03-16 06:44:49 +00:00

Member

Upstream-Issue: NixOS/nix#9622

Problem

Currently there's a pile of cursed advanced derivation attributes that aren't described on the "advanced derivation attributes" page here: https://nix.dev/manual/nix/2.19/language/advanced-attributes

That page seems to only describe the ones that weren't deemed cursed enough to start with two underscores.

Examples:

__noChroot
__darwinAllowLocalNetworking
__structuredAttrs (even if documented on a separate page we need one page listing all the weird attributes imo)

This shitpost lists some of those ones: https://hachyderm.io/@leftpaddotpy/111587644400392006

Proposal

Grep Nix for derivation attribute access and go collect them all, then write docs. Experimental ones too: just link to the experimental feature docs for it.

Checklist

checked latest Nix manual (source)
checked open documentation issues and pull requests for possible duplicates
(i tried, not immensely hard though)

Priorities

Add 👍 to issues you find important.

Upstream-Issue: https://git.lix.systems/NixOS/nix/issues/9622 ## Problem Currently there's a pile of cursed advanced derivation attributes that aren't described on the "advanced derivation attributes" page here: https://nix.dev/manual/nix/2.19/language/advanced-attributes That page seems to only describe the ones that weren't deemed cursed enough to start with two underscores. Examples: - __noChroot - __darwinAllowLocalNetworking - __structuredAttrs (even if documented on a separate page we need one page listing all the weird attributes imo)  This shitpost lists some of those ones: https://hachyderm.io/@leftpaddotpy/111587644400392006 ## Proposal Grep Nix for derivation attribute access and go collect them all, then write docs. Experimental ones too: just link to the experimental feature docs for it.  ## Checklist  - [x] checked [latest Nix manual] \([source]) - [x] checked [open documentation issues and pull requests] for possible duplicates (i tried, not immensely hard though) [latest Nix manual]: https://nixos.org/manual/nix/unstable/ [source]: https://github.com/NixOS/nix/tree/master/doc/manual/src [open documentation issues and pull requests]: https://github.com/NixOS/nix/labels/documentation ## Priorities Add :+1: to [issues you find important](https://github.com/NixOS/nix/issues?q=is%3Aissue+is%3Aopen+sort%3Areactions-%2B1-desc).