Age | Commit message (Collapse) | Author |
|
|
|
|
|
- make `<nixpkgs>` visible (was blank in the rendered version)
|
|
Fix update operator usage in operators.md
|
|
|
|
Escape logical or pipe in markdown table according to https://github.github.com/gfm/#example-200
|
|
this makes the table less unwieldy, and leaves enough space for
extensive explanations.
|
|
|
|
|
|
|
|
add notes on semantics where appropriate
|
|
this form is much easier to maintain (also with minimal diffs), and
allows for more details on each operator.
this change a purely mechanical transformation, without changing any contents.
|
|
this is for a simpler transformation into a series of subsections
|
|
as proposed by @mkaito[1] and @tazjin[2] and discussed with @edolstra
and Nix maintainers
[1]: https://github.com/NixOS/nix.dev/pull/267#issuecomment-1270076332
[2]: https://github.com/NixOS/nix.dev/pull/267#issuecomment-1270201979
Co-authored-by: John Ericson <git@JohnEricson.me>
Co-authored-by: Eelco Dolstra <edolstra@gmail.com>
|
|
it is not possible to antiquote numbers.
|
|
add syntax overview from NixOS manual
|
|
after discussing this with multiple people, I'm convinced that "build
task" is more precise: a derivation is not an action, but inert until it
is built. also it's easier to pronounce.
proposal: use "build task" for the generic concept "description of how
to derive new files from the contents of existing files". then it will
be easier to distinguish what we mean by "derivation" (a specific data
structure and Nix language value type) and "store derivation" (a
serialisation of a derivation into a file in the Nix store).
|
|
Specifically, explain why Nix does not _re_evaluate paths during a
`nix repl` session. This is a thing that bit me while playing around
with paths and antiquotation in `nix repl` while reading the Nix
language tutorial at https://nix.dev/tutorials/nix-language.
Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
|
|
|
|
the list style is supposed to give more structure.
each property is explained as concisely as possible while trying not to
sound too fancy.
|
|
|
|
keep some indentation to ease source readability
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
taken verbatim to keep track of required corrections.
made it an HTML table to more easily change structure and keep diffs
minimal.
|
|
it is out of date, all over the place in level of detail, is really
about `nixpkgs`, and in general instructions should not be part of
a reference manual.
also:
- update redirects and internal links
- use "Nix language" consistently
|