nix-super

mirror of https://github.com/privatevoid-net/nix-super.git synced 2024-11-16 03:06:17 +02:00

Author	SHA1	Message	Date
Valentin Gagarin	0ced5132fd	Merge pull request #6865 from zuzuleinen/manual-nix-path-empty document what happens when NIX_PATH is empty	2023-03-23 00:10:17 +01:00
Valentin Gagarin	96129246ad	add links	2023-03-22 23:37:27 +01:00
Valentin Gagarin	40eb88e427	doc: force line breaks where needed	2023-03-22 22:46:23 +01:00
Eelco Dolstra	5691bac202	Improve store setting descriptions / Markdown formatting	2023-03-22 14:23:36 +01:00
Eelco Dolstra	7704118d28	nix describe-stores: Remove This command was intended for docs generation, but it was never used for that and we don't need it.	2023-03-21 14:03:40 +01:00
Eelco Dolstra	4b9add9b35	Add links to API docs / coverage analysis to the hacking section	2023-03-21 11:47:21 +01:00
Eelco Dolstra	e53e5c38d4	Add a setting for configuring the SSL certificates file This provides a platform-independent way to configure the SSL certificates file in the Nix daemon. Previously we provided instructions for overriding the environment variable in launchd, but that obviously doesn't work with systemd. Now we can just tell users to add ssl-cert-file = /etc/ssl/my-certificate-bundle.crt to their nix.conf.	2023-03-17 18:32:18 +01:00
Yueh-Shun Li	c27d358abb	nix-hash: support base-64 and SRI format Add the --base64 and --sri flags for the Base64 and SRI format output. Add the --base16 flag to explicitly specify the hexadecimal format. Add the --to-base64 and --to-sri flag to convert a hash to the above mentioned format.	2023-03-16 03:08:42 +08:00
Valentin Gagarin	d37b8a29ce	Merge pull request #8036 from Freed-Wu/patch-1	2023-03-13 14:35:09 +01:00
Eelco Dolstra	6f22e8b7d8	Merge pull request #7486 from fricklerhandwerk/doc-reference reword definition of "reference"	2023-03-13 14:04:14 +01:00
wzy	5bf4ade0fa	Fix a typo of values.md	2023-03-13 15:34:01 +08:00
Valentin Gagarin	66f49864f3	Merge pull request #7928 from serokell/doc-includes Documentation: process `#include` directives	2023-03-10 17:06:42 +01:00
Valentin Gagarin	2af9fd20c6	clarify definition of "installable" 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-05 01:46:17 +01:00
Théophane Hufschmitt	1f394d2107	Merge branch 'master' into paths-from-stdin	2023-03-02 19:20:51 +01:00
Eelco Dolstra	96111ad902	Merge pull request #7901 from hercules-ci/disable-tests Add ./configure --disable-tests option	2023-03-02 10:00:15 +01:00
Alexander Bantyev	dd0aab2f94	Documentation: process #include directives	2023-03-01 14:01:45 +04:00
Alexander Bantyev	2fc3a15861	Make nix-env less prominent in manual TOC	2023-03-01 13:54:45 +04:00
John Ericson	ea0adfc582	Get rid of `.drv` special-casing for store path installables The release notes document the change in behavior, I don't include it here so there is no risk to it getting out of sync. > Motivation >> Plumbing CLI should be simple Store derivation installations are intended as "plumbing": very simple utilities for advanced users and scripts, and not what regular users interact with. (Similarly, regular Git users will use branch and tag names not explicit hashes for most things.) The plumbing CLI should prize simplicity over convenience; that is its raison d'etre. If the user provides a path, we should treat it the same way not caring what sort of path it is. >> Scripting This is especially important for the scripting use-case. when arbitrary paths are sent to e.g. `nix copy` and the script author wants consistent behavior regardless of what those store paths are. Otherwise the script author needs to be careful to filter out `.drv` ones, and then run `nix copy` again with those paths and `--derivation`. That is not good! >> Surprisingly low impact Only two lines in the tests need changing, showing that the impact of this is pretty light. Many command, like `nix log` will continue to work with just the derivation passed as before. This because we used to: - Special case the drv path and replace it with it's outputs (what this gets rid of). - Turn those output path back into the original drv path. Now we just skip that entire round trip! > Context Issue #7261 lays out a broader vision for getting rid of `--derivation`, and has this as one of its dependencies. But we can do this with or without that. `Installable::toDerivations` is changed to handle the case of a `DerivedPath::Opaque` ending in `.drv`, which is new: it simply doesn't need to do any extra work in that case. On this basis, commands like `nix {show-derivation,log} /nix/store/...-foo.drv` still work as before, as described above. When testing older daemons, the post-build-hook will be run against the old CLI, so we need the old version of the post-build-hook to support that use-case. Co-authored-by: Travis A. Everett <travis.a.everett@gmail.com> Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2023-02-28 17:07:05 -05:00
Timothy DeHerrera	639659dec2	doc/manual: add release note for `--stdin` flag	2023-02-28 12:31:05 -07:00
Timothy DeHerrera	df643051e2	nix-store: read paths from standard input Resolves #7437 for new `nix-store` by adding a `--stdin` flag.	2023-02-28 12:29:16 -07:00
Robert Hensing	d0d0b9a748	doc/cli-guideline: Improve examples Turns out that the settings themselves have a bad data model anyway, so we cut that. They do still occur in the first example, but not in focus.	2023-02-28 16:35:47 +01:00
Robert Hensing	17f70b10bf	doc/cli-guideline: Apply suggestions from code review Thanks Valentin!	2023-02-28 16:35:42 +01:00
Robert Hensing	f09ccd8ea9	doc/cli-guideline: Add JSON guideline	2023-02-28 16:35:36 +01:00
Eelco Dolstra	1e07102937	Release notes	2023-02-28 13:44:14 +01:00
Valentin Gagarin	1b49e6fea9	use the term reference correctly	2023-02-27 13:04:54 +01:00
Valentin Gagarin	b0c23999d2	add link to definition	2023-02-27 12:56:22 +01:00
Valentin Gagarin	ec317949f9	remove "references" as distinct term	2023-02-27 12:55:14 +01:00
Robert Hensing	e76619a402	rl-next: Describe fixed flake outPath semantics The reference documentation already implies the correct semantics.	2023-02-26 14:41:23 +01:00
Robert Hensing	c6051cac6f	doc: Add test dependencies to prerequisites	2023-02-24 09:59:25 +01:00
Robert Hensing	df6829e0d7	Merge pull request #7867 from NixOS/hacking-cross doc/hacking.md: Corrections and additions for cross	2023-02-20 22:25:55 +01:00
Robert Hensing	807ef8f734	doc/hacking.md: Corrections and additions for cross	2023-02-20 12:20:08 +01:00
John Ericson	d7a4f08d42	Nix's own flake: Dedup and memoize more - `nixpkgsFor` does all of native, static, cross, and the different stdenvs. - The main Nix derivation is no longer duplicated for static. - DRY nixpkgs.lib and lib.genAttrs calls.	2023-02-20 11:35:51 +01:00
Théophane Hufschmitt	9a3f66d9d9	Merge pull request #7433 from yorickvP/improv-onboarding Improve hacking.md and add clangd+bear to devshell	2023-02-20 10:50:08 +01:00
John Ericson	ddb40ddd47	Update doc/manual/src/quick-start.md Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2023-02-19 20:00:02 -05:00
Clemens Tolboom	8c09888de4	Use long options instead of short ones It is a little hard to learn what the options mean.	2023-02-19 13:48:37 -05:00
Yorick van Pelt	f2e427942d	Improve hacking.md - Refer to current version in readme - Split into flakes and non-flakes section - Change order to move nix-build to the end, since people often start with it in the beginning. - Use proper "Note" syntax - Add notes about editor integration - Move information about target platforms and stdenvs into separate sections Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io> Co-authored-by: Alexander Bantyev <alexander.bantyev@tweag.io> Co-authored-by: Théophane Hufschmitt <theophane.hufschmitt@tweag.io>	2023-02-13 12:00:00 +04:00
Théophane Hufschmitt	9ebbe35817	Merge pull request #5588 from tweag/balsoft/xdg Follow XDG Base Directory standard	2023-02-10 18:05:50 +01:00
Alexander Bantyev	2384d36083	A setting to follow XDG Base Directory standard XDG Base Directory is a standard for locations for storing various files. Nix has a few files which seem to fit in the standard, but currently use a custom location directly in the user's ~, polluting it: - ~/.nix-profile - ~/.nix-defexpr - ~/.nix-channels This commit adds a config option (use-xdg-base-directories) to follow the XDG spec and instead use the following locations: - $XDG_STATE_HOME/nix/profile - $XDG_STATE_HOME/nix/defexpr - $XDG_STATE_HOME/nix/channels If $XDG_STATE_HOME is not set, it is assumed to be ~/.local/state. Co-authored-by: Théophane Hufschmitt <7226587+thufschmitt@users.noreply.github.com> Co-authored-by: Tim Fenney <kodekata@gmail.com> Co-authored-by: pasqui23 <pasqui23@users.noreply.github.com> Co-authored-by: Artturin <Artturin@artturin.com> Co-authored-by: John Ericson <Ericson2314@Yahoo.com>	2023-02-10 20:14:06 +04:00
Pico Geyer	a0f1cb0ce7	Fix minor syntax issue in the one of the examples. Attribute set expressions need to end with a ;	2023-02-10 12:01:44 +02:00
Valentin Gagarin	c1921514d4	Merge pull request #7700 from iFreilicht/patch-1 docs: Fix small formatting errors	2023-02-07 23:37:42 +01:00
David Dunn	9aeaf98c4b	Make install command in documentation compatible with fish shell (#7474 ) Use a pipe for all install commands Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2023-02-07 22:32:27 +00:00
Felix Uhl	d910dfe978	docs: Fix formatting of \|\| operator This is a workaround for [mdBook#2000](https://github.com/rust-lang/mdBook/issues/2000)	2023-02-07 23:06:14 +01:00
Felix Uhl	32db5e6349	docs: Fix broken anchor link	2023-02-07 23:06:14 +01:00
Eelco Dolstra	1ba13b17db	Merge pull request #7758 from peterbecich/clang11-devshell-documentation fix documentation for `clang11Stdenv` dev shell	2023-02-07 22:35:31 +01:00
Valentin Gagarin	f370a5a26c	Update doc/manual/src/glossary.md Co-authored-by: John Ericson <git@JohnEricson.me>	2023-02-07 20:40:29 +01:00
Valentin Gagarin	8ab9fdac01	Merge pull request #7768 from ncfavier/fixup-7714	2023-02-07 16:24:19 +01:00
Valentin Gagarin	c20394245d	add "instantiate" to glossary	2023-02-07 12:09:26 +01:00
Valentin Gagarin	e4f12ff482	store paths are not uniquely determined	2023-02-07 11:59:18 +01:00
Naïm Favier	2915db7b28	doc: fixup 7714	2023-02-07 11:38:09 +01:00
Peter Becich	b8e96351f7	fix `clang11Stdenv` dev shell documentation `clang11StdenvPackages` does not exist ``` │ └───x86_64-linux │ ├───ccacheStdenv: development environment 'nix' │ ├───clang11Stdenv: development environment 'nix' │ ├───clangStdenv: development environment 'nix' │ ├───default: development environment 'nix' │ ├───gccStdenv: development environment 'nix' │ ├───libcxxStdenv: development environment 'nix' │ └───stdenv: development environment 'nix' ```	2023-02-05 12:00:48 -08:00
Eelco Dolstra	5cbeff64f2	Merge pull request #7607 from Hoverbear/installation-expand Expand installation.md	2023-02-02 17:05:54 +01:00
Eelco Dolstra	6f0436a337	Merge pull request #7719 from andersk/manual-timestamp manual: Document that the store timestamp is now 1, not 0	2023-02-01 15:50:36 +01:00
Anders Kaseorg	c5d4c50aba	manual: Document that the store timestamp is now 1, not 0 Commit `14bc3ce3d6` (0.13~43) changed the timestamps in the Nix store from 0 to 1. Update the nix-store man page to match. Signed-off-by: Anders Kaseorg <andersk@mit.edu>	2023-01-30 23:51:35 -08:00
Naïm Favier	0b3464a107	doc: add `__structuredAttrs`, `outputChecks`, `unsafeDiscardReferences`	2023-01-30 14:49:45 +01:00
Théophane Hufschmitt	7408776b00	Fix the release-notes Slightly butchered during the merge	2023-01-30 10:32:23 +01:00
Théophane Hufschmitt	4aaf0ee52e	Merge branch 'master' into referenceablePaths	2023-01-30 10:31:00 +01:00
John Ericson	f465e378c4	Update doc/manual/src/release-notes/rl-2.13.md Co-authored-by: Eelco Dolstra <edolstra@gmail.com>	2023-01-25 08:58:41 -05:00
John Ericson	816031173c	Fix the 2.13 changelog It is just the new CLI that gets the `^` syntax. The old CLI already has a (slightly different) `!` syntax. Fixes #7682	2023-01-24 18:53:46 -05:00
Felix Uhl	dc4aa383e9	doc: fix anchor links in and to glossary	2023-01-24 00:19:43 +01:00
Robert Hensing	9b56683398	Merge pull request #7447 from aakropotkin/read-file-type Read file type	2023-01-23 17:37:22 +01:00
John Ericson	7fe308c2f8	Add `rapidcheck` dependency for testing Property tests are great! Co-authored-by: Cole Helbling <cole.e.helbling@outlook.com>	2023-01-23 07:05:50 -05:00
Robert Hensing	37c533ed27	rl-next.md: Minor improvement	2023-01-23 11:28:31 +01:00
Théophane Hufschmitt	90e630a542	Merge pull request #7641 from layus/coerce-strings-fixups Coerce strings fixups	2023-01-23 09:39:00 +01:00
Alex Ameen	153ee460c5	primop: add readFileType, optimize readDir Allows checking directory entry type of a single file/directory. This was added to optimize the use of `builtins.readDir` on some filesystems and operating systems which cannot detect this information using POSIX's `readdir`. Previously `builtins.readDir` would eagerly use system calls to lookup these filetypes using other interfaces; this change makes these operations lazy in the attribute values for each file with application of `builtins.readFileType`.	2023-01-22 13:45:02 -06:00
Florian Paul Schmidt	4ff9ed5c2d	doc: fix update operator description	2023-01-20 13:21:45 +01:00
Théophane Hufschmitt	fdc02d2b6a	Merge pull request #7490 from fricklerhandwerk/doc-realise define the terms "realise" and "valid" for store paths	2023-01-20 11:19:45 +01:00
Valentin Gagarin	b911307d7a	Merge pull request #7629 from phip1611/patch-3	2023-01-19 16:41:20 +01:00
Philipp Schuster	9469b1bb30	doc: update language/index.md - make `<nixpkgs>` visible (was blank in the rendered version)	2023-01-19 15:11:20 +01:00
Guillaume Maudoux	e4726a0c79	Revert "Revert "Merge pull request #6204 from layus/coerce-string"" This reverts commit `9b33ef3879`.	2023-01-19 13:23:04 +01:00
Eelco Dolstra	38b90c618f	Merge pull request #7640 from marceltransier/patch-2 Fix update operator usage in operators.md	2023-01-19 11:12:10 +01:00
Marcel Transier	8b9325ec4a	Fix update operator usage in operators.md	2023-01-19 10:20:41 +01:00
Marcel Transier	9141b74eb7	Fix markdown error in operators.md Escape logical or pipe in markdown table according to https://github.github.com/gfm/#example-200	2023-01-18 22:34:49 +01:00
Lorenzo Manacorda	913782af4d	Relase notes: add empty flake registry Introduced in #5420	2023-01-18 17:34:19 +01:00
Philipp Schuster	70e193d64b	Update binary-cache-substituter.md (#7628 ) `binary-caches` is deprecated and `substituters` the new recommended option.	2023-01-18 15:08:20 +00:00
Robert Hensing	9b33ef3879	Revert "Merge pull request #6204 from layus/coerce-string" This reverts commit `a75b7ba30f`, reversing changes made to `9af16c5f74`.	2023-01-18 01:34:07 +01:00
Eelco Dolstra	3ff9fc0d7d	Typo	2023-01-17 17:03:30 +01:00
Eelco Dolstra	c1934eb074	Release notes	2023-01-17 13:23:31 +01:00
Valentin Gagarin	9be3c6c7c7	add note on self-references and cycles Co-authored-by: John Ericson <git@JohnEricson.me>	2023-01-17 12:33:23 +01:00
Valentin Gagarin	59f03437c2	references refer to store objects, not paths as noted by @Ericson2314	2023-01-17 12:29:45 +01:00
Valentin Gagarin	bc9de373c7	reword definition of "reference"	2023-01-17 12:29:45 +01:00
Ana Hobden	763c1dfc2b	Expand installation.md Changes the `quick-start.md` to recommend a multi-user install, since single-user is not supported on MacOS and https://nixos.org/download.html recommends multi-user. Expands `installation.md` to reflect wording on https://nixos.org/download.html	2023-01-16 11:38:50 -08:00
Robert Hensing	f58c301112	Merge pull request #7541 from hercules-ci/check-manual-links Check links in the manual	2023-01-10 23:07:38 +01:00
Robert Hensing	6ae4d762d0	doc/manual/src/contributing/hacking.md: Apply suggestion Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2023-01-10 22:30:41 +01:00
Robert Hensing	da4d4feacf	doc/manual/hacking: Document @docroot@ variable	2023-01-10 22:30:41 +01:00
Robert Hensing	fefa3a49ce	doc/manual: Apply suggestions from code review Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2023-01-10 22:30:41 +01:00
Robert Hensing	d5c8289f1e	doc/manual: Document hacking on the manual links	2023-01-10 22:30:41 +01:00
Robert Hensing	e79f935718	doc/manual: Fix broken internal links The targets I could find.	2023-01-10 22:30:41 +01:00
Jeremy Fleischman	89ef26664d	Add a pointer from "realising" to `nix log`. (#4876 )	2023-01-09 09:49:46 +01:00
Eelco Dolstra	3172c51baf	Merge pull request #7498 from fricklerhandwerk/path+string refactor documentation of operators, document `+` for strings and paths	2023-01-06 13:46:31 +01:00
Eelco Dolstra	d02c5a41da	Merge pull request #7500 from akhildevelops/patch-1 Updated docs to delete build users and group	2023-01-05 17:25:06 +01:00
Valentin Gagarin	e57165b85a	bring back table, extract annotations this makes the table less unwieldy, and leaves enough space for extensive explanations.	2023-01-05 15:16:16 +01:00
Valentin Gagarin	7da59e94ae	add links to documentation for data types	2023-01-05 14:15:01 +01:00
Valentin Gagarin	7b2b9e3648	use more self-explanatory placeholder names	2023-01-05 14:15:01 +01:00
Valentin Gagarin	969e5ad5bf	add semantics of overloaded `+` operator	2023-01-05 14:15:01 +01:00
Valentin Gagarin	63b640e0c2	reword descriptions of operators add notes on semantics where appropriate	2023-01-05 14:15:01 +01:00
Valentin Gagarin	e07448ba6b	convert table to subsections 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-05 14:15:01 +01:00
Valentin Gagarin	caebe4112e	reorder columns this is for a simpler transformation into a series of subsections	2023-01-05 14:15:01 +01:00
Naïm Favier	3c968191f1	move `unsafeDiscardReferences` out of `outputChecks` It's not a check.	2023-01-03 18:53:01 +01:00
Naïm Favier	15f7fa59be	`unsafeDiscardReferences` Adds a new boolean structured attribute `outputChecks.<output>.unsafeDiscardReferences` which disables scanning an output for runtime references. __structuredAttrs = true; outputChecks.out.unsafeDiscardReferences = true; This is useful when creating filesystem images containing their own embedded Nix store: they are self-contained blobs of data with no runtime dependencies. Setting this attribute requires the experimental feature `discard-references` to be enabled.	2023-01-03 17:19:16 +01:00
Valentin Gagarin	9cb1610257	define the terms "realise" and "valid" for store paths add links to the glossary definition where the terms are used	2023-01-03 13:53:53 +01:00
Eelco Dolstra	6b69652385	Merge remote-tracking branch 'origin/master' into coerce-string	2023-01-02 20:53:39 +01:00
Théophane Hufschmitt	34a31b33f1	Merge pull request #7278 from fricklerhandwerk/antiquotation antiquotation -> string interpolation	2023-01-02 15:03:45 +01:00
Théophane Hufschmitt	a654ae8269	Merge pull request #7066 from fricklerhandwerk/architecture-overview manual: architecture overview	2023-01-02 14:42:01 +01:00
Valentin Gagarin	e0c4a95611	antiquotation -> string interpolation 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>	2023-01-02 14:38:57 +01:00
Eelco Dolstra	80a0f77e49	Merge pull request #7470 from obsidiansystems/simplify-tests-slightly Make `./mk/run-test.sh` work by itself; add `mk/debug-test.sh`	2023-01-02 14:14:30 +01:00
Théophane Hufschmitt	cfd6c7fc9b	Merge pull request #7485 from fricklerhandwerk/doc-store-derivation define "store derivation"	2023-01-02 13:26:41 +01:00
John Ericson	efbd1d15c6	Apply suggestions from code review Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-12-23 08:59:36 -08:00
Eelco Dolstra	c164d304f3	nix develop: Set personality This makes 'nix develop' set the Linux personality in the same way that the actual build does, allowing a command like 'nix develop nix#devShells.i686-linux.default' on x86_64-linux to work correctly.	2022-12-23 16:33:55 +01:00
Akhil	a3a0e414c2	Deletes build users and group	2022-12-23 14:06:51 +05:30
Valentin Gagarin	7797661a70	link "store derivation" to glossary definition	2022-12-21 11:42:50 +01:00
Valentin Gagarin	3a66d82e1d	update description of "store derivation" in installables section a store derivation is not a store path itself, it has a store path.	2022-12-21 11:42:22 +01:00
Valentin Gagarin	62f4f883a7	define "store derivation"	2022-12-21 11:42:22 +01:00
John Ericson	0251d44cc2	Make `./mk/run-test.sh` work by itself; add `mk/debug-test.sh` First, logic is consolidated in the shell script instead of being spread between them and makefiles. That makes understanding what is going on a little easier. This would not be super interesting by itself, but it gives us a way to debug tests more easily. That in turn I hope is much more compelling. See the updated manual for details. Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io> Co-authored-by: Eelco Dolstra <edolstra@gmail.com> Co-authored-by: Robert Hensing <roberth@users.noreply.github.com>	2022-12-21 02:28:33 -05:00
Valentin Gagarin	7e31a991db	make relative links explicit	2022-12-20 14:28:43 +01:00
Valentin Gagarin	c162c90b43	add more explanation to diagrams this is to help reading the diagrams, otherwise arrows and labels were reported as being ambiguous.	2022-12-20 09:59:59 +01:00
Eelco Dolstra	9fa8b02c41	Merge pull request #7456 from ncfavier/fix-links doc: fix links	2022-12-13 17:27:13 +01:00
Naïm Favier	129ece7ce9	doc: fix links	2022-12-13 15:49:40 +01:00
John Ericson	5273cf4c97	Merge remote-tracking branch 'upstream/master' into indexed-store-path-outputs	2022-12-12 17:40:49 -05:00
John Ericson	dabb03b8d0	Merge remote-tracking branch 'upstream/master' into indexed-store-path-outputs	2022-12-12 17:36:02 -05:00
John Ericson	c7cce3e4e1	Improve release notes	2022-12-12 16:29:49 -05:00
Valentin Gagarin	4ed8bb1cb1	suggestions from review	2022-12-12 14:29:24 +01:00
Eelco Dolstra	fa409131cd	Add links to the manual Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-12-12 14:05:54 +01:00
Eelco Dolstra	fd0ed75118	Support flake references in the old CLI Fixes #7026.	2022-12-12 14:05:52 +01:00
Eelco Dolstra	7396844676	Merge pull request #7421 from edolstra/lazy-trees-trivial-changes Trivial changes from the lazy-trees branch	2022-12-12 13:52:56 +01:00
John Ericson	1879c7c95e	Merge branch 'master' into indexed-store-path-outputs	2022-12-12 07:33:36 -05:00
Eelco Dolstra	c66c904a05	Tweak NIX_PATH description	2022-12-12 12:54:15 +01:00
Eelco Dolstra	add417ec14	Fix indentation	2022-12-12 12:46:54 +01:00
Eelco Dolstra	037d5c4299	Manual improvements Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-12-12 12:43:44 +01:00
Théophane Hufschmitt	830b3bddf9	Merge pull request #7324 from CircuitCoder/master Update uninstall guide involving systemd	2022-12-09 13:57:26 +01:00
Théophane Hufschmitt	1dd7779c7c	Merge pull request #7379 from fricklerhandwerk/refactor-generate-options refactor rendering documentation of options	2022-12-08 06:39:13 +01:00
Valentin Gagarin	b8a1ff98c1	use HTML anchors for config parameters this avoids incorrect rendering on the man pages, since `lowdown` neither parses the anchor syntax nor HTML. this should rather be fixed in lowdown, as adding more anchors would otherwise produce ever more noise and error-prone repetition.	2022-12-07 16:18:50 +01:00
Eelco Dolstra	b5b7902a08	Merge branch 'master' into remove-repeat	2022-12-07 16:04:47 +01:00
Eelco Dolstra	703d863a48	Trivial changes from the lazy-trees branch	2022-12-07 14:06:34 +01:00
endgame	c710aa1abd	Post build hook signing (#7408 ) * docs: Use secret-key-files when demonstrating post-build-hooks The docs used to recommend calling `nix store sign` in a post-build hook, but on more recent versions of nix, this results in unsigned store paths being copied into binary caches. See https://github.com/NixOS/nix/issues/6960 for details. Instead, use the `secret-key-files` config option, which signs all locally-built derivations with the private key. Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-12-07 13:55:02 +01:00
Linus Heckemann	8e0946e8df	Remove repeat and enforce-determinism options These only functioned if a very narrow combination of conditions held: - The result path does not yet exist (--check did not result in repeated builds), AND - The result path is not available from any configured substituters, AND - No remote builders that can build the path are available. If any of these do not hold, a derivation would be built 0 or 1 times regardless of the repeat option. Thus, remove it to avoid confusion.	2022-12-07 11:36:48 +01:00
Eelco Dolstra	5b4b2eefa1	Release notes	2022-12-06 13:55:09 +01:00
Valentin Gagarin	0ea62670ed	move documentation on `auto-allocate-uids` to options docs this is where it belongs and can be found together with the other options.	2022-12-01 04:40:02 +01:00
Eelco Dolstra	7dd3e1fec4	Add example	2022-11-28 22:04:51 +01:00
Eelco Dolstra	67bcb99700	Add a setting for enabling cgroups	2022-11-28 21:54:02 +01:00
Liu Xiaoyi	c4ce89f772	Clarify uninstallation steps on Linux Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-11-26 22:01:51 +08:00
John Ericson	26534f141c	Merge branch 'master' into indexed-store-path-outputs	2022-11-25 08:14:32 -05:00
Eelco Dolstra	2aa3f2e810	Include UID in hex	2022-11-23 17:07:59 +01:00
Eelco Dolstra	989fc8a8b9	Add release notes	2022-11-23 15:24:50 +01:00
Valentin Gagarin	52f0c80917	fix error in language overview it is not possible to antiquote numbers.	2022-11-22 10:36:21 +01:00
Liu Xiaoyi	4d55acf515	Apply suggestions from code review Co-authored-by: Sandro <sandro.jaeckel@gmail.com>	2022-11-21 13:46:22 +08:00
Liu Xiaoyi	cc620d961f	Updated uninstall guide involving systemd Co-authored-by: sequencer <liu@jiuyang.me>	2022-11-20 20:04:29 +08:00
Théophane Hufschmitt	6bf8736517	Add release-notes for the context-restriction in readFile	2022-11-14 15:03:53 +01:00
Théophane Hufschmitt	302ddee749	Merge pull request #7279 from fricklerhandwerk/uninstall add removing users to uninstall instructions	2022-11-11 14:39:07 +01:00
Valentin Gagarin	2af036e5a3	remove stray comma	2022-11-11 14:01:13 +01:00
Valentin Gagarin	9d20a056c8	remove external link the language has its own overview page where its properties are described in sufficient detail.	2022-11-09 01:36:17 +01:00
Valentin Gagarin	3d716df7ce	make diagrams compatible with svgbob this will at some point enable rendering them nicely for the web	2022-11-09 01:29:01 +01:00
Valentin Gagarin	98447c1a7f	clarify subject of sentence Co-authored-by: Bryan Honof <bryan.honof@tweag.io>	2022-11-09 01:29:01 +01:00
Valentin Gagarin	b5728ace5d	add articles	2022-11-09 01:29:01 +01:00
Valentin Gagarin	be8744f937	manual: architecture overview these changes were not merged properly and had to be reverted. see merge commit `d8e54d19f7` for full history leading up to here.	2022-11-09 01:29:01 +01:00
Valentin Gagarin	d8781c4fc5	add removing users to uninstall instructions	2022-11-09 01:11:47 +01:00
Valentin Gagarin	ffca3e34cb	Merge pull request #6906 from fricklerhandwerk/language-overview add syntax overview from NixOS manual	2022-11-09 00:52:53 +01:00
Valentin Gagarin	f7ab93b068	manual: build action -> build task 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-11-06 13:28:18 +01:00
John Ericson	13f2a6f38d	Merge branch 'master' into indexed-store-path-outputs	2022-10-28 23:22:18 +01:00
Guillaume Maudoux	2a7348f986	Fixup merge typo	2022-10-22 23:38:50 +02:00
Johan Herland	1ec8810687	Explain how Nix handles antiquotation of paths 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-10-19 11:50:58 +02:00
Guillaume Maudoux	3f9f6ae127	Merge remote-tracking branch 'origin/master' into coerce-string	2022-10-16 20:39:19 +02:00
Valentin Gagarin	ac0fb38e8a	Merge pull request #6652 from abathur/doc_install_tests	2022-10-05 17:45:42 +02:00
Travis A. Everett	e1418430ac	Apply suggestions from code review Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-10-05 09:52:53 -05:00
Valentin Gagarin	927234cfb2	Merge pull request #6870 from amjoseph-nixpkgs/pr/doc/explain-local-remote-binary-substituter	2022-10-05 09:01:42 +02:00
Solene Rapenne	847cd49909	nix-copy-closure: improve wording	2022-09-28 01:05:46 +02:00
Théophane Hufschmitt	6a64820cb4	Merge pull request #7082 from rapenne-s/ccache add ccacheStdenv	2022-09-24 12:45:27 +02:00
Solène Rapenne	e04b38f789	add ccacheStdenv when using ccache, rebuild time has been measured 89% faster while not slowing the speed of cold builds	2022-09-23 11:21:19 +02:00
Travis A. Everett	84bdb0e3ad	address review feedback Mainly: - Try to triangulate between narrative that framed this as a new/easy process and the need for a reference that will not quickly grow stale. - Fix a ~continuity issue where the text was talking about "your Cachix cache" before saying that you'd need to make a Cachix cache to enable the installer tests. - Adopt suggestion on titling, and nest subtitles in the installer test section.	2022-09-18 13:02:42 -05:00
Travis A. Everett	4bd52bf6c4	Apply suggestions from code review Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-09-17 13:20:11 -05:00
Adam Joseph	ad5b09423a	release-notes/rl-next.md: note new argument to fetchurl.nix	2022-09-16 01:59:24 -07:00
Valentin Gagarin	dc8c0b173c	Update doc/manual/src/contributing/hacking.md	2022-09-16 09:36:55 +02:00
Valentin Gagarin	1ae974120a	Update doc/manual/src/contributing/hacking.md	2022-09-16 09:36:37 +02:00
Valentin Gagarin	0a4bd9fe88	Update doc/manual/src/contributing/hacking.md	2022-09-16 09:36:30 +02:00
Valentin Gagarin	47fa1087c8	Update doc/manual/src/contributing/hacking.md	2022-09-16 09:36:20 +02:00
Valentin Gagarin	1d295e5fe7	Merge pull request #6934 from fricklerhandwerk/revert-architecture Revert #6420 "Document what Nix is" so we can start over with smaller change sets	2022-09-09 13:31:05 +02:00
Guillaume Maudoux	eb460a9529	WIP: broken merge but need a git checkpoint	2022-09-07 00:34:03 +02:00
Adam Joseph	e90f2fcfc7	glossary: add entry for `chroot store` (used 11 times in nix)	2022-09-01 18:28:05 -07:00
Adam Joseph	e6f5352e71	#binary-cache -> #gloss-binary-cache	2022-09-01 18:27:00 -07:00
Adam Joseph	59dc8346ca	move substituter signature-checking conditions to configuration file documentation	2022-09-01 17:51:56 -07:00
Adam Joseph	f6c750e8b2	glossary: remove extraneous comma	2022-09-01 17:48:34 -07:00
Adam Joseph	887e922be2	glossary: outputHash, not __outputHash	2022-09-01 17:47:13 -07:00
Adam Joseph	d5e064d816	glossary: fix broken link	2022-09-01 17:46:31 -07:00
Adam Joseph	57f12df5e4	input-addressed store object: include FODOs	2022-09-01 15:09:10 -07:00
Adam Joseph	8139bbe2ba	implement https://github.com/NixOS/nix/pull/6870#pullrequestreview-1093700220	2022-09-01 15:01:07 -07:00
Adam Joseph	def4fb9a0f	__outputHash: add link	2022-09-01 14:47:33 -07:00
Adam Joseph	1b2b8c39fd	fix link to language/advanced-attributes.md#adv-attr-contentAddressed	2022-09-01 14:47:17 -07:00
Adam Joseph	0a98d564b3	glossary: resolve FIXME in #gloss-fixed-output-derivation	2022-09-01 14:41:27 -07:00
Adam Joseph	1f56b5d772	doc/manual: un-inline definitions from `substitute`	2022-09-01 14:13:21 -07:00
Adam Joseph	41153f30bd	glossary: substituter: merge output-addressed cases	2022-09-01 14:13:21 -07:00
Adam Joseph	9cb8412143	Update doc/manual/src/glossary.md Co-authored-by: John Ericson <git@JohnEricson.me>	2022-09-01 20:41:04 +00:00
Adam Joseph	2812682ebe	Update doc/manual/src/glossary.md Co-authored-by: John Ericson <git@JohnEricson.me>	2022-09-01 20:40:39 +00:00
Adam Joseph	520587b9a0	glossary: local store: clarify	2022-09-01 13:39:48 -07:00
Valentin Gagarin	f35b3aa47b	do not use unwarranted pkgs in example	2022-08-31 09:16:37 +02:00
Eelco Dolstra	b0488a29dc	Branch 2.11 release notes	2022-08-24 22:44:58 +02:00
Eelco Dolstra	04e74f7c8b	Merge pull request #6612 from NixOS/parallel-nix-copy Make nix copy parallel again	2022-08-24 15:31:42 +02:00
Eelco Dolstra	4c96761c2b	Merge remote-tracking branch 'origin/master' into parallel-nix-copy	2022-08-22 15:29:10 +02:00
Valentin Gagarin	d8e54d19f7	Revert "Merge pull request #6420 from nix-community/doc-what-is-nix" This reverts commit `81e101345f`, reversing changes made to `7d1280bbaf`.	2022-08-22 12:52:15 +02:00
Andrei Boar	50f5b6c733	Update doc/manual/src/command-ref/env-common.md Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-08-19 12:28:51 +03:00
Andrei Boar	82b867d0b5	cover empty string case	2022-08-19 11:51:32 +03:00
Valentin Gagarin	703b335c1d	reword description of language properties 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-15 11:34:39 +02:00
Valentin Gagarin	71e9c28694	reword introduction to overview	2022-08-15 11:15:03 +02:00
Valentin Gagarin	bc315326fa	fix whitespace to please markdown keep some indentation to ease source readability	2022-08-15 11:13:05 +02:00
Valentin Gagarin	6ba8d6dc82	add more examples on string interpolation	2022-08-15 11:06:40 +02:00
Valentin Gagarin	c209e6e108	add more list examples	2022-08-15 10:18:56 +02:00
Valentin Gagarin	0378531bf2	add curried function	2022-08-15 10:18:56 +02:00
Valentin Gagarin	2e4704ca93	add second @ pattern example	2022-08-15 10:18:56 +02:00
Valentin Gagarin	5c25bdee50	add null	2022-08-15 10:18:56 +02:00
Valentin Gagarin	391fd10b12	add home path	2022-08-15 10:18:56 +02:00
Valentin Gagarin	587ae9ada5	add search path	2022-08-15 10:18:56 +02:00
Valentin Gagarin	21438acc70	add absolute path	2022-08-15 10:18:56 +02:00
Valentin Gagarin	e6f7c180de	add floating point number	2022-08-15 10:18:56 +02:00
Valentin Gagarin	292cab039d	add multi-line string	2022-08-15 10:18:56 +02:00
Valentin Gagarin	f165a8ae08	flarify relative path semantics	2022-08-15 10:18:56 +02:00
Valentin Gagarin	43188d3d18	make hash and version distinguishable as placeholder	2022-08-15 10:18:56 +02:00
Valentin Gagarin	90836397d3	remove stale section link	2022-08-15 10:18:56 +02:00
Valentin Gagarin	3378a3bce8	add syntax overview from NixOS manual taken verbatim to keep track of required corrections. made it an HTML table to more easily change structure and keep diffs minimal.	2022-08-15 10:18:56 +02:00
Eelco Dolstra	af4e8b00fb	Merge pull request #6882 from DeterminateSystems/allow-multi-user-as-root Allow installing multi-user as root on macOS and Linux	2022-08-12 10:19:03 +02:00
Graham Christensen	7bb1e913b3	Don't prompt about using sudo if we're already root	2022-08-10 09:37:08 -04:00
Graham Christensen	88a0f3b6ba	Strip whitespace in installing-binary.md	2022-08-10 09:37:08 -04:00
Adam Joseph	bac1e1bf8c	Update doc/manual/src/glossary.md Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-08-08 17:52:31 +00:00
Travis A. Everett	9b7bd2dd1f	Apply suggestions from code review Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-08-08 10:04:27 -05:00
Travis A. Everett	b5d85f0922	Apply suggestions from code review Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-08-05 13:49:18 -05:00
Adam Joseph	1d3b92e80c	move package-management/terminology into glossary.md	2022-08-05 10:39:43 -07:00
Adam Joseph	4de95f7f56	gesture at explanation of why binary caches exist	2022-08-05 10:33:48 -07:00
Adam Joseph	d5506aa712	Update doc/manual/src/package-management/terminology.md Co-authored-by: Attila Gulyas <toraritte@gmail.com>	2022-08-05 17:19:52 +00:00
Adam Joseph	66a93a76b9	Update doc/manual/src/package-management/terminology.md Co-authored-by: Attila Gulyas <toraritte@gmail.com>	2022-08-05 17:15:37 +00:00
Adam Joseph	2eb74c918d	derivations do not need to be signed	2022-08-05 10:13:41 -07:00
Adam Joseph	aae771cad2	!implement https://github.com/NixOS/nix/pull/6870#discussion_r938912244	2022-08-05 10:12:46 -07:00
Eelco Dolstra	4eb566603a	Comment out the architecture section This needs more review and probably should be a separate book.	2022-08-05 11:01:40 +02:00
Adam Joseph	1b97f3872e	!fixup: transposed characters	2022-08-04 14:22:14 -07:00
Adam Joseph	62674659ed	!fixup capitalize Nix	2022-08-04 14:21:17 -07:00
Adam Joseph	8f44d24c52	!fixup whitespace	2022-08-04 14:19:25 -07:00
Adam Joseph	56d4fc194b	fourth trust condition: FODs	2022-08-04 14:14:24 -07:00
Adam Joseph	a5be5e0120	doc/manual: define {local,remote} store, binary cache, substituter Nix veterans intuitively know what the following terms mean. They are used in several places in the nix documentation, but never defined: - local store - remote store - binary cache - substituter In particular, I found the last two terms to be confusingly similar. Let's give definitions for them.	2022-08-04 14:07:06 -07:00
John Ericson	39d32ac4c6	Add disclaimer that arch section is WIP and links may rot So we can iterate without worrying so much.	2022-08-04 14:02:58 -04:00
John Ericson	6f6498f59c	Remove header fragments which is not needd	2022-08-04 14:02:38 -04:00
John Ericson	016d7a8f78	Fix rosetta stone file name	2022-08-04 14:02:19 -04:00
John Ericson	b430a6743c	Remove sections within from SUMMARY	2022-08-04 14:01:55 -04:00
Andrei Boar	1c2c1a6e00	Update doc/manual/src/command-ref/env-common.md Co-authored-by: Jan Tojnar <jtojnar@gmail.com>	2022-08-04 16:17:24 +03:00
John Ericson	bc118854d0	Merge remote-tracking branch 'upstream/master' into doc-what-is-nix	2022-08-04 09:11:42 -04:00
Andrei Boar	a8ac6a4120	Update doc/manual/src/command-ref/env-common.md Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-08-04 16:01:02 +03:00
Andrei Boar	cedcfe861c	Merge branch 'manual-nix-path-empty' of github.com:zuzuleinen/nix into manual-nix-path-empty	2022-08-04 15:56:13 +03:00
Andrei Boar	f72545e864	update to suggested changes	2022-08-04 15:56:01 +03:00
Valentin Gagarin	b631742277	fix page rendering apparently it is not possible to link to page anchors with `mdBook`[1] [1]: https://github.com/rust-lang/mdBook/issues/167	2022-08-04 14:31:33 +02:00
Domen Kožar	7d1280bbaf	Merge pull request #6678 from abathur/update_darwin_uninstall doc: update darwin uninstall instructions	2022-08-04 14:09:09 +02:00
Andrei Boar	6dfd8a78d9	Update doc/manual/src/command-ref/env-common.md Co-authored-by: Eelco Dolstra <edolstra@gmail.com>	2022-08-04 15:04:52 +03:00
Valentin Gagarin	cc3a5f4ba2	use correct mdBook syntax for callouts	2022-08-04 14:04:14 +02:00
Valentin Gagarin	8cec32e7f5	fix directory tree renderings	2022-08-04 13:51:35 +02:00
Domen Kožar	84a26882f8	Update doc/manual/src/installation/installing-binary.md Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-08-04 06:23:45 -05:00
Domen Kožar	3c2de2da01	Update doc/manual/src/installation/installing-binary.md Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-08-04 06:23:36 -05:00
Andrei Boar	5a75aa8595	manual: update docs when NIX_PATH is empty	2022-08-04 14:19:51 +03:00
Valentin Gagarin	3df1ee2ba5	clarify what explicitly declaring certain dependencies means	2022-08-04 12:37:48 +02:00
Valentin Gagarin	b7309ce624	move architecture to the end	2022-08-04 12:37:48 +02:00
Valentin Gagarin	00a7eaed67	add file system object to table of contents	2022-08-04 12:37:48 +02:00
Valentin Gagarin	db6faf44a9	clarify what store objects can be the store of course makes a distinction, but that is not relevant here	2022-08-04 12:37:48 +02:00
Valentin Gagarin	0228eb8ae7	add Java example on manual dependency declaration	2022-08-04 12:37:48 +02:00
Valentin Gagarin	29c062537d	hashes: truncate -> reduce, mention SHA-256 the longer SHA-256 hashes are not truncated, but in fact processed. Co-authored-by: Thomas <twatson52@mac.com>	2022-08-04 12:37:48 +02:00
Valentin Gagarin	9cabba1fc3	mention hard links Co-authored-by: Thomas <twatson52@mac.com>	2022-08-04 12:37:48 +02:00
Valentin Gagarin	bac86231ad	use "build plan" consistently	2022-08-04 12:37:47 +02:00
Valentin Gagarin	5a5a95696f	note customized base32 Nix omits E O U T characters for some reason.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	de5dea45f7	use correct Nix entity Nix itself does care a lot about what type of store object you have.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	fe4c0b8d75	fix typo Co-authored-by: Thomas <twatson52@mac.com>	2022-08-04 12:37:47 +02:00
Valentin Gagarin	def80d5777	add subsections to table of contents	2022-08-04 12:37:47 +02:00
Valentin Gagarin	c345345dee	concept map: align hights this has the weird but nice emergent property that terms at the same height are roughly at the same level of abstraction.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	a28d6878b2	concept map: put closure as it is in the chapter this is not as compact any more, but it more closely resembles the chapter structure, and clearly shows that the closure property is the key idea on which most of Nix operates.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	475a332025	make concept map even more compact	2022-08-04 12:37:47 +02:00
Valentin Gagarin	d8b2f9f772	make concept map more compact invert arrows to/from derivation: - we need closures to form derivations - we need derivations to perform builds	2022-08-04 12:37:47 +02:00
Valentin Gagarin	348432f48f	store: add concept map this should help nativate the chapter by indicating which terms should be known to understand a given concept.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	ec43977553	store: match chapter introduction to outline the various levels of detail should describe the same things.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	7c656d90ca	simplify description of diagram try not to be too fancy, it's just for reading the diagram out loud.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	631ca18ee6	reword notes on copying clarify that we are copying between different stores. we have not introduced that notion or why it would be interesting, but for now it should be fine to keep it in context of the store directory. we could move that later to a more detailed explanation of different store types.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	c10dcccccd	make example a simple list using JSON notation is unwarranted and not explained.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	9c544813d7	paths -> path use singular for terminology uniformly	2022-08-04 12:37:47 +02:00
Valentin Gagarin	1681f4e9f3	better explain reference scanning	2022-08-04 12:37:47 +02:00
Valentin Gagarin	fa7ad4593d	explain store directory	2022-08-04 12:37:47 +02:00
Valentin Gagarin	f632816cba	add explanation and examples of file system objects	2022-08-04 12:37:47 +02:00
Valentin Gagarin	84ddfbf8fd	remove diagonal from operations diagram	2022-08-04 12:37:47 +02:00
Valentin Gagarin	93f721b0d2	remove draft on derivations	2022-08-04 12:37:47 +02:00
Valentin Gagarin	19d8a5d839	move first mention of file system object before diagram	2022-08-04 12:37:47 +02:00
Valentin Gagarin	a90fc62b61	make clear that file system is for processes Co-authored-by: John Ericson <John.Ericson@Obsidian.Systems>	2022-08-04 12:37:47 +02:00
Valentin Gagarin	7993ba1f38	constrain garbage collection scope garbage collection is now incremental, and may (in theory) never delete all unreferenced objects if it is slow enough.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	195aa28ff7	references are added according to build task at this level of abstraction we do not really care about build instructions or what they are, and also build instructions including their arguments really amount to the build task.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	80de4a4804	operations diagram: store' to the right this also looks more diverse, hopefully easier to distinguish Co-authored-by: John Ericson <John.Ericson@Obsidian.Systems>	2022-08-04 12:37:47 +02:00
Valentin Gagarin	3794618cce	add commas between output values	2022-08-04 12:37:47 +02:00
Valentin Gagarin	7b7e4c6340	use singular to match section heading	2022-08-04 12:37:47 +02:00
Valentin Gagarin	e63a768e21	use reference links for URLs	2022-08-04 12:37:47 +02:00
Valentin Gagarin	843288a451	add subsections for objects and references group description of data instead of spreading it across the section. that should help direct skimming. as it turns out, people do not actually read any of that.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	4341849193	move closure property to discussion references	2022-08-04 12:37:47 +02:00
Valentin Gagarin	445f753a82	replace pseudo code by diagrams change prose description to visually resemble the data structure	2022-08-04 12:37:47 +02:00
Valentin Gagarin	db8703bcac	use reference links for URLs	2022-08-04 12:37:47 +02:00
Valentin Gagarin	4adb6602bd	clarify first sentence on store objects	2022-08-04 12:37:47 +02:00
Valentin Gagarin	4eb11d4592	fix grammar for clarity	2022-08-04 12:37:47 +02:00
Valentin Gagarin	b84f2bdfdd	introduce mapping to Unix files and processes	2022-08-04 12:37:47 +02:00
Valentin Gagarin	207992a71d	introduce store and store objects without file system details this leaves open implementation details, especially about store paths and file system objects, and allows explaining them together were it is more appropriate. also leaves room to carefully introduce the key insight behind Nix: applying results from programming language theory to the operating system paradigm of files and processes.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	e72a7874dc	beautify rosetta table while this may eventually introduce ugly diffs, the table will now render readably on the terminal (e.g. for `man nix` or `nix --help`) without further intervention.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	b6b112b366	use reference links for URLs	2022-08-04 12:37:47 +02:00
Valentin Gagarin	d5eea66615	introduce build tasks while it appears a bit much for the overview, this way we set the stage for going directly into data types when describing the store, instead of first having to say what build tasks are and how they relate to build plans.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	7c3bca1372	revert to build plans in top-level overview do not introduce build tasks yet, that is the next level of detail.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	4639b36b53	use reference links for URLs	2022-08-04 12:37:47 +02:00
Valentin Gagarin	2303f84a68	revert to "build plan" in overview diagram this displays correct composition again. build inputs and build results are not part of build plans in terms of data objects. also this is a much less complicated setup. this will be the first impression of architecture, and we want to get it right.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	25926c5fc6	Nix store does not underly literally everything Co-authored-by: Robert Hensing <roberth@users.noreply.github.com>	2022-08-04 12:37:47 +02:00
Valentin Gagarin	0e63b9bf88	add link from overview to store section the overview should only link to the three main concepts presented. the store is now fairly fleshed out. others can follow later.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	ef81276cc1	architecture overview: add link to command line reference	2022-08-04 12:37:47 +02:00
Valentin Gagarin	68d26010f6	architecture overview: add link to Nix expression language reference update summary title to match file contents	2022-08-04 12:37:47 +02:00
Valentin Gagarin	75ce324052	use singular for class names consistently	2022-08-04 12:37:47 +02:00
Valentin Gagarin	689b32a543	clarify relation of tasks and plans	2022-08-04 12:37:47 +02:00
Valentin Gagarin	2a8532fb61	build rule -> build task closer to "build systems a la carte", satisfies all other complaints	2022-08-04 12:37:47 +02:00
Valentin Gagarin	902638c519	build step -> build rule "step" sounds atomic, while "rule" hints at internal structure, which in our case consists of mapping inputs to outputs using build instructions.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	87523f01e3	match grammatical case to arrow direction	2022-08-04 12:37:47 +02:00
Valentin Gagarin	d3effd014b	update architecture diagram	2022-08-04 12:37:47 +02:00
Valentin Gagarin	ad8c2ed7f0	remove incomplete section: input/content-addressing	2022-08-04 12:37:47 +02:00
Valentin Gagarin	3bd125ebbe	remove incomplete section: nix archives	2022-08-04 12:37:47 +02:00
Valentin Gagarin	b18852eb3f	remove incomplete section: content-addressed objects	2022-08-04 12:37:47 +02:00
Valentin Gagarin	7cec9ee361	remove incomplete section: relocatability	2022-08-04 12:37:47 +02:00
Valentin Gagarin	96876b1eae	remove incomplete section: related work	2022-08-04 12:37:47 +02:00
Valentin Gagarin	1ba6d8fb1d	remove incomplete section: building	2022-08-04 12:37:47 +02:00
John Ericson	3d8f2f5cc1	Fix manual TOC links	2022-08-04 12:37:47 +02:00
John Ericson	b01bb65d30	Fix rel path in doc	2022-08-04 12:37:47 +02:00
Valentin Gagarin	b5ca3d12b6	reword details on keeping closure property	2022-08-04 12:37:47 +02:00
Valentin Gagarin	e90586c0a4	add motivation for references	2022-08-04 12:37:47 +02:00
Valentin Gagarin	07d490fd89	stores can also delete objects	2022-08-04 12:37:47 +02:00
Valentin Gagarin	5fda995491	formalize file system objects convention: describe every data type in prose, and illustrate with a class diagram, and a textual representation of an abstract data type. right now we save ourselves the trouble of doing class diagrams, we can add them later. but they are important.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	fb2ec7e4ec	reword section on references use file Contents instead of Data, as that flows more naturally in the prose. simplify explanation of the idea behind scanning for store paths remove references to unfinished sections.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	90fc5b41a8	reword file system objects - use singular for the "class" - more consistency in type definition - minor fixes in wording	2022-08-04 12:37:47 +02:00
Valentin Gagarin	e5e48593c8	move git comparison to related work it should be pulled out of the branch before we go for merging	2022-08-04 12:37:47 +02:00
Valentin Gagarin	a145007a57	component -> store object, realisation -> build	2022-08-04 12:37:47 +02:00
Valentin Gagarin	40efe5b30b	build instrcution: Task -> function	2022-08-04 12:37:47 +02:00
Valentin Gagarin	ca5ebf6382	revert build plan/step distinction, reorder rows	2022-08-04 12:37:47 +02:00
Valentin Gagarin	610ddf44aa	reword introduction to rosetta stone, add links attempt to explain used and documented terminology, as well as how the declarative programming paradigm relates to building software. in the future one could highlight encouraged terms to shape future material into higher consistency.	2022-08-04 12:37:47 +02:00
Valentin Gagarin	5f96a0b4e8	associated operations are not collected Co-authored-by: John Ericson <git@JohnEricson.me>	2022-08-04 12:37:47 +02:00
Valentin Gagarin	070c85499b	fix grammar Co-authored-by: John Ericson <git@JohnEricson.me>	2022-08-04 12:37:47 +02:00
Valentin Gagarin	7b5c00f67f	add concrete store examples, reword note on file system	2022-08-04 12:37:47 +02:00
Valentin Gagarin	c8c1b705ad	reword section on Nix store	2022-08-04 12:37:47 +02:00
Valentin Gagarin	39f01176a7	design -> architecture, add motivation following ideas found in Architecture of Gazelle[1] [1]: `56d35f8db0/Design.rst`	2022-08-04 12:37:47 +02:00
Valentin Gagarin	d30033759a	address Nix language consistently as configuration language	2022-08-04 12:37:46 +02:00
Valentin Gagarin	7598126391	remove separate meta-section, add architecture diagram the diagram is a first approximation and only covers that same section. of course there is much more going on, and other features should at some point also be illustrated. we also have to think about presentation format and technicalities behind it. the manual has to render to `man`, but we may want something more refined for web view.	2022-08-04 12:37:46 +02:00
Valentin Gagarin	34ea74c9ec	reword introductory section there should be a meta section for each chapter to give motivation of the presented structure. the structure itself is visible from the table of contents.	2022-08-04 12:37:46 +02:00
Valentin Gagarin	b387d80943	remove sentence for chapter transition idea: sections could be read in different orders by linking them in different ways (e.g. depth-first or breadth-first). adding hard-coded transitions makes that confusing.	2022-08-04 12:37:46 +02:00
John Ericson	89a7c956ff	Apply suggestions from code review Co-authored-by: Valentin Gagarin <valentin@fricklerhandwerk.de>	2022-08-04 12:37:46 +02:00
Valentin Gagarin	51e6bed25e	do not mention implementation details Co-authored-by: John Ericson <git@JohnEricson.me>	2022-08-04 12:37:46 +02:00
Valentin Gagarin	23ee0b24f7	correctly use comma for nesting Co-authored-by: John Ericson <git@JohnEricson.me>	2022-08-04 12:37:46 +02:00
Valentin Gagarin	804e8bd747	indicate sequence with "then" Co-authored-by: John Ericson <git@JohnEricson.me>	2022-08-04 12:37:46 +02:00
Valentin Gagarin	327ccd3b07	only use generic build system terminology we will use a translation table to introduce nix-specific terms	2022-08-04 12:37:46 +02:00
Valentin Gagarin	0eae4bfad1	reword overview with clear terminology trying to capture alternative terms in one go here, mirroring everyday use: derivation - build plan realise - execute build there will be more of that sort.	2022-08-04 12:37:46 +02:00
John Ericson	0737094161	Add draft "Rosetta stone" by @fricklerhandwerk and stub commentary The idea and most of the execution are @fricklerhandwerk's. I changed a few things best I could based on @edolstra's corrections, and a Bazel glossary. Valentin Gagarin <valentin@fricklerhandwerk.de>	2022-08-04 12:37:46 +02:00
John Ericson	c86c1ec7e3	Make refernces sneak preview more concise	2022-08-04 12:37:46 +02:00
John Ericson	4e4bbd9e83	Improve store objects session more	2022-08-04 12:37:46 +02:00
John Ericson	e4eea5e84e	Include abstract syntax based on the thesis for FSOs See https://edolstra.github.io/pubs/phd-thesis.pdf, page 91.	2022-08-04 12:37:46 +02:00
John Ericson	b98dc3b19c	store objects, better opining sentances	2022-08-04 12:37:46 +02:00
John Ericson	55b437b551	Improve store path section	2022-08-04 12:37:46 +02:00
John Ericson	b4df351880	Relocability -> relocation in store object title	2022-08-04 12:37:46 +02:00
John Ericson	5f4d2ac091	Improve store object section In particular, Nix is not like Git, so that needs to be fixed.	2022-08-04 12:37:46 +02:00
John Ericson	1bbad62c7d	doc: File system data -> file system object, to match Nix	2022-08-04 12:37:46 +02:00
John Ericson	838ba26fda	Rename files after store entry -> store object rename	2022-08-04 12:37:46 +02:00
John Ericson	4e2d5ae202	doc: Store entry -> store object This matches the terminology in Eelco's thesis.	2022-08-04 12:37:46 +02:00
John Ericson	e308602fdf	Update doc/manual/src/design/store/drvs/drvs.md Co-authored-by: Matthieu Coudron <teto@users.noreply.github.com>	2022-08-04 12:37:46 +02:00
John Ericson	cdb0bf3b65	Update doc/manual/src/design/overview.md Co-authored-by: Valentin Gagarin <valentin@fricklerhandwerk.de>	2022-08-04 12:37:46 +02:00
John Ericson	75c5191a1f	Update doc/manual/src/design/overview.md Co-authored-by: Valentin Gagarin <valentin@fricklerhandwerk.de>	2022-08-04 12:37:46 +02:00
John Ericson	a04340f9a1	Update doc/manual/src/design/overview.md Co-authored-by: Valentin Gagarin <valentin@fricklerhandwerk.de>	2022-08-04 12:37:46 +02:00
John Ericson	f5386d7059	Fix stub file's name	2022-08-04 12:37:46 +02:00
John Ericson	678d75baea	Start on the derivations section	2022-08-04 12:37:46 +02:00
John Ericson	e3a0209a9e	Move the bits on relocating store entires to the end They are too advanced for up front.	2022-08-04 12:37:46 +02:00
John Ericson	a210504bc7	Apply suggestions from code review	2022-08-04 12:37:46 +02:00
John Ericson	e64633f98f	Flesh out TOC	2022-08-04 12:37:46 +02:00
John Ericson	a2b3160f28	Briefly describe the digest of a store path	2022-08-04 12:37:46 +02:00
John Ericson	523359d133	WIP: Document the design of Nix The current docs are all "how to do things" and no "what is Nix" or "why are things the way they are". I see lots of misconception on the wider internet, and I also think we would benefit from a "living document" to answer some questions people currently turn to the thesis for. I think a new section of the manual can address all these issues.	2022-08-04 12:37:46 +02:00
Valentin Gagarin	499ed26508	manual: remove "Writing Nix Expressions" chapter 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	2022-08-04 11:59:25 +02:00
Théophane Hufschmitt	7d1ccd9105	Merge pull request #6846 from fricklerhandwerk/values manual: use subheadings for primitive types	2022-08-03 14:50:41 +02:00
Théophane Hufschmitt	c55bea4204	Fix the html id of the list headers	2022-08-03 14:16:00 +02:00
Valentin Gagarin	ceed4d4142	encode primitive as list with anchors to make it consistent with builtins and configuration options	2022-08-03 11:25:41 +02:00
K900	f675ba5331	doc/distributed-builds: don't use deprecated alias `nix ping-store` -> `nix store ping`.	2022-08-01 13:50:35 +03:00
Valentin Gagarin	27138f1ec6	manual: use singular in body, too Co-authored-by: Cole Helbling <cole.e.helbling@outlook.com>	2022-07-28 23:30:07 +02:00
Valentin Gagarin	41a3b315fd	manual: values -> data types	2022-07-28 17:25:25 +02:00
Valentin Gagarin	8f4fab8fab	manual: use singular for headings	2022-07-28 17:25:18 +02:00
Valentin Gagarin	4ff48854b8	manual: simple values -> primitives "simple" is a loaded term	2022-07-28 17:23:57 +02:00
Valentin Gagarin	3063e5b94c	manual: use subheadings for primitive types this gives us HTML anchors for each of them	2022-07-28 17:23:57 +02:00
Valentin Gagarin	85cdaebcd6	manual: set -> attribute set reword description to have shorter sentences.	2022-07-28 16:10:24 +02:00
Valentin Gagarin	be4654c344	manual: fix section title in table of contents	2022-07-28 15:55:41 +02:00
Théophane Hufschmitt	7ed91d6c6a	Merge branch 'master' into parallel-nix-copy	2022-07-20 10:05:34 +02:00
John Ericson	12461e246b	Leverage existing docs for new store-path^outputs syntax	2022-07-15 14:04:22 +00:00
John Ericson	279ecf7cde	Remove `computed-derivations` experimental feature We don't need it yet.	2022-07-15 13:42:17 +00:00
John Ericson	6cafe308c9	Merge remote-tracking branch 'upstream/master' into indexed-store-path-outputs	2022-07-14 16:15:37 -04:00
Eelco Dolstra	28e913c605	Branch 2.10 release notes	2022-07-11 21:10:23 +02:00
Eelco Dolstra	545383208e	Merge pull request #6777 from laalsaas/master Fix logical and typographical errors in nix-env man page	2022-07-11 13:52:40 +02:00
Eelco Dolstra	517ce38dad	Update release notes	2022-07-11 11:17:19 +02:00
laalsaas	eac211a171	Fix logical and typographical errors in nix-env man page	2022-07-10 12:30:17 +02:00
Théophane Hufschmitt	6fa95c35c7	Add a release notes entry for #4914 cc @gytis-ivaskevicius	2022-07-06 06:46:54 +02:00
Travis A. Everett	649c9d9b4c	doc: acknowledge post-rsync reality Before #5150 the copy-to-store phase of the install was idempotent, but the recursive cp isn't. This is probably baiting a few people into trying corrective installs that will fail.	2022-06-30 13:31:04 -05:00
Travis A. Everett	fe76b9f4b4	doc: fix some darwin uninstall gaps	2022-06-16 09:37:52 -05:00
Tom Bereknyei	51268ceb79	Merge branch 'master' into nix-repl-flakes	2022-06-15 09:17:03 -04:00
tomberek	dae4a8a6c8	Apply suggestions from code review Co-authored-by: Théophane Hufschmitt <7226587+thufschmitt@users.noreply.github.com>	2022-06-15 09:02:36 -04:00
Hugo Osvaldo Barrera	fd7f795750	Add disambiguation to man page This should help future lost newcomers like myself understand where to find the docs for both of these commands and how they differ.	2022-06-14 18:13:35 +02:00
Travis A. Everett	edfcc8256e	doc: add install test info to hacking.md	2022-06-11 13:30:51 -05:00
Théophane Hufschmitt	34d90fbe22	Mention the parallel copy in the release notes	2022-06-08 15:25:52 +02:00
Tom Bereknyei	ffd41d1757	Merge branch 'master' into nix-repl-flakes	2022-06-02 16:58:35 -04:00
John Ericson	b585548dfe	Merge remote-tracking branch 'upstream/master' into indexed-store-path-outputs	2022-06-02 19:53:11 +00:00
Théophane Hufschmitt	a5f7b934bd	Merge branch 'master' into lto	2022-06-01 17:55:03 +02:00
Eelco Dolstra	04a699b8a9	Typo	2022-05-31 10:38:03 +02:00
Eelco Dolstra	de13b44573	Branch 2.9 release notes	2022-05-30 20:42:55 +02:00
Eelco Dolstra	8e8e9d8705	Respect the outputSpecified attribute E.g. 'nix build nixpkgs#libxml2.dev' will build the 'dev' output.	2022-05-30 11:34:47 +02:00
Eelco Dolstra	d67a2ae52d	Merge branch 'doc-redirects' of https://github.com/jtojnar/nix	2022-05-27 11:12:41 +02:00
Jan Tojnar	a793863b97	doc: Manually insert some anchors	2022-05-26 18:17:21 +02:00
Jan Tojnar	7708a34a51	doc: Add anchors to long lists 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-26 18:17:21 +02:00
Eelco Dolstra	8f4548d401	Tweak IN_NIX_SHELL description	2022-05-26 12:40:01 +02:00
Ben Burdette	9a5ea6c359	Merge branch 'master' into debug-exploratory-PR	2022-05-25 10:41:10 -06:00
Ben Burdette	6031a36208	add --debugger to rl-next list	2022-05-25 10:38:13 -06:00
pennae	b092afe77d	Merge branch 'master' into lto	2022-05-25 11:55:13 +00:00
Tom Bereknyei	82c4af41e3	repl: clarify change and usage of <nixpkgs>	2022-05-20 01:49:49 -04:00
Tony Olagbaiye	5b8c1deb18	fetchTree: Allow fetching plain files Add a new `file` fetcher type, which will fetch a plain file over http(s), or from the local file. Because plain `http(s)://` or `file://` urls can already correspond to `tarball` inputs (if the path ends-up with a know archive extension), the URL parsing logic is a bit convuluted in that: - {http,https,file}:// urls will be interpreted as either a tarball or a file input, depending on the extensions of the path part (so `https://foo.com/bar` will be a `file` input and `https://foo.com/bar.tar.gz` as a `tarball` input) - `file+{something}://` urls will be interpreted as `file` urls (with the `file+` part removed) - `tarball+{something}://` urls will be interpreted as `tarball` urls (with the `tarball+` part removed) Fix #3785 Co-Authored-By: Tony Olagbaiye <me@fron.io>	2022-05-19 18:24:49 +02:00
Tom Bereknyei	1ca3f6035d	repl: update docs with installables	2022-05-18 21:21:38 -04:00
John Ericson	b18720ee17	Merge remote-tracking branch 'upstream/master' into indexed-store-path-outputs	2022-05-12 19:13:33 +00:00
Théophane Hufschmitt	65a913d29b	Don’t recommend writing unit tests As asked in <https://github.com/NixOS/nix/pull/6517#discussion_r869416905>	2022-05-12 12:02:31 +02:00
Théophane Hufschmitt	7c75f1d52b	Expand the testing section of the hacking docs - Make it clear what the different kind of tests are, where they live and how they can be ran - Ask people to primarily write unit tests	2022-05-10 13:35:23 +02:00
Eelco Dolstra	4a79cba511	Allow selecting derivation outputs using 'installable!outputs' E.g. 'nixpkgs#glibc^dev,static' or 'nixpkgs#glibc^*'.	2022-05-03 13:43:52 +02:00
Guillaume Maudoux	9ff892aad4	Add release notes for error traces revamp	2022-04-29 11:24:48 +02:00
pennae	d6d6bbd9ef	Merge branch 'master' into lto	2022-04-25 14:02:37 +00:00
midchildan	c67d8876c3	feat: add integration with zsh's run-help	2022-04-25 02:21:41 +09:00
Théophane Hufschmitt	be28603dca	Merge remote-tracking branch 'origin/master' into nixbuildaddprintstorepaths	2022-04-22 11:11:01 +02:00
Tom Bereknyei	f25112d383	fix: builtins.toFile adds path to allowedPaths The produced path is then allowed be imported or utilized elsewhere: ``` assert (43 == import (builtins.toFile "source" "43")); "good" ``` This will still fail on write-only stores.	2022-04-21 16:41:37 -04:00
Artturin	51cfea8bb0	nix build: add --print-out-paths flag has the same functionality as default nix-build $ nix-build . -A "bash" -A "bash.dev" -A "tinycc" /nix/store/4nmqxajzaf60yjribkgvj5j54x9yvr1r-bash-5.1-p12 /nix/store/c49i1ggnr5cc8gxmk9xm0cn961z104dn-bash-5.1-p12-dev /nix/store/dbapb08862ajgaax3621fz8hly9fdah3-tcc-0.9.27+date=2022-01-11 $ nix-build . -A "bash" /nix/store/4nmqxajzaf60yjribkgvj5j54x9yvr1r-bash-5.1-p12 $ $HOME/nixgits/nix/result/bin/nix build "nixpkgs#bash" "nixpkgs#bash.dev" "nixpkgs#tinycc" --print-out-paths /nix/store/4nmqxajzaf60yjribkgvj5j54x9yvr1r-bash-5.1-p12 /nix/store/c49i1ggnr5cc8gxmk9xm0cn961z104dn-bash-5.1-p12-dev /nix/store/dbapb08862ajgaax3621fz8hly9fdah3-tcc-0.9.27+date=2022-01-11 $ $HOME/nixgits/nix/result/bin/nix build "nixpkgs#bash" --print-out-paths /nix/store/4nmqxajzaf60yjribkgvj5j54x9yvr1r-bash-5.1-p12	2022-04-20 19:35:46 +03:00
ckie	0e2b01b14e	nix repl: make symlinks with the :bl command Requested by ppepino on the Matrix: https://matrix.to/#/!KqkRjyTEzAGRiZFBYT:nixos.org/$Tb32BS3rVE2BSULAX4sPm0h6CDewX2hClOTGzTC7gwM?via=nixos.org&via=matrix.org&via=nixos.dev This adds a new command, :bl, which works like :b but also creates a GC root symlink to the various derivation outputs. ckie@cookiemonster ~/git/nix -> ./outputs/out/bin/nix repl Welcome to Nix 2.6.0. Type :? for help. nix-repl> :l <nixpkgs> Added 16118 variables. nix-repl> :b runCommand "hello" {} "echo hi > $out" This derivation produced the following outputs: ./repl-result-out -> /nix/store/kidqq2acdpi05c4a9mlbg2baikmzik44-hello [1 built, 0.0 MiB DL] ckie@cookiemonster ~/git/nix -> cat ./repl-result-out hi	2022-04-20 00:20:29 +03:00
John Ericson	6b61d7722d	Merge remote-tracking branch 'upstream/master' into indexed-store-path-outputs	2022-04-19 20:30:12 +00:00
Eelco Dolstra	1cdad1074c	Move rl-next.md to rl-2.8.md	2022-04-19 21:12:33 +02:00
John Ericson	41e755bee4	Merge remote-tracking branch 'upstream/master' into indexed-store-path-outputs	2022-04-19 15:14:06 +00:00
Tom Bereknyei	9b41239d8f	fix: ensure apps are apps and packages are packages	2022-04-14 23:57:52 -04:00
John Ericson	fda2224b59	Add release notes mark experimental	2022-04-07 19:45:38 +00:00
Rehno Lindeque	5ff4c42608	Update release notes	2022-04-06 12:24:35 -04:00
Eelco Dolstra	f98d76ff1a	rl-2.7.md: Fix title	2022-04-05 14:13:26 +02:00
Eelco Dolstra	d63a5f5dd3	Update release notes	2022-03-31 17:33:06 +02:00
Eelco Dolstra	86b05ccd54	Only provide builtin.{getFlake,fetchClosure} is the corresponding experimental feature is enabled This allows writing fallback code like if builtins ? fetchClosure then builtins.fetchClose { ... } else builtins.storePath ...	2022-03-25 14:04:18 +01:00
Eelco Dolstra	98658ae9d2	Document fetchClosure	2022-03-24 21:33:33 +01:00
Eelco Dolstra	5acaf13d35	Rename 'nix store make-content-addressable' to 'nix store make-content-addressed'	2022-03-24 21:33:33 +01:00
Domen Kožar	98ce1a21b7	Merge pull request #6144 from toonn/doc-macos-uninstall doc: Add detailed uninstall section for macOS	2022-03-23 08:53:48 +01:00
Théophane Hufschmitt	7117053457	Merge pull request #6270 from Artturin/stdineval nix: allow using --file - to read from stdin	2022-03-17 14:35:01 +01:00
Artturin	a5c969db49	nix: allow using --file - to read from stdin	2022-03-16 21:01:51 +02:00
Joachim Breitner	af013281c9	distributed-builds.md: fixing typo of the most minor sort	2022-03-16 12:53:38 +01:00
pennae	f2603e9c92	Merge branch 'master' into lto	2022-03-10 00:32:34 +00:00
Eelco Dolstra	ad7c99ef20	Move rl-next.md to rl-2.7.md	2022-03-07 20:10:18 +01:00
Eelco Dolstra	0123b9aec8	Tweak release notes	2022-03-07 19:56:10 +01:00
Eelco Dolstra	30ddd37873	Merge branch 'cli-suggestions' of https://github.com/thufschmitt/nix	2022-03-07 19:47:45 +01:00
Eelco Dolstra	c28e2b1b29	Tweak release notes	2022-03-07 11:30:40 +01:00
regnat	b44cebd1fd	Add a release-notes entry for the cli suggestions	2022-03-07 10:09:10 +01:00
pennae	2799fe4cdb	enable LTO in optimized builds gives 2-5% performance improvement across a board of tests. LTO is broken when using clang; some libs link fine while others crash the linker with a segfault in the llvm linker plugin. 🙁	2022-03-03 17:47:49 +01:00
toonn	947d4761b3	doc: Add removal of darwin-store LaunchDaemon The uninstall instructions used to accidentally remove the nix-darwin LaunchDaemon, this was dropped. However, the original intent was to remove the Store volume mounting LaunchDaemon.	2022-02-26 14:16:35 +01:00
toonn	2df23e2b3e	doc: Drop nix-darwin service from macOS uninstall	2022-02-25 10:50:01 +01:00
toonn	064cad7e9f	doc: Add macOS uninstall note about /nix Clarify that `/nix` being present after the uninstall is normal and it will only disappear after a reboot. Co-authored-by: Travis A. Everett <travis.a.everett@gmail.com>	2022-02-25 10:32:45 +01:00
Eelco Dolstra	59683733f5	Merge pull request #6089 from edolstra/dot-default Replace defaultBla.$system with bla.$system.default	2022-02-24 21:16:58 +01:00
Théophane Hufschmitt	54f07b66c8	Precise the doc for `--include-outputs` Make it explicit that it only includes the existing outputs and not the ones that haven’t been realised	2022-02-23 09:17:08 +01:00
toonn	400d70a3a9	doc: Add detailed uninstall section for macOS The multi-user installation on macOS, which is now the only option, has gotten complicated enough that it discourages some users from checking Nix out for fear of being left with a "dirty" system. Detailed uninstallation instructions should make this less of an issue.	2022-02-22 16:28:24 +01:00
Eelco Dolstra	38eea2c503	Update release notes	2022-02-22 14:23:39 +01:00
Taeer Bar-Yam	219fa2e43d	add release notes for welcomeText	2022-02-17 15:17:20 -05:00
tomberek	2bf96bd9f2	Merge branch 'master' into bundler_drv	2022-01-28 10:18:29 -05:00
Eelco Dolstra	35dbdbedd4	nix store ping: Report Nix daemon version Fixes #5952.	2022-01-25 21:15:58 +01:00
Tom Bereknyei	dc85e20684	bundler: notes and doc update to include bundlers repo	2022-01-25 03:48:44 -05:00
Eelco Dolstra	9faad4c5eb	Move rl-next.md to rl-2.5.md	2022-01-25 00:11:00 +01:00
Eelco Dolstra	edf0cde1a7	Merge pull request #5960 from zombiezen/patch-1 Correct `NIX_BUILD_PATH` default description	2022-01-24 12:46:43 +01:00
Eelco Dolstra	3782017272	Tweak release notes	2022-01-24 12:45:35 +01:00
Ross Light	7477974b93	Correct NIX_BUILD_PATH default description Source: `067076287b/src/nix-build/nix-build.cc (L362-L381)`	2022-01-21 18:45:19 -08:00
Rok Garbas	d463e11760	Adding docs regarding the docker image from master	2022-01-21 14:50:34 +01:00
lincoln auster [they/them]	7d4f86f032	release-notes: document commit-lockfile-summary option This documents 3023c7700.	2022-01-18 16:10:44 -07:00
Eelco Dolstra	4dda1f92aa	Add command 'nix store copy-log' Fixes #5222.	2022-01-18 14:08:49 +01:00
Théophane Hufschmitt	dc4730ee94	Merge pull request #5720 from tomberek/flake_search flakes: search up to git or filesystem boundary	2022-01-18 10:59:12 +01:00
tomberek	2dead20924	Apply suggestions from code review Co-authored-by: Théophane Hufschmitt <7226587+thufschmitt@users.noreply.github.com>	2022-01-14 09:16:34 -05:00
Eelco Dolstra	5e9653c370	Tweak	2022-01-13 14:33:41 +01:00
Eelco Dolstra	66424cd29f	Merge branch 'patch-1' of https://github.com/TheodorRene/nix	2022-01-13 14:31:49 +01:00
Profpatsch	a51c457204	Release Notes 2.4: add `--indirect` no-op change Since `00d25e8457` which was first included in nix 2.4. It is a backwards-compatible change since the flag will just be ignored.	2022-01-12 23:19:15 +01:00
Theodor René Carlsen	89b4df8d92	Add link to explanation when introducing a new operator The logical implication operator is included in this section but never explained. It might stump new readers with a pretty uncommon operator, and it's never referenced explicitly.	2022-01-11 17:01:43 +01:00
pennae	00c993f48b	add zipAttrsWith primop nixpkgs can save a good bit of eval memory with this primop. zipAttrsWith is used quite a bit around nixpkgs (eg in the form of recursiveUpdate), but the most costly application for this primop is in the module system. it improves the implementation of zipAttrsWith from nixpkgs by not checking an attribute multiple times if it occurs more than once in the input list, allocates less values and set elements, and just avoids many a temporary object in general. nixpkgs has a more generic version of this operation, zipAttrsWithNames, but this version is only used once so isn't suitable for being the base of a new primop. if it were to be used more we should add a second primop instead.	2022-01-03 21:05:53 +01:00
Alexander Bantyev	a26351da02	Add ability to toggle show-trace from within the repl	2021-12-29 02:54:36 +03:00
tomberek	f404189368	Merge branch 'master' into flake_search	2021-12-23 15:22:52 -05:00
Eelco Dolstra	881b610266	Update release notes	2021-12-21 14:19:21 +01:00
Eelco Dolstra	c260640dec	Fix docker instructions	2021-12-16 21:48:38 +01:00
jesse	11ee875a6d	List aarch64 as supported macOS hardware Resolves #5767	2021-12-15 10:55:34 -08:00
Eelco Dolstra	18cb094aab	rl-2.5.md: Set date	2021-12-13 19:57:06 +01:00
Eelco Dolstra	f133001dc8	Move rl-next.md to rl-2.5.md	2021-12-13 16:48:44 +01:00
Eelco Dolstra	3f417c8d1c	Add release notes entry for #5149	2021-12-13 16:43:42 +01:00
Janne Heß	4194b68250	doc: Fix command for distributed builds We also need to build impurely or the <nixpkgs> lookup will not work.	2021-12-10 12:58:12 +01:00
Amon Stopinšek	0bd93ed747	Fix link to nixos channel The old link returned 404 errror.	2021-12-09 16:44:24 +00:00
Eelco Dolstra	167e864697	Merge pull request #5730 from abathur/darwin_document_fstab_settings document some darwin mount settings	2021-12-07 22:24:40 +01:00
Alexander Bantyev	33926ed1e7	nix repl: add :log Add a :log command that shows logs for a derivation. Closes https://github.com/NixOS/nix/issues/3504 Co-authored-by: Taeer Bar-Yam <taeer@bar-yam.me>	2021-12-06 16:52:50 +03:00
Travis A. Everett	8093456111	document some darwin mount settings	2021-12-04 23:16:42 -06:00
Tom Bereknyei	b6cc0a704d	flakes: search up to git or filesystem boundary While parsing a flakeref, upon not finding a flake.nix, search upwards until git or filesystem boundary.	2021-12-03 10:55:30 -05:00
Eelco Dolstra	2e606e87c4	Merge pull request #5715 from Infinisil/groupBy-primop Introduce `builtins.groupBy` primop	2021-12-03 13:21:14 +01:00
David Purdum	69b9198875	Fix docker command `docker -ti run nixos` does not run on docker version 20.10.7 (my machine). This fixes it to read `docker run -ti nixos`.	2021-12-02 23:38:33 -05:00
Silvan Mosberger	90700736c7	Introduce builtins.groupBy primop This function is very useful in nixpkgs, but its implementation in Nix itself is rather slow due to it requiring a lot of attribute set and list appends.	2021-12-02 21:54:51 +01:00
Eli Flanagan	092c375cda	Update doc/manual/src/glossary.md Co-authored-by: Eelco Dolstra <edolstra@gmail.com>	2021-11-30 13:19:42 -05:00
Eli Flanagan	a473e85c80	docs: document set theory symbols These symbols confused me so I wanted to gloss them to help future users. You can see the context here: https://discourse.nixos.org/t/flakes-what-does-mean-big-bundle-of-questions	2021-11-30 11:13:46 -05:00
Eelco Dolstra	b96164f4af	Merge remote-tracking branch 'origin/build-with-clang'	2021-11-30 11:50:56 +01:00
Eelco Dolstra	ddf4fb750d	Merge pull request #5678 from t184256/document-libsodium Document libsodium, which is now mandatory, as a dependency.	2021-11-29 11:11:10 +01:00
Alexander Sosedkin	a9bd06d0ea	Make libcpuid dependency optional with --disable-cpuid	2021-11-28 00:52:35 +01:00
Alexander Sosedkin	b73a1c0638	Document libcpuid dependency	2021-11-28 00:52:35 +01:00
Alexander Sosedkin	33a227503a	Document libsodium, which is now mandatory, as a dependency	2021-11-27 23:11:11 +01:00
Pamplemousse	288c252570	Documentation: alternative `stdenv` for hacking Signed-off-by: Pamplemousse <xav.maso@gmail.com>	2021-11-26 10:04:56 +01:00
Eelco Dolstra	986906e687	Update names	2021-11-25 17:09:11 +01:00
Silvan Mosberger	09471d2680	Make lists be comparable Makes lists comparable using lexicographic comparison. Increments builtins.langVersion in order for this change to be detectable	2021-11-24 13:40:46 +01:00
Lorenz Leutgeb	e1192116d3	doc: Fix escape for operator "logical or" See https://matrix.to/#/!KqkRjyTEzAGRiZFBYT:nixos.org/$hhMb6AdRIXfRkv_LsNsiQJuch7AQ_b6szr4tfawFy-4	2021-11-18 15:08:01 +01:00
Eelco Dolstra	e88fb63e28	Merge pull request #5585 from jtojnar/env-a doc: De-emphasize nix-env without -A	2021-11-18 14:34:45 +01:00
Jan Tojnar	ca4d8ce9e2	doc: De-emphasize nix-env without -A The manual uses `nix-env -i` without `-A` prominently, teaching a bad practice to newcomers.	2021-11-17 17:04:25 +01:00
Jan Tojnar	e96faadcd6	Fix XDG_CONFIG_DIRS fallback According to XDG Base Directory Specification, it should fall back to /etc/xdg when the env var is not present.	2021-11-17 14:31:15 +01:00
Eelco Dolstra	51ffc19f02	Merge branch 'add-docker-image-to-hydra-jobs' of https://github.com/garbas/nix	2021-11-16 13:00:54 +01:00
Kevin Amado	eae54f2d52	fix many doc typos	2021-11-13 22:28:20 -05:00
Rok Garbas	a118a70649	Documenting how to use/build Nix' Docker image	2021-11-11 16:07:01 +01:00
Théo Zimmermann	d589782fb0	Fix some typos in CLI guideline.	2021-11-08 08:24:15 +01:00
Jan Tojnar	e5d4c2235f	docs: Correct fallback user config path 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-04 11:41:29 +01:00
Dimitris Apostolou	c34cc5e488	Fix typos	2021-11-03 18:11:20 +02:00
Simon Legner	1968760f4a	command-ref/nix-shell: fix --pure, --keep	2021-11-02 22:00:08 +01:00
Eelco Dolstra	b61b307bad	Remove references to building from the source tarball	2021-11-02 15:29:47 +01:00
Eelco Dolstra	6a93e186f4	Fix 2.4 migration examples	2021-11-01 22:44:07 +01:00
Eelco Dolstra	bc4b7521f4	Rename rl-2.5.md to rl-next.md Having a generically named file for release notes for the next release makes things easier for PRs.	2021-10-28 14:36:47 +02:00
Eelco Dolstra	9c6ac9eb0e	2.4 release notes: Add some migration notes	2021-10-27 17:33:32 +02:00
Domen Kožar	51c812d6bb	Merge pull request #5365 from arafangion/master Clarify that not all nix packages will use the default build phases	2021-10-17 20:54:00 -05:00
John Chapman	ffeec5f283	Clarify that not all nix packages will use the default build phases	2021-10-17 15:24:22 +11:00
Eelco Dolstra	4c0cde95ad	Update release notes	2021-10-13 11:39:54 +02:00
Eelco Dolstra	2f3c79c241	Mention compression-level in the release notes	2021-10-13 11:11:26 +02:00
John Chapman	4cff413054	Clarify that not all nix packages will use the default build phases	2021-10-09 12:03:34 +11:00
Eelco Dolstra	844dd901a7	Start 2.5 release notes	2021-10-07 20:09:03 +02:00
Eelco Dolstra	f45b30de2f	Revert "docs: add troubleshooting session in remote builds" This reverts commit `0574c1850a`.	2021-10-06 17:12:52 +02:00
Domen Kožar	d0cc6a192a	Merge pull request #5095 from happysalada/update_remote_builds_docs docs: add troubleshooting session in remote builds	2021-10-06 08:10:53 -05:00
happysalada	0574c1850a	docs: add troubleshooting session in remote builds	2021-10-06 21:47:53 +09:00
Rafal Gwozdzinski	a73f855bd4	Fix typo	2021-10-03 12:19:59 +02:00
Eelco Dolstra	0e3b8ca767	Typo	2021-10-01 16:32:07 +02:00
Eelco Dolstra	43221bb319	Comments	2021-10-01 16:29:53 +02:00
Eelco Dolstra	91b39eee25	Typo Co-authored-by: Sebastian Ullrich <sebasti@nullri.ch>	2021-10-01 14:18:07 +02:00
Eelco Dolstra	5e222ac18b	Release notes	2021-09-30 17:36:09 +02:00
Eelco Dolstra	25b6b74175	Manual: Link to 2.4 release notes	2021-09-09 15:01:36 +02:00
Eelco Dolstra	7ee639f9db	Merge pull request #5066 from Radvendii/master add antiquotations to paths	2021-09-01 12:55:04 +02:00
Taeer Bar-Yam	b2beb97f2a	add documentation for path antiquotations	2021-08-31 08:17:17 -04:00
Pamplemousse	0e7bd65976	`15f4d4f` Documentation follow-up	2021-08-19 09:40:47 -07:00
Eelco Dolstra	f1ecd30bd5	Merge pull request #4773 from alyssais/dl doc: builtins: use a definition list	2021-07-05 14:03:15 +02:00
Keshav Kini	f35f9af787	Improve explanation of NIX_PATH prefix syntax The previous wording seemed to imply that the "channel:" syntax would resolve to a github archive URL, which is not the case.	2021-06-03 17:59:39 -07:00
Linus Heckemann	a3553cdae8	doc/nix-shell: Remove outdated bashrc information This behaviour was removed in `65f6d5db6f`.	2021-05-11 14:33:35 +02:00
Alyssa Ross	5f07f2ff2b	doc: builtins: use a definition list This looks a lot better (and is also more semantically meaningful). Since this list is generated in a Nix expression, I don't think using HTML here is going to be the thing that puts people off modifying this part of the documentation!	2021-05-05 14:34:46 +00:00
Graham Christensen	d15a1962cb	Merge pull request #4289 from abathur/encrypt_darwin_volume darwin: encrypt nix volume if filevault is enabled	2021-04-29 15:59:12 -04:00
Travis A. Everett	eab14a642c	darwin: encrypt nix volume if filevault is enabled	2021-04-29 13:26:51 -05:00
Eelco Dolstra	fe2bf464cf	Merge branch 'remove-trailing-spaces' of github.com:NixOS/nix	2021-04-23 15:09:44 +02:00
regnat	31313d1401	Replace the trailing markdown spaces by a backslash 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-04-23 14:37:21 +02:00
regnat	2207018df5	(briefly) document how to build ca derivations	2021-04-23 10:28:26 +02:00
Björn Gohla	4d9568ef60	Revert "[prerequisites]: add JSON lib dependency" This reverts commit `5926200db0`.	2021-04-05 21:29:04 +01:00
Björn Gohla	5926200db0	[prerequisites]: add JSON lib dependency	2021-04-01 22:54:09 +01:00
Eelco Dolstra	4638bcfb2c	Fix some typos Fixes #4671.	2021-03-26 16:14:38 +01:00
Travis A. Everett	ac8ba2eae4	remove doc for obsolete --no-build-hook flag `--no-build-hook` appears to have been removed in `25f32625e2`	2021-03-06 19:51:29 -06:00
Graham Christensen	1130b28824	distributed builds: load remote builder host key from the machines file This is already used by Hydra, and is very useful when materializing a remote builder list from service discovery. This allows the service discovery tool to only sync one file instead of two.	2021-02-25 09:17:34 -05:00
Shea Levy	f6c5b05488	Respect command registrations in plugins.	2021-02-24 08:25:45 -05:00
Shea Levy	98d1b64400	Initialize plugins after handling initial command line flags This is technically a breaking change, since attempting to set plugin files after the first non-flag argument will now throw an error. This is acceptable given the relative lack of stability in a plugin interface and the need to tie the knot somewhere once plugins can actually define new subcommands.	2021-02-24 08:22:17 -05:00
Mauricio Scheffer	5f4701e70d	Update doc/manual/src/command-ref/nix-shell.md Co-authored-by: Cole Helbling <cole.e.helbling@outlook.com>	2021-02-16 23:27:04 +00:00
Mauricio Scheffer	35129884f9	Fix Haskell example 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-02-16 23:19:42 +00:00
Dominik Schrempf	fb00e7dc52	Remove newline in operator table.	2021-02-01 17:42:14 +01:00
Eelco Dolstra	d33eca8539	Rename 'nix store sign-paths' to 'nix store sign'	2021-01-13 23:32:37 +01:00
Eelco Dolstra	77c9ceda4b	Tweak	2021-01-11 19:42:24 +01:00
Sam Lidder	e069ddf325	Fix `configure` error in introduction doc	2020-12-31 20:17:37 -05:00

... 9 10 11 12 13 ...

1103 commits