aboutsummaryrefslogtreecommitdiff
path: root/src/nix/nix.md
AgeCommit message (Collapse)Author
2024-04-29docs: clarify how ^ works for -E/-f installablesQyriad
We didn't even realize you *could* use this syntax with -E and -f, much less that the attribute path could be *empty*. Change-Id: Id1a6715609f3a76a5ce477bd43a7832effbbe07b
2024-04-29docs: give translation examples from nix-build -E/-A to installablesQyriad
Change-Id: I03f4c7c1049063539a35ba500a07bb8f866d4cb7
2024-04-29docs: clarify how the different kinds of installables are selectedQyriad
Change-Id: I146736bb97ebe035e04be69ce9fb60a557e38c6c
2024-04-29docs: guide to installables docs in installable commands' docsQyriad
The installables syntax is not documented in any of the man pages or docbook pages for any of those individual commands. And while these commands really should at least peripherally individually document how installables work, in the meantime we can at least direct people to the right place. This commit also clarifies the unexpected fact that `nix profile remove` and `nix profile upgrade` do *not* take installables. Change-Id: I3b1453cb197a613bbab639c66a466365c3592c6d
2023-07-10Fix some grammar in installables doc (#8682)Bader AlAttar
2023-06-04Fix code block formatting in man pagefigsoda
2023-05-17Also use long options in src/nix/*.mdAlexander Schmolck
2023-04-14Start cross-referencing experimental featuresJohn Ericson
- Create a glossary entry for experimental features. - Have the man page experimental feature notice link `nix-commmand`. (Eventually this should be programmed, based on whether the command is experimental, and if so what experimental feature does it depend on.) - Document which installables depend on which experimental features. I tried to use the same style (bold warning and block quote) that the top of the man page uses. Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2023-03-21Move store docs to 'nix help-stores'Eelco Dolstra
Why not 'nix help stores'? Well, 'nix help <arg>' already means 'show help on the "arg" subcommand'.
2023-03-06output paths of store derivations are now addressed explicitlyValentin Gagarin
2023-03-05clarify definition of "installable"Valentin Gagarin
the term was hard to discover, as its definition and explanation were in a very long document lacking an overview section. search did not help because it occurs so often. - clarify wording in the definition - add an overview of installable types - add "installable" to glossary - link to definition from occurrences of the term - be more precise about where store derivation outputs are processed - installable Nix expressions must evaluate to a derivation Co-authored-by: Adam Joseph <54836058+amjoseph-nixpkgs@users.noreply.github.com>
2023-03-05make descriptions of each installable type an own subsectionValentin Gagarin
this is easier to edit, provides anchors for free, and renders correctly on the terminal without additional effort.
2023-01-02remove redundant re-definition of store derivationsValentin Gagarin
2022-12-21link "store derivation" to glossary definitionValentin Gagarin
2022-12-21update description of "store derivation" in installables sectionValentin Gagarin
a store derivation is not a store path itself, it has a store path.
2022-12-12Fix typos in the docs John Ericson
Thanks! Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>
2022-12-12Adjust docsJohn Ericson
2022-12-12Apply suggestions from code reviewJohn Ericson
Co-authored-by: Eelco Dolstra <edolstra@gmail.com>
2022-07-15Leverage existing docs for new store-path^outputs syntaxJohn Ericson
2022-07-15Fix typo in docs John Ericson
Thanks! Co-authored-by: Eelco Dolstra <edolstra@gmail.com>
2022-07-15Remove `computed-derivations` experimental featureJohn Ericson
We don't need it yet.
2022-07-14Fix bug, test more, document moreJohn Ericson
2022-05-12Use `^` not `!` in indexed store derivations installable syntaxJohn Ericson
Match the other syntax that was recently added
2022-05-12Merge remote-tracking branch 'upstream/master' into indexed-store-path-outputsJohn Ericson
2022-05-03Allow selecting derivation outputs using 'installable!outputs'Eelco Dolstra
E.g. 'nixpkgs#glibc^dev,static' or 'nixpkgs#glibc^*'.
2022-04-07Add release notes mark experimentalJohn Ericson
2022-03-10Merge remote-tracking branch 'upstream/master' into indexed-store-path-outputsJohn Ericson
2022-02-22Update docsEelco Dolstra
2022-01-30fix spelling mistakes reported by Debian's lintian toolThomas Koch
2022-01-18Fix the rendering of the example directory treeregnat
2022-01-17Update documentation for paths on command lineAlexander Bantyev
Co-authored-by: Théophane Hufschmitt <7226587+thufschmitt@users.noreply.github.com>
2022-01-14Document searching upwards and fix documentation for installablesAlexander Bantyev
2021-04-06New "indexed" installable syntax: `<drvPath>!<outputName>`John Ericson
Being conservative and only doing a single output name for now.
2020-12-23Add 'nix' manpageEelco Dolstra