aboutsummaryrefslogtreecommitdiff
path: root/doc/manual/src/command-ref
AgeCommit message (Collapse)Author
2022-07-10Fix logical and typographical errors in nix-env man pagelaalsaas
2022-06-14Add disambiguation to man pageHugo Osvaldo Barrera
This should help future lost newcomers like myself understand where to find the docs for both of these commands and how they differ.
2022-05-27Merge branch 'doc-redirects' of https://github.com/jtojnar/nixEelco Dolstra
2022-05-26doc: Manually insert some anchorsJan Tojnar
2022-05-26doc: Add anchors to long listsJan Tojnar
Added using the following sed scripts: - For command-ref/opt-common.md: s~- `(--?)([^`]+)`~- [`\1\2`]{#opt-\2}~g - For expressions/builtin-constants.md: s~- `(builtins\.?)([^`]+)`~- [`\1\2`]{#builtins-\2}~g - For expressions/advanced-attributes.md s~^ - `([^`]+)`~ - [`\1`]{#adv-attr-\1}~g and manually adjusted outputHashAlgo & outputHashMode. - For glossary.md s~^ - (`([^`]+)`|(.+)) ?\\~ - [\1]{#gloss-\2\3}\\~g; s~(gloss-\w+) ~\1-~g and manually adjusted anchors for Nix expression, user environment, NAR, ∅ and ε. - For command-ref/env-common.md s~^ - `([^`]+)`~ - [`\1`]{#env-\1}~g'
2022-05-26Tweak IN_NIX_SHELL descriptionEelco Dolstra
2022-02-23Precise the doc for `--include-outputs`Théophane Hufschmitt
Make it explicit that it only includes the existing outputs and not the ones that haven’t been realised
2022-01-21Correct NIX_BUILD_PATH default descriptionRoss Light
Source: https://github.com/NixOS/nix/blob/067076287bf601f8fa2ffe4feff3057b96fa5be8/src/nix-build/nix-build.cc#L362-L381
2021-11-18Merge pull request #5585 from jtojnar/env-aEelco Dolstra
doc: De-emphasize nix-env without -A
2021-11-17doc: De-emphasize nix-env without -AJan Tojnar
The manual uses `nix-env -i` without `-A` prominently, teaching a bad practice to newcomers.
2021-11-17Fix XDG_CONFIG_DIRS fallbackJan Tojnar
According to XDG Base Directory Specification, it should fall back to /etc/xdg when the env var is not present.
2021-11-04docs: Correct fallback user config pathJan Tojnar
This is in line with XDG Base Directory Specification, where ~/.config is supposed to be used when XDG_CONFIG_HOME is unset. It also better matches the reality, where ~/.config/nix.conf does not seem to be used.
2021-11-03Fix typosDimitris Apostolou
2021-11-02command-ref/nix-shell: fix --pure, --keepSimon Legner
2021-10-17Clarify that not all nix packages will use the default build phasesJohn Chapman
2021-10-09Clarify that not all nix packages will use the default build phasesJohn Chapman
2021-06-03Improve explanation of NIX_PATH prefix syntaxKeshav Kini
The previous wording seemed to imply that the "channel:" syntax would resolve to a github archive URL, which is not the case.
2021-05-11doc/nix-shell: Remove outdated bashrc informationLinus Heckemann
This behaviour was removed in 65f6d5db6f5ef2724a3dc03e1773c510123287f1.
2021-04-23Replace the trailing markdown spaces by a backslashregnat
They are equivalent according to <https://spec.commonmark.org/0.29/#hard-line-breaks>, and the trailing spaces tend to be a pain (because the make git complain, editors tend to want to remove them − the `.editorconfig` actually specifies that − etc..).
2021-03-26Fix some typosEelco Dolstra
Fixes #4671.
2021-03-06remove doc for obsolete --no-build-hook flagTravis A. Everett
`--no-build-hook` appears to have been removed in 25f32625e2f2a3a1e1b3a3811da82f21c3a3b880
2021-02-16Update doc/manual/src/command-ref/nix-shell.mdMauricio Scheffer
Co-authored-by: Cole Helbling <cole.e.helbling@outlook.com>
2021-02-16Fix Haskell exampleMauricio Scheffer
http://nixos.org redirects to https://nixos.org and apparently the HTTP library doesn't follow the redirect, so the output is empty. When defining https in the request it crashes because the library doesn't seem to support https. So this switches the example to a different http library.
2021-01-11TweakEelco Dolstra
2020-10-30Merge pull request #4202 from hercules-ci/nix-shell-docEelco Dolstra
Nix shell doc
2020-10-30nix-shell.md: Extend shellHook exampleRobert Hensing
2020-10-30nix-shell.md: evaluated -> runRobert Hensing
Use "run" to avoid confusion with Nix evaluation. "evaluated" was intended to reference bash eval but it's ambiguous.
2020-10-29Generalize extra-* settingsEelco Dolstra
This removes the extra-substituters and extra-sandbox-paths settings and instead makes every array setting extensible by setting "extra-<name> = <value>" in the configuration file or passing "--<name> <value>" on the command line.
2020-10-25Add sha512 to hashAlgo listings in manpages (#4186)tnias
2020-10-21Fix the docs about the new NIX_CONFIG env varJosef Kemetmüller
This was accidentally documented as NIX_OPTIONS.
2020-10-21Add NIX_CONFIG env var for applying nix.conf overridesChristian Kampka
2020-10-18doc: nix-shell in pure mode does *not* source user bashrcStefan Frijters
2020-10-08Remove stray 'Title:' from the manualEelco Dolstra
Closes #4096.
2020-09-18nix-prefetch-url: Add --executable flagBryan Richter
pkgs.fetchurl supports an executable argument, which is especially nice when downloading a large executable. This patch adds the same option to nix-prefetch-url. I have tested this to work on the simple case of prefetching a little executable: 1. nix-prefetch-url --executable https://my/little/script 2. Paste the hash into a pkgs.fetchurl-based package, script-pkg.nix 3. Delete the output from the store to avoid any misidentified artifacts 4. Realise the package script-pkg.nix 5. Run the executable I repeated the above while using --name, as well. I suspect --executable would have no meaningful effect if combined with --unpack, but I have not tried it.
2020-09-03Remove the --indirect flagEelco Dolstra
All GC roots are now indirect.
2020-08-31Merge remote-tracking branch 'origin/master' into markdownEelco Dolstra
2020-08-19Generate the nix.conf docs from the source codeEelco Dolstra
This means we don't have two (divergent) sets of option descriptions anymore.
2020-08-17Start generation of the nix.1 manpageEelco Dolstra
2020-08-17Merge remote-tracking branch 'origin/master' into markdownEelco Dolstra
2020-07-31Merge remote-tracking branch 'origin/master' into markdownEelco Dolstra
2020-07-31console -> shellEelco Dolstra
2020-07-31Enable syntax highlightingEelco Dolstra
2020-07-24Fix internal linksEelco Dolstra
2020-07-24Fix some dangling referencesEelco Dolstra
2020-07-24Fix nix-copy-closure manpageEelco Dolstra
2020-07-24Clean up the manpagesEelco Dolstra
2020-07-24Get rid of footnotesEelco Dolstra
Markdown doesn't support them.
2020-07-23<replaceable> -> <emphasis>Eelco Dolstra
Pandoc doesn't know <replaceable> so let's force it to be rendered as italics.
2020-07-23Convert commandsEelco Dolstra
2020-07-23Convert nix.conf manpageEelco Dolstra