about summary refs log tree commit diff
path: root/doc
AgeCommit message (Collapse)AuthorFilesLines
2020-03-13 style.css: RemoveEelco Dolstra2-265/+1
This file is licensed under the GPL. Originally, Nix was also GPL-licensed so that was fine. However, we later changed the license to the LGPL but missed the fact that style.css has an incompatible license. Since the Nix manual at nixos.org uses its own styling, we can remove this file. Fixes #3392. (cherry picked from commit 9c7e90f414067eb59170bde952d5b8ac03c8f46c)
2020-02-18 doc: touchup release notes for 2.3Benjamin Hipple1-8/+7
- At the top of the release notes, we announce sandboxing is now enabled by default, then at the bottom it says it's now disabled when missing kernel support. These can be merged into one point for clarity. - The point about `max-jobs` defaulting to 1 appears unrelated to sandboxing. (cherry picked from commit 5d24e18e29ea1fff8fa316701fd95be6941da770)
2020-01-04 Document builtins.placeholderArnout Engelen1-0/+10
(cherry picked from commit 4e70652ee33641a6cfddbfb9b7d741515f1bf98a)
2020-01-04 doc: Document `--dry-run` option for `nix-build`Maximilian Bosch1-0/+5
(cherry picked from commit 52ffe2797a6a943bac968e92ad443a567dfdf80e)
2020-01-04 docs: correct default location of log directoryKevin Stock1-1/+1
(cherry picked from commit cea05e5ee758daad40047db0b861980d80da2e85)
2020-01-04 Remove superfluous IAM action for S3 cacheChaz Schlarp1-1/+0
`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 (cherry picked from commit c92ea927e508f3c06b6b3ee68e1f0565264cac2c)
2020-01-04 Tweak path hintErsin Akinci1-1/+2
(cherry picked from commit f107a270026596e525bdf8df0e2d331783ec4a10)
2020-01-04 Add hint about path in builtins.importErsin Akinci1-0/+4
(cherry picked from commit b7a936224ee6e1ad9c842f618bbd5bc1864ebd54)
2020-01-04 Revert "Document import <path> syntax"Ersin Akinci1-9/+1
This reverts commit d8730fb86facadbef22d3df7f8a743a56e7ed53c. (cherry picked from commit 9be7787ec04d604a4e65a22a6b9ae56567aaf618)
2020-01-04 Document import <path> syntaxErsin Akinci1-1/+9
(cherry picked from commit d8730fb86facadbef22d3df7f8a743a56e7ed53c)
2019-10-09 docs: Note that tryEval doesn't do deep evaluationSilvan Mosberger1-2/+8
(cherry picked from commit e4ea3e03066a760c8cd462108af99aebaaa44c1b)
2019-10-09 docs: Fix a typo in github in an exampleJulien Tanguy1-1/+1
(cherry picked from commit 92ede15dd902f7c1d2771c194b8bb73fe406840f)
2019-10-09 docs: Use the explicit ref for fetchGit with a tagJulien Tanguy1-4/+1
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. (cherry picked from commit ae244af242ca3621e5a3b9196f27d9fcbf297266)
2019-10-09 Move 'builtins.splitVersion' to position respecting alphabetical orderAlexandre Esteves1-12/+13
(cherry picked from commit 9533d85ce009c65722a2addc55b64ee51f15dea3)
2019-10-09 Update garbage-collection.xml readabilityJoseph Lucas1-5/+6
1. remove a typo space 2. Simplify negative style by using affirmative style (cherry picked from commit 10bfc5c0d09d5508e3dab4c32f3368caeb5f7f56)
2019-10-09 Fix typos in the Nix Manual.Danny Bautista5-6/+6
(cherry picked from commit 00a567588e43b51944a9b91c1e890bda27773aed)
2019-09-04 Tweak release notesEelco Dolstra1-6/+5
2019-09-04 Set release dateEelco Dolstra1-1/+1
2019-08-29 Merge pull request #3048 from toonn/nix-env_docEelco Dolstra1-4/+7
Fix nix-env documentation for --delete-generations
2019-08-29 Reword to clarify newer generations are left alonetoonn1-1/+4
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-27 Merge branch 'master' of github.com:NixOS/nixEelco Dolstra1-8/+95
2019-08-27 Update release notesEelco Dolstra1-0/+5
2019-08-27 Merge pull request #3056 from grahamc/operatorsEelco Dolstra1-8/+95
operators: document exact precedence, split up similar operators
2019-08-27 Add 2.3 release notesEelco Dolstra1-2/+68
2019-08-27 docs: operators: Make OR and AND capitalizedGraham Christensen1-2/+2
2019-08-24 Merge pull request #2946 from vmandela/proxyGraham Christensen1-0/+18
installer: handle network proxy in systemd multi-user install
2019-08-24 docs: document the installer's use of proxy env varsGraham Christensen1-0/+18
2019-08-23 operators: document exact precedenc, split up similar operatorsGraham Christensen1-8/+95
2019-08-17 Fix nix-env documentation for --delete-generationsToon Nolten1-4/+4
The documentation for `--delete-generations` had an erroneous fullstop and as it turns out inaccurate information on the `+No.` syntax.
2019-08-15 Merge pull request #2945 from danidiaz/doc001Eelco Dolstra1-9/+31
Expanded documentation for .nix-defexpr
2019-08-15 Merge pull request #2782 from grahamc/flamesEelco Dolstra1-0/+28
Track function start and end
2019-08-15 Expanded documentation for .nix-defexprDaniel Diaz1-9/+31
2019-08-14 Track function start and ends for flame graphsGraham Christensen1-0/+28
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-08 conf: stalled-download-timeout: make tunableGraham Christensen1-0/+8
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-07 fixup: docs for post-build-hookGraham Christensen1-1/+1
2019-08-07 Merge pull request #2995 from tweag/post-build-hookEelco Dolstra3-0/+217
Add a post build hook
2019-08-06 post-build-hook: docs fixupGraham Christensen2-3/+7
2019-08-02 Add a post-build-hookregnat3-0/+213
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-02 Tweak min-free/max-free descriptionsEelco Dolstra1-5/+9
2019-07-19 docs: document balancing cores and max-jobsGraham Christensen3-2/+128
2019-07-06 Merge pull request #2882 from grahamc/docs/1115-tarball-ttlEelco Dolstra2-2/+27
tarball-ttl: document
2019-07-05 tarball-ttl: documentGraham Christensen2-2/+27
Incorporates text from Niklas Hambüchen in #2978 Closes #1115
2019-07-03 Merge branch 'autoconf-ubuntu-16.04-fixes' of https://github.com/nh2/nixEelco Dolstra1-1/+5
2019-07-03 autoconf: Fix C++17 detection not working on Ubuntu 16.04.Niklas Hambüchen1-1/+1
And probably many other distributions. Until now, ./configure would fail silently printing a warning ./configure: line 4621: AX_CXX_COMPILE_STDCXX_17: command not found and then continuing, later failing with a C++ #error saying that some C++11 feature isn't supported (it didn't even get to the C++17 features). This is because older distributions don't come with the `AX_CXX_COMPILE_STDCXX_17` m4 macro. This commit vendors that macro accordingly. Now ./configure complains correctly: configure: error: *** A compiler with support for C++17 language features is required. On Ubuntu 16.04, ./configure completes if a newer compiler is used, e.g. with gcc-7 from https://launchpad.net/~ubuntu-toolchain-r/+archive/ubuntu/test using: ./bootstrap.sh ./configure CXX=g++-7 --disable-doc-gen --with-boost=$(nix-build --no-link '<nixpkgs>' -A boost.dev)
2019-07-03 autoconf: Work around editline not being found on Ubuntu 16.04.Niklas Hambüchen1-0/+4
And probably other Linux distributions with long-term support releases. Also update manual stating what version is needed; I checked that 1.14 is the oldest version with which current nix compiles, and added autoconf feature checks for some functions added in that release that nix uses.
2019-07-02 Merge pull request #2779 from LnL7/build-exit-codesEelco Dolstra1-0/+42
build: add exit code for hash and check mismatches
2019-07-02 Merge pull request #2724 from LnL7/manpage-add-fixedEelco Dolstra1-0/+54
nix-store: document --add-fixed
2019-07-02 Merge pull request #2582 from LnL7/fetchgit-refsEelco Dolstra3-0/+38
fetchGit: allow fetching explicit refs
2019-07-02 nix-store: document --add-fixedDaiderd Jordan1-0/+54
2019-07-02 builtins.fetchGit: document absolute ref supportGraham Christensen3-0/+38