aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/src/language
AgeCommit message (Collapse)Author
2023-01-20doc: fix update operator descriptionFlorian Paul Schmidt
2023-01-19Merge pull request #7629 from phip1611/patch-3Valentin Gagarin
2023-01-19doc: update language/index.mdPhilipp Schuster
- make `<nixpkgs>` visible (was blank in the rendered version)
2023-01-19Merge pull request #7640 from marceltransier/patch-2Eelco Dolstra
Fix update operator usage in operators.md
2023-01-19Fix update operator usage in operators.mdMarcel Transier
2023-01-18Fix markdown error in operators.mdMarcel Transier
Escape logical or pipe in markdown table according to https://github.github.com/gfm/#example-200
2023-01-05bring back table, extract annotationsValentin Gagarin
this makes the table less unwieldy, and leaves enough space for extensive explanations.
2023-01-05add links to documentation for data typesValentin Gagarin
2023-01-05use more self-explanatory placeholder namesValentin Gagarin
2023-01-05add semantics of overloaded `+` operatorValentin Gagarin
2023-01-05reword descriptions of operatorsValentin Gagarin
add notes on semantics where appropriate
2023-01-05convert table to subsectionsValentin Gagarin
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.
2023-01-05reorder columnsValentin Gagarin
this is for a simpler transformation into a series of subsections
2023-01-02antiquotation -> string interpolationValentin Gagarin
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>
2022-11-22fix error in language overviewValentin Gagarin
it is not possible to antiquote numbers.
2022-11-09Merge pull request #6906 from fricklerhandwerk/language-overviewValentin Gagarin
add syntax overview from NixOS manual
2022-11-06manual: build action -> build taskValentin Gagarin
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).
2022-10-19Explain how Nix handles antiquotation of pathsJohan Herland
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>
2022-08-31do not use unwarranted pkgs in exampleValentin Gagarin
2022-08-15reword description of language propertiesValentin Gagarin
the list style is supposed to give more structure. each property is explained as concisely as possible while trying not to sound too fancy.
2022-08-15reword introduction to overviewValentin Gagarin
2022-08-15fix whitespace to please markdownValentin Gagarin
keep some indentation to ease source readability
2022-08-15add more examples on string interpolationValentin Gagarin
2022-08-15add more list examplesValentin Gagarin
2022-08-15add curried functionValentin Gagarin
2022-08-15add second @ pattern exampleValentin Gagarin
2022-08-15add nullValentin Gagarin
2022-08-15add home pathValentin Gagarin
2022-08-15add search pathValentin Gagarin
2022-08-15add absolute pathValentin Gagarin
2022-08-15add floating point numberValentin Gagarin
2022-08-15add multi-line stringValentin Gagarin
2022-08-15flarify relative path semanticsValentin Gagarin
2022-08-15make hash and version distinguishable as placeholderValentin Gagarin
2022-08-15remove stale section linkValentin Gagarin
2022-08-15add syntax overview from NixOS manualValentin Gagarin
taken verbatim to keep track of required corrections. made it an HTML table to more easily change structure and keep diffs minimal.
2022-08-04manual: remove "Writing Nix Expressions" chapterValentin Gagarin
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