nixpkgs/doc
Robert Hensing 01d7f19346 multi-outputs.sh: Improve _assignFirst error message
Closes #16182

This improves the error message

    Error: _assignFirst found no valid variant!

which occurred when the set of outputs was not sufficient to set
the various outputDev, outputBin, etc variables. Specifically, this
would mean that "out" is not among the outputs, which is valid for
a derivation.

This changes the message to something like

    error: _assignFirst: could not find a non-empty variable to assign to outputDev. The following variables were all unset or empty: dev out.
          If you did not define an "out" output, make sure to define all the specific required outputs: define an output for one of the unset variables.

While this isn't a full explanation of what stdenv can and can not do,
I think it's vast improvement over the 0 bits of information that it
used to provide. This at least gives a clue as to what's going on, and
even suggests a fix, although probably multiple such fixes are required
in an instance where someone starts with a no-out derivation from scratch
(and decide to persist).
2023-01-16 12:57:01 +01:00
..
build-aux/pandoc-filters doc/filters: fix myst-reader role detection 2023-01-10 10:31:51 +01:00
builders darwin.builder: auto-login as the builder user (#208772) 2023-01-03 21:12:56 -08:00
contributing Merge pull request #208762 from ncfavier/link-manpages-options-doc 2023-01-09 11:57:01 +01:00
doc-support lib.path.subpath.isValid: init 2023-01-03 13:20:36 +01:00
functions doc,nixos/doc: unescape apostrophes 2022-12-27 17:13:47 +01:00
hooks patchRcPathBash, patchRcPathCsh, patchRcPathFish, patchRcPathPosix: init 2022-11-10 09:23:52 +08:00
languages-frameworks Merge master into staging-next 2023-01-14 11:12:34 +00:00
old doc: fix typos 2022-12-17 18:21:48 -05:00
stdenv multi-outputs.sh: Improve _assignFirst error message 2023-01-16 12:57:01 +01:00
using lib/customisation.overrideDerivation: propagate evaluation condition 2023-01-01 14:10:42 +01:00
.gitignore
default.nix doc: separate manpage URLs from the Pandoc filter 2023-01-02 14:11:22 +01:00
functions.xml doc/functions/generators: convert to CommonMark 2021-06-11 06:06:42 -07:00
Makefile doc: separate manpage URLs from the Pandoc filter 2023-01-02 14:11:22 +01:00
manpage-urls.json doc: separate manpage URLs from the Pandoc filter 2023-01-02 14:11:22 +01:00
manual.xml doc: move testers to their own chapter 2022-04-22 16:24:29 +03:00
overrides.css
preface.chapter.md updating stable nixos version in preface. 2023-01-05 22:24:19 +00:00
README.md doc/README.md: Add more links 2021-03-06 12:35:33 +01:00
shell.nix doc: fix shell.nix (#109816) 2021-01-19 12:46:51 -05:00
style.css

Nixpkgs/doc

This directory houses the sources files for the Nixpkgs manual.

You can find the rendered documentation for Nixpkgs unstable on nixos.org.

Docs for Nixpkgs stable are also available.

If you want to contribute to the documentation, here's how to do it.

If you're only getting started with Nix, go to nixos.org/learn.