aboutsummaryrefslogtreecommitdiff
path: root/doc/manual
AgeCommit message (Collapse)Author
2019-11-26TypoEelco Dolstra
2019-11-26Merge branch 'document-dry-run-option' of https://github.com/Ma27/nixEelco Dolstra
2019-11-25Document builtins.placeholderArnout Engelen
2019-11-10manual: nix-shell: Elaborate on using `-p` with expressions.Niklas Hambüchen
This documents the outcome of the change in https://github.com/NixOS/nix/issues/454: > We can also automatically add parentheses in the generated > `buildInputs`, so you can type `nix-shell -p "expr"` > instead of `"(expr").
2019-11-07doc: Document `--dry-run` option for `nix-build`Maximilian Bosch
2019-11-05Fix manual buildEelco Dolstra
2019-11-05Merge pull request #3193 from matthewbauer/patch-11Eelco Dolstra
Update man to show that nix-shell allows --arg
2019-11-05Merge pull request #3180 from kevinastock/patch-1Eelco Dolstra
docs: fix upper bound on number of consumed cores
2019-11-05Merge pull request #3199 from kevinastock/patch-2Eelco Dolstra
docs: xref doesn't render in title
2019-11-04docs: correct default location of log directoryKevin Stock
2019-11-02docs: xref doesn't render in titleKevin Stock
The `post-build-hook` text currently appears in the index, but not on the actual title line of the section, this follows the pattern used in a previous section to get a reference into a title.
2019-11-01Update man to show that nix-shell allows --argMatthew Bauer
2019-10-30docs: fix upper bound on number of consumed coresKevin Stock
2019-10-23Merge pull request #3161 from schlarpc/patch-1Eelco Dolstra
Remove superfluous IAM action for S3 cache
2019-10-22Remove superfluous IAM action for S3 cacheChaz Schlarp
`s3:ListObjects` isn't a real IAM action, but _is_ the name of an S3 API method. `s3:ListBucket` is the relevant action for that method. https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazons3.html
2019-10-21Tweak path hintErsin Akinci
2019-10-21Add hint about path in builtins.importErsin Akinci
2019-10-21Revert "Document import <path> syntax"Ersin Akinci
This reverts commit d8730fb86facadbef22d3df7f8a743a56e7ed53c.
2019-10-20Document import <path> syntaxErsin Akinci
2019-10-17Merge pull request #2291 from Taneb/masterEelco Dolstra
nix-channel documentation: don't suggest deprecated function
2019-10-08Fix typos in the Nix Manual.Danny Bautista
2019-09-30Merge pull request #3080 from Infinisil/tryEval-docsDomen Kožar
docs: Note that tryEval doesn't do deep evaluation
2019-09-23Update garbage-collection.xml readabilityJoseph Lucas
1. remove a typo space 2. Simplify negative style by using affirmative style
2019-09-17Move 'builtins.splitVersion' to position respecting alphabetical orderAlexandre Esteves
2019-09-11docs: Use the explicit ref for fetchGit with a tagJulien Tanguy
With the merge of #2582, the syntax "tags/1.9" for refs does not work anymore. However, the new syntax "refs/tags/1.9" seems to support annotated tags, such as "refs/tags/2.0". Closes #2385.
2019-09-11docs: Fix a typo in github in an exampleJulien Tanguy
2019-09-04Tweak release notesEelco Dolstra
2019-09-04Set release dateEelco Dolstra
2019-09-03docs: Note that tryEval doesn't do deep evaluationSilvan Mosberger
2019-08-29Merge pull request #3048 from toonn/nix-env_docEelco Dolstra
Fix nix-env documentation for --delete-generations
2019-08-29Reword to clarify newer generations are left alonetoonn
My attempt at clarifying the docs resulted in a false explanation. This is now fixed and I added an example to eliminate all possible confusion.
2019-08-27Merge branch 'master' of github.com:NixOS/nixEelco Dolstra
2019-08-27Update release notesEelco Dolstra
2019-08-27Merge pull request #3056 from grahamc/operatorsEelco Dolstra
operators: document exact precedence, split up similar operators
2019-08-27Add 2.3 release notesEelco Dolstra
2019-08-27docs: operators: Make OR and AND capitalizedGraham Christensen
2019-08-24Merge pull request #2946 from vmandela/proxyGraham Christensen
installer: handle network proxy in systemd multi-user install
2019-08-24docs: document the installer's use of proxy env varsGraham Christensen
2019-08-23operators: document exact precedenc, split up similar operatorsGraham Christensen
2019-08-17Fix nix-env documentation for --delete-generationsToon Nolten
The documentation for `--delete-generations` had an erroneous fullstop and as it turns out inaccurate information on the `+No.` syntax.
2019-08-15Merge pull request #2945 from danidiaz/doc001Eelco Dolstra
Expanded documentation for .nix-defexpr
2019-08-15Merge pull request #2782 from grahamc/flamesEelco Dolstra
Track function start and end
2019-08-15Expanded documentation for .nix-defexprDaniel Diaz
2019-08-14Track function start and ends for flame graphsGraham Christensen
With this patch, and this file I called `log.py`: #!/usr/bin/env nix-shell #!nix-shell -i python3 -p python3 --pure import sys from pprint import pprint stack = [] timestack = [] for line in open(sys.argv[1]): components = line.strip().split(" ", 2) if components[0] != "function-trace": continue direction = components[1] components = components[2].rsplit(" ", 2) loc = components[0] _at = components[1] time = int(components[2]) if direction == "entered": stack.append(loc) timestack.append(time) elif direction == "exited": dur = time - timestack.pop() vst = ";".join(stack) print(f"{vst} {dur}") stack.pop() and: nix-instantiate --trace-function-calls -vvvv ../nixpkgs/pkgs/top-level/release.nix -A unstable > log.matthewbauer 2>&1 ./log.py ./log.matthewbauer > log.matthewbauer.folded flamegraph.pl --title matthewbauer-post-pr log.matthewbauer.folded > log.matthewbauer.folded.svg I can make flame graphs like: http://gsc.io/log.matthewbauer.folded.svg --- Includes test cases around function call failures and tryEval. Uses RAII so the finish is always called at the end of the function.
2019-08-08conf: stalled-download-timeout: make tunableGraham Christensen
Make curl's low speed limit configurable via stalled-download-timeout. Before, this limit was five minutes without receiving a single byte. This is much too long as if the remote end may not have even acknowledged the HTTP request.
2019-08-07fixup: docs for post-build-hookGraham Christensen
2019-08-07Merge pull request #2995 from tweag/post-build-hookEelco Dolstra
Add a post build hook
2019-08-06post-build-hook: docs fixupGraham Christensen
2019-08-02Add a post-build-hookregnat
Passing `--post-build-hook /foo/bar` to a nix-* command will cause `/foo/bar` to be executed after each build with the following environment variables set: DRV_PATH=/nix/store/drv-that-has-been-built.drv OUT_PATHS=/nix/store/...build /nix/store/...build-bin /nix/store/...build-dev This can be useful in particular to upload all the builded artifacts to the cache (including the ones that don't appear in the runtime closure of the final derivation or are built because of IFD). This new feature prints the stderr/stdout output to the `nix-build` and `nix build` client, and the output is printed in a Nix 2 compatible format: [nix]$ ./inst/bin/nix-build ./test.nix these derivations will be built: /nix/store/ishzj9ni17xq4hgrjvlyjkfvm00b0ch9-my-example-derivation.drv building '/nix/store/ishzj9ni17xq4hgrjvlyjkfvm00b0ch9-my-example-derivation.drv'... hello! bye! running post-build-hook '/home/grahamc/projects/github.com/NixOS/nix/post-hook.sh'... post-build-hook: + sleep 1 post-build-hook: + echo 'Signing paths' /nix/store/qr213vjmibrqwnyp5fw678y7whbkqyny-my-example-derivation post-build-hook: Signing paths /nix/store/qr213vjmibrqwnyp5fw678y7whbkqyny-my-example-derivation post-build-hook: + sleep 1 post-build-hook: + echo 'Uploading paths' /nix/store/qr213vjmibrqwnyp5fw678y7whbkqyny-my-example-derivation post-build-hook: Uploading paths /nix/store/qr213vjmibrqwnyp5fw678y7whbkqyny-my-example-derivation post-build-hook: + sleep 1 post-build-hook: + printf 'very important stuff' /nix/store/qr213vjmibrqwnyp5fw678y7whbkqyny-my-example-derivation [nix-shell:~/projects/github.com/NixOS/nix]$ ./inst/bin/nix build -L -f ./test.nix my-example-derivation> hello! my-example-derivation> bye! my-example-derivation (post)> + sleep 1 my-example-derivation (post)> + echo 'Signing paths' /nix/store/c263gzj2kb2609mz8wrbmh53l14wzmfs-my-example-derivation my-example-derivation (post)> Signing paths /nix/store/c263gzj2kb2609mz8wrbmh53l14wzmfs-my-example-derivation my-example-derivation (post)> + sleep 1 my-example-derivation (post)> + echo 'Uploading paths' /nix/store/c263gzj2kb2609mz8wrbmh53l14wzmfs-my-example-derivation my-example-derivation (post)> Uploading paths /nix/store/c263gzj2kb2609mz8wrbmh53l14wzmfs-my-example-derivation my-example-derivation (post)> + sleep 1 my-example-derivation (post)> + printf 'very important stuff' [1 built, 0.0 MiB DL] Co-authored-by: Graham Christensen <graham@grahamc.com> Co-authored-by: Eelco Dolstra <edolstra@gmail.com>
2019-08-02Tweak min-free/max-free descriptionsEelco Dolstra