nix-super

mirror of https://github.com/privatevoid-net/nix-super.git synced 2024-11-23 22:46:16 +02:00

Author	SHA1	Message	Date
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
Valentin Gagarin	8dd5ba2f47	more precise variable types	2022-09-09 09:54:24 +02:00
Valentin Gagarin	548c904d40	optimize performance remove loops and function calls, modify arrays in place this makes the whole thing harder to read, and probably only marginally faster.	2022-09-08 11:58:43 +02:00
Guillaume Maudoux	eb460a9529	WIP: broken merge but need a git checkpoint	2022-09-07 00:34:03 +02:00
Valentin Gagarin	59be1e500a	generalize anchor redirects renaming section headers and changing manually set `id`s will break URLs in the wild. this change allows keeping track of all changes to ensure backwards compatibility.	2022-09-06 00:49:16 +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	1f2b12b30e	Merge pull request #6968 from fricklerhandwerk/man-no-weblinks do not render relative links in help pages	2022-08-29 08:46:35 +02:00
Valentin Gagarin	e7dcacbd7c	do not render relative links in help pages this simplifies the setup a lot, and avoids weird looking `./file.md` links showing up. it also does not show regular URLs any more. currently the command reference only has few of them, and not showing them in the offline documentation is hopefully not a big deal. instead of building more special-case solutions, clumsily preprocessing the input, or issuing verbal rules on dealing with URLs, should better be solved sustainably by not rendering relative links in `lowdown`: https://github.com/kristapsdz/lowdown/issues/105	2022-08-26 17:10:41 +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	26d1877d6e	doc: Add redirects for the DocBook manual There are still many links to the old manual on the web and having them end up on the Introduction page is a bad user experience.	2022-05-26 18:17:21 +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
Jan Tojnar	3272afa17b	doc: Port anchors preprocessor to jq script Python is only pulled into the build closure by Mercurial, which might end up being removed. Let’s port the script to jq, which is more likely to stay.	2022-05-26 18:17:21 +02:00
Jan Tojnar	4de84e095d	doc: Introduce pre-processor for adding anchors to text It is now possible to use the following syntax to insert anchors into the text: []{#anchor-name} The anchor will allow linking to the location it is placed by appending #anchor-name to the URL. Additionally, it is possible to create a link pointing to its own location by adding text between the square brackets: [`--add-root`]{#opt-add-root}	2022-05-26 17:54:15 +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	71c07ac0e7	Merge pull request #6363 from thufschmitt/definition-list-in-nix.conf-manual Add anchors to the nix.conf options in the manual	2022-04-05 17:32:48 +02:00
Eelco Dolstra	f98d76ff1a	rl-2.7.md: Fix title	2022-04-05 14:13:26 +02:00
Théophane Hufschmitt	660c19eb49	manual: Add some anchor targets for the nix.conf options For each `nix.conf` option, add an empty html node with a unique `id` that can be used as an anchor target. Also make the name of the option be a link to that target so that it’s easily discoverable. We can’t rewrite the whole list as an html definition list like it’s done for the builtins because these options also appear in a man page, and the manpage renderer (lowdown) can’t render arbitrary html. But the hack here allows to keep the manpage and have the links in the html version. Fix https://github.com/NixOS/nix/issues/5745	2022-04-05 13:50:42 +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
Guillaume Desforges	cfbf9ee2ce	Anchor with prefix	2022-02-24 13:50:50 +01:00
Guillaume Desforges	6462ee61c7	Anchor link for builtin functions in HTML doc	2022-02-23 15:07:01 +01:00
Guillaume Desforges	2cc645a91a	Add html make target	2022-02-23 15:06:13 +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
Eelco Dolstra	26e99c817c	Merge pull request #6114 from Radvendii/welcomeText add release notes for welcomeText	2022-02-18 10:52:03 +01:00
Taeer Bar-Yam	219fa2e43d	add release notes for welcomeText	2022-02-17 15:17:20 -05:00
Rahul Butani	d82cf4a016	manual: fix formatting for options with "machine-specific" defaults	2022-02-15 15:44:05 -06: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
Théophane Hufschmitt	6234e1c811	Merge pull request #5702 from baloo/baloo/hide-non-reproducible-settings reproducibility: hide non-reproducible settings from manual	2021-12-14 09:14:25 +01: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
Arthur Gautier	21520297da	reproducibility: hide non-reproducible settings from manual Because the manual is generated from default values which are themselves generated from various sources (cpuid, bios settings (kvm), number of cores). This commit hides non-reproducible settings from the manual output.	2021-12-01 17:25:58 +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
Eelco Dolstra	99804465af	Merge pull request #5679 from t184256/optional-libcpuid Document libcpuid dependency and make it optional	2021-11-29 11:10:42 +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
Tom Bereknyei	152e3cda0c	reproducibility: determinstic man page output for cores	2021-11-26 10:55:43 -05: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
Eelco Dolstra	08aa7daee0	Remove links to .md files in help output Fixes #5337.	2021-10-06 13:01:18 +02: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	8fdb1d057a	Quiet	2021-09-22 14:12:31 +02:00
Eelco Dolstra	49a932fb18	nix --help: Display help using lowdown instead of man Fixes #4476. Fixes #5231.	2021-09-13 14:45:21 +02:00
Eelco Dolstra	25b6b74175	Manual: Link to 2.4 release notes	2021-09-09 15:01:36 +02:00
Eelco Dolstra	ff03fb6743	Manual: Depend on all *.md files	2021-09-09 15:01:19 +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
Sergei Trofimovich	33fa5f3cd9	doc/manual/local.mk: fix 'make install DESTDIR=...' Install failure is observed when we try to install into inplace location as non-root: ``` $ LANG=C make install DESTDIR=$PWD/__i__ V=1 RUST_LOG=warn mdbook build doc/manual -d /usr/share/doc/nix/manual 2021-08-28 13:29:58 [ERROR] (mdbook::utils): Error: Rendering failed 2021-08-28 13:29:58 [ERROR] (mdbook::utils): Caused By: Unexpected error when constructing destination path 2021-08-28 13:29:58 [ERROR] (mdbook::utils): Caused By: Permission denied (os error 13) make: *** [doc/manual/local.mk:98: /usr/share/doc/nix/manual/index.html] Error 101 ``` The change is to prefix paths with `$(DESTDIR)`.	2021-08-28 13:31:34 +01:00
Pamplemousse	0e7bd65976	`15f4d4f` Documentation follow-up	2021-08-19 09:40:47 -07:00
Eelco Dolstra	d64f9671fc	Merge pull request #5094 from Pamplemousse/simpler_doc doc/manual: don't need to copy `highlight.js` manually	2021-08-05 15:13:07 +02:00
Pamplemousse	de39cfb9f3	doc/manual: don't need to copy `highlight.js` manually Signed-off-by: Pamplemousse <xav.maso@gmail.com>	2021-08-04 19:47:05 -07:00
regnat	441be5d59a	Remove dead code in doc’s local.mk	2021-07-27 14:37:55 +02:00
regnat	cd6e9eb024	Fix the generation of nix3 manpages - Separate the generation of the manpages from their installation - Make sure that `make` generates the manpages - Make sure that `make install` installs them Fix #5051	2021-07-27 13:47:53 +02:00
regnat	c5f5d615a6	Cleanup the generation of the nix3 manpages Use a dedicated make target for the man page rather than bundling the generation as part of `install`. Also make sure that `make install` is a fixpoint by - Removing the generated markdown files from `MANUAL_SRCS` - Not having the manpage generation write in its source directory so as to not update its timestamp (it would run each time otherwise)	2021-07-19 16:55:56 +02: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
Eelco Dolstra	3996ca42cf	Merge pull request #4735 from NixOS/document-ca-derivations (briefly) document how to build ca derivations	2021-04-23 14:21:25 +02:00
Eelco Dolstra	e65f604ea9	Set more man sections	2021-04-23 14:20:28 +02:00
Alyssa Ross	29132f99c5	doc: fix section in nix3 man page metadata These man pages said they were in section 7, even though we were installing them to section 1 (which is the right place for them).	2021-04-23 10:52:54 +00: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
Eelco Dolstra	6042febfce	Restore warning about 'nix' being experimental Fixes #4552.	2021-02-17 15:30:49 +01: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	36c4d6f592	Group common options	2021-01-25 19:03:13 +01:00
Eelco Dolstra	807d963ee8	Group subcommands by category	2021-01-25 18:19:32 +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
Sevan Janiyan	9d3aad7b92	Update URL where bzip2 can be obtained	2020-12-25 01:43:22 +00:00
Eelco Dolstra	1047cb1e53	Command: Remove examples()	2020-12-23 18:26:40 +01:00
Eelco Dolstra	9dcd0aebc5	generate-manpage.nix: Fix short names	2020-12-21 13:32:27 +01:00
Rok Garbas	7de4b1e9aa	smaller fixes	2020-12-17 23:42:49 +01:00
Rok Garbas	ae77f21474	Switch away from classification as Tier1-3 to classification to a more descriptive classification.	2020-12-08 11:59:23 +01:00
Rok Garbas	0d7714b0d7	forgot to add the files	2020-12-08 10:25:03 +01:00
Rok Garbas	24db5b125f	Merge remote-tracking branch 'origin/master' into cli-guideline	2020-12-07 15:13:36 +01:00
regnat	5f66edf245	Make `make install` less noisy Remove the printing and useless output of a couple of commands when running `make install`	2020-12-04 14:50:47 +01:00
Eelco Dolstra	8ad2c9c4b9	Remove 'dist' target We're not producing source tarballs anymore so this has been bitrotting.	2020-12-03 16:17:58 +01:00
Eelco Dolstra	c3c858ac6d	Make doc() return arbitrary Markdown rather than the contents of the "Description" section Thus we can return the examples section (and any other sections) from doc() and don't need examples() anymore.	2020-12-03 16:17:58 +01:00
Eelco Dolstra	e2efc63979	Put examples first in the manpages	2020-12-02 23:23:23 +01:00
Eelco Dolstra	72428e38d9	Generate separate manpages for each nix subcommand	2020-12-02 23:23:23 +01:00
Rok Garbas	44da19f73c	Adds Nix CLI Guideline to docs As we are working towards Nix 3.0 we want to make sure that we make a huge step forward in Nix's user experience. And once 3.0 is out of the door we need to make sure that all future commands and features keep up the standard of user experience. This PR adds a CLI guideline document to the Nix documentation. Consider this document a good starting point and a checklist when somebody will be (re)implementing commands. Clearly this guideline does nothing to improve user experience on its own and can only be useful as long as it is going to be read and cared for. But it is a first step into that direction.	2020-12-02 17:00:32 +01:00
Fabian Möller	5b0790355f	Fix macOS sandbox build Since `c4c3c15c19` (#4251) building Nix for macOS with sandboxing fails: ``` getting status of /nix/var/nix/profiles/per-user/root/channels/nixpkgs: Operation not permitted ``` This happens, because `EvalSettings::getDefaultNixPath` tries to access paths outside the sandbox. Since the state-dir is not required for doc generation, it is set to the dummy folder. This needs to be done for all nix invocations during doc generation, as `EvalSettings::getDefaultNixPath` is called unconditionally.	2020-11-23 17:40:17 +01:00
mkenigs	8b15650e74	docs: consistent console prompt (#4213 ) Everywhere else a $ is used	2020-11-02 16:32:05 +01:00
Eelco Dolstra	a3a22bd804	Merge pull request #4202 from hercules-ci/nix-shell-doc Nix shell doc	2020-10-30 11:36:24 +01:00
Robert Hensing	d4c5d8d32a	nix-shell.md: Extend shellHook example	2020-10-30 11:12:28 +01:00
Robert Hensing	b809c48ebb	nix-shell.md: evaluated -> run Use "run" to avoid confusion with Nix evaluation. "evaluated" was intended to reference bash eval but it's ambiguous.	2020-10-30 11:01:33 +01:00
Eelco Dolstra	ff4dea63c9	Generalize extra-* settings This removes the extra-substituters and extra-sandbox-paths settings and instead makes every array setting extensible by setting "extra-<name> = <value>" in the configuration file or passing "--<name> <value>" on the command line.	2020-10-29 18:17:39 +01:00
tnias	c189cf7e33	Add sha512 to hashAlgo listings in manpages (#4186 )	2020-10-25 22:16:53 +00:00
Josef Kemetmüller	7f60f48e1a	Fix the docs about the new NIX_CONFIG env var This was accidentally documented as NIX_OPTIONS.	2020-10-21 17:04:36 +02:00
Eelco Dolstra	ecfebde6ff	Merge pull request #4166 from kampka/nix-conf-env Add NIX_CONFIG env var for applying nix.conf overrides	2020-10-21 14:26:45 +02:00
Eelco Dolstra	bdf2bcc989	Remove conf-file.xml This was probably revived in a bad merge.	2020-10-21 14:24:26 +02:00
Christian Kampka	461cf2b856	Add NIX_CONFIG env var for applying nix.conf overrides	2020-10-21 13:41:26 +02:00
Stefan Frijters	a53438d18f	doc: nix-shell in pure mode does not source user bashrc	2020-10-18 14:26:05 +02:00
Eelco Dolstra	58dadf2954	Remove stray 'Title:' from the manual Closes #4096.	2020-10-08 17:30:40 +02:00
Fabian Möller	4abd5554ad	Fix macOS sandbox build	2020-10-02 15:40:55 +02:00
Kevin Quick	66c3959e8c	Merge branch 'master' into access-tokens	2020-09-29 08:32:06 -07:00
Maximilian Bosch	3655875483	doc/manual: update hacking docs (#4078 ) * By default, build artifacts should be installed into `outputs/` rather than `inst/`[1]. * Add instructions on how to run unit-tests. [1] `733d2e9402`	2020-09-27 20:35:03 +00:00
Kevin Quick	83fec38fc9	Update document generation for empty json object values.	2020-09-24 22:41:24 -07:00
Bryan Richter	5fe375a8f1	nix-prefetch-url: Add --executable flag pkgs.fetchurl supports an executable argument, which is especially nice when downloading a large executable. This patch adds the same option to nix-prefetch-url. I have tested this to work on the simple case of prefetching a little executable: 1. nix-prefetch-url --executable https://my/little/script 2. Paste the hash into a pkgs.fetchurl-based package, script-pkg.nix 3. Delete the output from the store to avoid any misidentified artifacts 4. Realise the package script-pkg.nix 5. Run the executable I repeated the above while using --name, as well. I suspect --executable would have no meaningful effect if combined with --unpack, but I have not tried it.	2020-09-18 19:09:45 +03:00
Eelco Dolstra	0066ef6c59	Fix doc generation	2020-09-16 16:56:28 +02:00
Eelco Dolstra	39bc49318f	jq -> nix	2020-09-16 14:58:06 +02:00
Jade	7cb5f643a6	docs+test: fix remaining installer downloads without -L (#4006 ) Co-authored-by: lf- <lf-@users.noreply.github.com>	2020-09-12 22:08:40 +02:00
Vladimír Čunát	77d4758cf2	Merge #3982 : Minor docs updates	2020-09-07 21:54:59 +02:00
Eelco Dolstra	00d25e8457	Remove the --indirect flag All GC roots are now indirect.	2020-09-03 11:22:00 +02:00
Cole Helbling	a72ed3e8a1	hacking.md: add --prefix flag to configure Otherwise, the steps advertised in this document won't actually work (e.g. `make install` will fail, trying to access /usr, and `./inst/bin/nix` won't exist).	2020-09-01 12:06:02 -07:00
Eelco Dolstra	84f5cabbea	Merge remote-tracking branch 'origin/master' into markdown	2020-08-31 14:24:26 +02:00
Domen Kožar	8757e7022a	mention how to run a single functional test for faster feedback loop	2020-08-30 19:41:21 +02:00
Eelco Dolstra	691a1bd717	Merge branch 'minimal-logger' of https://github.com/Ma27/nix	2020-08-28 10:50:52 +02:00
Eelco Dolstra	7a02865b94	Move import docs	2020-08-25 14:06:01 +02:00
Eelco Dolstra	0f314f3c25	Generate builtins section of the manual	2020-08-24 14:49:30 +02:00
Eelco Dolstra	a990f063ff	Move primop docs inline This makes them available to 'nix repl'.	2020-08-24 14:31:10 +02:00
Eelco Dolstra	33b1679d75	Allow primops to have Markdown documentation	2020-08-24 13:16:02 +02:00
Eelco Dolstra	dc2f278c95	Allow 'nix' subcommands to provide docs in Markdown format	2020-08-20 12:21:46 +02:00
Eelco Dolstra	3c4f8c9175	List deprecated option aliases in the docs	2020-08-20 11:13:17 +02:00
Eelco Dolstra	c3e20d8c28	Consistency	2020-08-19 18:30:17 +02:00
Eelco Dolstra	c8fa39324a	Generate the nix.conf docs from the source code This means we don't have two (divergent) sets of option descriptions anymore.	2020-08-19 18:28:04 +02:00
Eelco Dolstra	8a97b11374	Improve margins between sections The default CSS puts almost no space between sections, but a lot of space between subsections. This flips that around.	2020-08-19 12:31:18 +02:00
Eelco Dolstra	069340179e	Improve nix.1 manpage generator	2020-08-18 15:15:35 +02:00
Eelco Dolstra	6f19c776db	Start generation of the nix.1 manpage	2020-08-17 19:33:18 +02:00
Eelco Dolstra	7cdc739ece	Merge remote-tracking branch 'origin/master' into markdown	2020-08-17 13:43:39 +02:00
Matthew Bauer	641c950701	Add hashed-mirrors back Some users have their own hashed-mirrors setup, that is used to mirror things in addition to what’s available on tarballs.nixos.org. Although this should be feasable to do with a Binary Cache, it’s not always easy, since you have to remember what "name" each of the tarballs has. Continuing to support hashed-mirrors is cheap, so it’s best to leave support in Nix. Note that NIX_HASHED_MIRRORS is also supported in Nixpkgs through fetchurl.nix. Note that this excludes tarballs.nixos.org from the default, as in \#3689. All of these are available on cache.nixos.org.	2020-08-06 18:19:09 -05:00
Eelco Dolstra	bf290c2306	Merge remote-tracking branch 'origin/master' into markdown	2020-07-31 16:07:04 +02:00
Eelco Dolstra	2ae9ac2369	console -> shell	2020-07-31 16:02:37 +02:00
Eelco Dolstra	1d0a7b54fa	Enable syntax highlighting	2020-07-31 15:43:25 +02:00
Matthew Bauer	05ac4db39a	Merge remote-tracking branch 'origin/master' into substitute-other-storedir	2020-07-30 12:38:24 -05:00
Maximilian Bosch	6ccfdb79c7	libutil/logging: extend `internal-json` logger to make it more machine-readable The new error-format is pretty nice from a UX point-of-view, however it's fairly hard to parse the output e.g. for editor plugins such as vim-ale[1] that use `nix-instantiate --parse` to determine syntax errors in Nix expression files. This patch extends the `internal-json` logger by adding the fields `line`, `column` and `file` to easily locate an error in a file and the field `raw_msg` which contains the error-message itself without code-lines and additional helpers. An exemplary output may look like this: ``` [nix-shell]$ ./inst/bin/nix-instantiate ~/test.nix --log-format minimal {"action":"msg","column":1,"file":"/home/ma27/test.nix","level":0,"line":4,"raw_msg":"syntax error, unexpected IF, expecting $end","msg":"<full error-msg with code-lines etc>"} ``` [1] https://github.com/dense-analysis/ale	2020-07-26 02:29:57 +02:00
Eelco Dolstra	1308c8404e	Remove DocBook manual	2020-07-24 15:48:40 +02:00
Eelco Dolstra	05a282295f	Fix internal links	2020-07-24 15:46:16 +02:00
Eelco Dolstra	da3d776cb9	Fix some dangling references	2020-07-24 14:31:33 +02:00
Eelco Dolstra	4a79b3598f	Fix nix-copy-closure manpage	2020-07-24 13:01:00 +02:00
Eelco Dolstra	7a0e6f076a	Move figures	2020-07-24 12:58:31 +02:00
Eelco Dolstra	758c9ee1bb	Clean up the manpages	2020-07-24 12:56:19 +02:00
Eelco Dolstra	8d0b311a1c	Get rid of footnotes Markdown doesn't support them.	2020-07-24 11:43:44 +02:00
Eelco Dolstra	69333cb62c	Sigh	2020-07-23 18:27:20 +02:00
Eelco Dolstra	802150f987	<replaceable> -> <emphasis> Pandoc doesn't know <replaceable> so let's force it to be rendered as italics.	2020-07-23 18:27:20 +02:00
Eelco Dolstra	ee05108472	<simplesect> -> <section> Pandoc silently ignores <simplesect>...	2020-07-23 18:27:20 +02:00
Eelco Dolstra	136fd55bb2	Get rid of <figure>	2020-07-23 18:27:20 +02:00
Eelco Dolstra	ca130b73a0	Get rid of <example> Markdown doesn't have floats so we can't have this.	2020-07-23 18:27:20 +02:00
Eelco Dolstra	13df1faf25	Get rid of callouts since Markdown doesn't support them	2020-07-23 18:27:20 +02:00
Eelco Dolstra	efff6cf163	Install all manpages	2020-07-23 18:27:12 +02:00
Eelco Dolstra	504b7abc45	Convert commands	2020-07-23 18:27:12 +02:00
Eelco Dolstra	efdb89994c	Convert nix.conf manpage	2020-07-23 18:27:11 +02:00
Eelco Dolstra	f390303566	Reconvert	2020-07-23 18:27:11 +02:00
Eelco Dolstra	c20c082383	<envar> -> <literal>	2020-07-23 18:27:11 +02:00
Eelco Dolstra	942cd687f9	Remove libxml2 / libxslt prerequisites	2020-07-23 18:26:48 +02:00
Eelco Dolstra	ef606760ab	Pandoc conversion	2020-07-23 18:26:48 +02:00
Eelco Dolstra	d004715665	Fix link	2020-07-23 18:26:48 +02:00
Eelco Dolstra	315407c16f	Remove subtitles	2020-07-23 18:26:48 +02:00
Eelco Dolstra	ebdc1f6dfb	Typo	2020-07-23 18:26:48 +02:00
Eelco Dolstra	8e41c38867	Remove references to xmllint	2020-07-23 18:26:48 +02:00
Eelco Dolstra	e0ea3c82ca	Use mdbook	2020-07-23 18:26:48 +02:00
Eelco Dolstra	650ae14ced	Markdown test	2020-07-23 18:26:48 +02:00
Eelco Dolstra	26fcab53e0	Remove unused file	2020-07-23 18:25:09 +02:00
Jörg Thalheim	6633605341	Update doc/manual/hacking.xml Co-authored-by: Eelco Dolstra <edolstra@gmail.com>	2020-07-20 22:30:39 +01:00
Jörg Thalheim	f0100f5590	README: improve development docs	2020-07-20 15:46:28 +01:00
Matthew Bauer	bcf8582091	Merge remote-tracking branch 'origin/master' into substitute-other-storedir	2020-06-24 12:52:09 -04:00
Jörg Thalheim	3685f4eec6	docs/installer: add correct curl flags also see https://nixos.org/download.html	2020-06-23 23:04:10 +01:00
Matthew Bauer	2796b01e86	Merge remote-tracking branch 'origin/master' into substitute-other-storedir	2020-06-19 14:22:06 -04:00
Eelco Dolstra	6c000eed80	Merge pull request #3709 from expipiplus1/master Mention number of derivations to be build/fetched in output	2020-06-18 19:03:05 +02:00
Samir Talwar	9069759767	Instruct the user to follow redirects when installing Nix. Nix installation now requires following redirects using `curl -L`. This is currently represented on the [Nix download page][] but not in the manual. This change updates the manual to reflect this. Using `curl` without the `-L` flag results in an empty body, making installation a no-op. [Nix download page]: https://nixos.org/download.html	2020-06-18 10:29:24 +02:00
Matthew Bauer	7bd88cc1dc	Merge remote-tracking branch 'origin/master' into substitute-other-storedir	2020-06-17 13:32:29 -04:00
Joe Hermaszewski	da8aac6ce8	Mention number of derivations to be build/fetched in output Also correct grammar for the case of a single derivation.	2020-06-17 20:27:27 +08:00
Matthew Bauer	3e3eaa90dd	Remove hashed-mirrors	2020-06-12 09:51:44 -05:00
zimbatm	2c4de6af10	add documentation	2020-06-08 09:31:15 +02:00
Joachim Breitner	e2af11ce07	Manpages: Do not refer to nixpkgs-channels Unless I am misinformed, using the `nixpkgs` repository directly is now preferred?	2020-05-23 15:26:59 +02:00
Domen Kožar	c129e7c8f4	Merge pull request #3212 from LnL7/darwin-10.15-install install: configure and bootstrap synthetic.conf on darwin	2020-05-23 11:15:31 +02:00
Travis A. Everett	2b0a81d92d	focus on golden-path covering most scenarios This should handle installation scenarios we can handle with anything resembling confidence. Goal is approximating the existing setup--not enforcing a best-practice... Approaches (+ installer-handled, - manual) and configs each covers: + no change needed; /nix OK on boot volume: All pre-Catalina (regardless of T2 or FileVault use) + create new unencrypted volume: Catalina, pre-T2, no FileVault + create new encrypted-at-rest volume: Catalina, pre-T2, FileVault Catalina, T2, no FileVault - require user to pre-create encrypted volume Catalina, T2, FileVault	2020-05-21 19:58:11 +02:00
Daiderd Jordan	477d7c2d07	installer: refuse apfs volume creation when FileVault is enabled	2020-05-21 19:58:11 +02:00
Daiderd Jordan	3386575296	manual: clarify volume creation section	2020-05-21 19:58:11 +02:00
Daiderd Jordan	04f597c3f4	install: improve output and error handling	2020-05-21 19:58:11 +02:00
Daiderd Jordan	ee89b7797d	manual: add apfs volume section	2020-05-21 19:58:11 +02:00
Krzysztof Gogolewski	c8cb558849	documentation: avoid unquoted URLs	2020-05-21 19:29:13 +02:00
Jörg Thalheim	e223eeac09	Remove -j option from simple-build-testing By default Nix/NixOS already set a reasonable default `max-jobs = auto` so we don't need to mention it in this tutorial. The option is still documented in other parts of the documentation if users ever stumble over this. Fixes https://github.com/NixOS/nix/issues/2531	2020-05-16 08:45:19 +01:00
Domen Kožar	23e5b48ca4	Merge pull request #3581 from TerrorJack/patch-1 Update "Upgrading Nix" documentation	2020-05-11 18:12:35 +02:00
Domen Kožar	612d57c5de	Merge pull request #3582 from bhipple/doc/fixed-output doc: consistently refer to 'fixed-output' with a dash	2020-05-11 18:10:19 +02:00
Benjamin Hipple	146f9c114f	doc: consistently refer to 'fixed-output' with a dash General cleanup that makes it easier to search for the term.	2020-05-09 10:58:43 -04:00
Shao Cheng	446649e540	Update "Upgrading Nix" documentation This PR proposes two changes to the "Upgrading Nix" documentation: * Besides updating `nixpkgs.nix`, we also update `nixpkgs.cacert`, so that the certificates are up-to-date as well. * Add the instructions for multi-user mode on Linux.	2020-05-09 15:59:39 +02:00
Dani	52cffafd24	Fix typo	2020-05-09 13:48:31 +02:00
Eelco Dolstra	41caaaad36	Manual: Typo	2020-05-07 16:37:33 +02:00
Eelco Dolstra	479e8bf00b	Manual: Fix typo	2020-05-07 16:08:15 +02:00
zimbatm	895516cadf	add NIX_USER_CONF_FILES Motivation: maintain project-level configuration files. Document the whole situation a bit better so that it corresponds to the implementation, and add NIX_USER_CONF_FILES that allows overriding which user files Nix will load during startup.	2020-04-14 18:45:06 +02:00
Eelco Dolstra	55cefd41d6	Merge branch 'fetchgit-recursive' of https://github.com/blitz/nix	2020-04-07 13:45:17 +02:00
Julian Stecklina	ea861be292	Add documentation for submodule support in fetchGit	2020-03-29 22:29:57 +02:00
Greg Price	e40e01c1dd	doc: Files in the store have modes 444/555, not 644/755 This line has been this way since it was written, in `9e08f5efe` in 2006. I think it was just a small mistake then; Eelco's thesis earlier that year says the permission on each file is set to 0444 or 0555 in a derivation's output as part of the build process. In any case I'm pretty sure that's the behavior now.	2020-03-23 20:23:27 -07:00
jakobrs	c5a488afc0	Remove the --delete option for --gc Running `nix-store --gc --delete` will, as of Nix 2.3.3, simply fail because the --delete option conflicts with the --delete operation. $ nix-store --gc --delete error: only one operation may be specified Try 'nix-store --help' for more information. Furthermore, it has been broken since at least Nix 0.16 (which was released sometime in 2010), which means that any scripts which depend on it should have been broken at least nine years ago. This commit simply formally removes the option. There should be no actual difference in behaviour as far as the user is concerned: it errors with the exact same error message. The manual has been edited to remove any references to the (now gone) --delete option. Other information: * Path for Nix 0.16 used: /nix/store/rp3sgmskn0p0pj1ia2qwd5al6f6pinz4-nix-0.16	2020-03-19 19:41:23 +01:00
Eelco Dolstra	779ef8f5ef	Merge pull request #3380 from contrun/no-attr-path-for-installed display attr-path only when queried available	2020-03-13 19:26:20 +01:00
YI	b6d794fb8d	display attr-path only when queried available	2020-03-14 00:36:26 +08:00
Eelco Dolstra	858ad7a4b3	Remove callout graphics Fixes #3396.	2020-03-13 16:32:43 +01:00
Eelco Dolstra	9c7e90f414	style.css: Remove 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.	2020-03-13 15:02:32 +01:00
Eelco Dolstra	e063c71a79	nixos.org/releases -> releases.nixos.org	2020-03-11 10:33:23 +01:00
Eelco Dolstra	2ba67da053	Merge pull request #3332 from Calvin-L/patch-1 Document that autoconf is a dependency	2020-02-19 13:02:35 +01:00
Eelco Dolstra	16e9a75287	Typo	2020-02-19 12:32:33 +01:00
Benjamin Hipple	762febafe2	doc: mention how to turn on pure evaluation mode in manual The flag is `--pure-eval`, which can be found by looking at the test suite; it should be in the notes describing the feature as well, since otherwise users may assume this is referencing something like `nix-shell --pure`.	2020-02-15 01:44:51 -05:00
Calvin Loncaric	46992e71a1	Document that autoconf is a dependency	2020-01-26 17:22:47 -08:00
Benjamin Hipple	5d24e18e29	doc: touchup release notes for 2.3 - 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.	2020-01-14 00:14:03 -05:00
Joe Pea	3895e78794	Add link to official channels in nix-channel command ref	2020-01-09 14:20:08 -08:00
Joe Pea	7ccfa7ca4f	Add a link to official channels in the Channels chapter.	2020-01-09 14:15:19 -08:00
Profpatsch	7923e22276	doc/manual: add ids to the advanced attribute definitions This makes it possible to reference single attribute definitions, for pointing people to their exact definition.	2019-12-03 18:22:27 +01:00
Profpatsch	7395e091c5	doc/manual: add note to `allowSubstitutes` advanced attribute	2019-12-03 18:01:45 +01:00
Eelco Dolstra	0be8d7784f	Typo	2019-11-26 20:33:46 +01:00
Eelco Dolstra	73efc1e8e7	Merge branch 'document-dry-run-option' of https://github.com/Ma27/nix	2019-11-26 20:32:50 +01:00
Arnout Engelen	4e70652ee3	Document builtins.placeholder	2019-11-25 18:00:05 +01:00
Niklas Hambüchen	07294e988c	manual: nix-shell: Elaborate on using `-p` with expressions. This documents the outcome of the change in https://github.com/NixOS/nix/issues/454: > We can also automatically add parentheses in the generated > `buildInputs`, so you can type `nix-shell -p "expr"` > instead of `"(expr").	2019-11-10 17:29:13 +01:00
Maximilian Bosch	52ffe2797a	doc: Document `--dry-run` option for `nix-build`	2019-11-07 00:11:57 +01:00
Eelco Dolstra	81a9b93689	Fix manual build	2019-11-05 11:21:32 +01:00
Eelco Dolstra	7876027071	Merge pull request #3193 from matthewbauer/patch-11 Update man to show that nix-shell allows --arg	2019-11-05 11:18:24 +01:00
Eelco Dolstra	78b8203e50	Merge pull request #3180 from kevinastock/patch-1 docs: fix upper bound on number of consumed cores	2019-11-05 11:17:02 +01:00
Eelco Dolstra	376802c9b8	Merge pull request #3199 from kevinastock/patch-2 docs: xref doesn't render in title	2019-11-05 11:16:15 +01:00
Kevin Stock	cea05e5ee7	docs: correct default location of log directory	2019-11-04 16:23:03 -05:00
Kevin Stock	808cb6444e	docs: xref doesn't render in title The `post-build-hook` text currently appears in the index, but not on the actual title line of the section, this follows the pattern used in a previous section to get a reference into a title.	2019-11-02 17:55:53 -04:00
Matthew Bauer	f1d4ba2afd	Update man to show that nix-shell allows --arg	2019-11-01 13:25:15 -04:00
Kevin Stock	99aac72a16	docs: fix upper bound on number of consumed cores	2019-10-30 16:53:04 -04:00
Eelco Dolstra	b421895c1e	Merge pull request #3161 from schlarpc/patch-1 Remove superfluous IAM action for S3 cache	2019-10-23 16:34:54 +02:00
Chaz Schlarp	c92ea927e5	Remove superfluous IAM action for S3 cache `s3:ListObjects` isn't a real IAM action, but _is_ the name of an S3 API method. `s3:ListBucket` is the relevant action for that method. https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazons3.html	2019-10-22 16:04:49 -07:00
Ersin Akinci	f107a27002	Tweak path hint	2019-10-21 14:16:55 -07:00
Ersin Akinci	b7a936224e	Add hint about path in builtins.import	2019-10-21 14:11:26 -07:00
Ersin Akinci	9be7787ec0	Revert "Document import <path> syntax" This reverts commit `d8730fb86f`.	2019-10-21 13:12:41 -07:00
Ersin Akinci	d8730fb86f	Document import <path> syntax	2019-10-20 19:08:05 -07:00
Eelco Dolstra	ab4dd1d783	Merge pull request #2291 from Taneb/master nix-channel documentation: don't suggest deprecated function	2019-10-17 12:53:42 +02:00
Danny Bautista	00a567588e	Fix typos in the Nix Manual.	2019-10-08 14:02:40 -04:00
Domen Kožar	043365c2fb	Merge pull request #3080 from Infinisil/tryEval-docs docs: Note that tryEval doesn't do deep evaluation	2019-09-30 14:03:16 +02:00
Joseph Lucas	10bfc5c0d0	Update garbage-collection.xml readability 1. remove a typo space 2. Simplify negative style by using affirmative style	2019-09-23 13:18:59 +00:00
Alexandre Esteves	9533d85ce0	Move 'builtins.splitVersion' to position respecting alphabetical order	2019-09-17 23:40:49 +01:00
Julien Tanguy	ae244af242	docs: Use the explicit ref for fetchGit with a tag With the merge of #2582, the syntax "tags/1.9" for refs does not work anymore. However, the new syntax "refs/tags/1.9" seems to support annotated tags, such as "refs/tags/2.0". Closes #2385.	2019-09-11 14:18:47 +02:00
Julien Tanguy	92ede15dd9	docs: Fix a typo in github in an example	2019-09-11 14:11:37 +02:00
Eelco Dolstra	252c78b288	Tweak release notes	2019-09-04 15:59:07 +02:00
Eelco Dolstra	b774845af7	Set release date	2019-09-04 12:53:22 +02:00
Silvan Mosberger	e4ea3e0306	docs: Note that tryEval doesn't do deep evaluation	2019-09-03 07:32:44 +02:00
Eelco Dolstra	8478c99d09	Merge pull request #3048 from toonn/nix-env_doc Fix nix-env documentation for --delete-generations	2019-08-29 15:22:01 +02:00
toonn	5bdac86be2	Reword to clarify newer generations are left alone 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-29 13:56:21 +02:00
Eelco Dolstra	787015fec0	Merge branch 'master' of github.com:NixOS/nix	2019-08-27 21:18:20 +02:00
Eelco Dolstra	fdff96501f	Update release notes	2019-08-27 21:18:00 +02:00
Eelco Dolstra	177e5742fa	Merge pull request #3056 from grahamc/operators operators: document exact precedence, split up similar operators	2019-08-27 17:12:36 +02:00
Eelco Dolstra	45b3dc325a	Add 2.3 release notes	2019-08-27 17:00:04 +02:00
Graham Christensen	171d784404	docs: operators: Make OR and AND capitalized	2019-08-27 06:55:22 -04:00
Graham Christensen	15ee2bc2fe	Merge pull request #2946 from vmandela/proxy installer: handle network proxy in systemd multi-user install	2019-08-24 14:55:19 -04:00
Graham Christensen	057af1dbd8	docs: document the installer's use of proxy env vars	2019-08-24 09:08:44 -04:00
Graham Christensen	92ddce4f46	operators: document exact precedenc, split up similar operators	2019-08-23 15:50:54 -04:00
Toon Nolten	1dbaf11948	Fix nix-env documentation for --delete-generations The documentation for `--delete-generations` had an erroneous fullstop and as it turns out inaccurate information on the `+No.` syntax.	2019-08-17 16:33:35 +02:00
Eelco Dolstra	b7ea98bf34	Merge pull request #2945 from danidiaz/doc001 Expanded documentation for .nix-defexpr	2019-08-15 15:03:21 +02:00
Eelco Dolstra	477f82e5a7	Merge pull request #2782 from grahamc/flames Track function start and end	2019-08-15 14:20:42 +02:00
Daniel Diaz	653c407784	Expanded documentation for .nix-defexpr	2019-08-15 08:05:22 -04:00
Graham Christensen	ee9c988a1b	Track function start and ends for flame graphs 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-14 16:09:35 -04:00
Graham Christensen	a02457db71	conf: stalled-download-timeout: make tunable 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-08 10:22:13 -04:00
Graham Christensen	1eeaf99cf8	fixup: docs for post-build-hook	2019-08-07 14:53:11 -04:00
Eelco Dolstra	56df30cd3f	Merge pull request #2995 from tweag/post-build-hook Add a post build hook	2019-08-07 15:02:29 +02:00
Graham Christensen	363a2f6826	post-build-hook: docs fixup	2019-08-06 14:26:43 -04:00
regnat	7c5596734f	Add a post-build-hook 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 10:48:15 -04:00
Eelco Dolstra	320126aeeb	Tweak min-free/max-free descriptions	2019-08-02 14:04:09 +02:00
Graham Christensen	cf6172f05e	docs: document balancing cores and max-jobs	2019-07-19 08:28:44 -04:00
Eelco Dolstra	b5ae85f088	Merge pull request #2882 from grahamc/docs/1115-tarball-ttl tarball-ttl: document	2019-07-06 00:15:27 +02:00
Graham Christensen	648bdf153d	tarball-ttl: document Incorporates text from Niklas Hambüchen in #2978 Closes #1115	2019-07-05 15:55:28 -04:00
Eelco Dolstra	7d6ba1dc90	Merge branch 'autoconf-ubuntu-16.04-fixes' of https://github.com/nh2/nix	2019-07-03 08:02:45 +02:00
Niklas Hambüchen	57daa860e8	autoconf: Fix C++17 detection not working on Ubuntu 16.04. 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 04:32:25 +02:00
Niklas Hambüchen	1f97b16b1d	autoconf: Work around editline not being found on Ubuntu 16.04. 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-03 04:32:25 +02:00
Eelco Dolstra	7e1c85c5fb	Merge pull request #2779 from LnL7/build-exit-codes build: add exit code for hash and check mismatches	2019-07-02 17:37:49 +02:00
Eelco Dolstra	7c0b0dbec8	Merge pull request #2724 from LnL7/manpage-add-fixed nix-store: document --add-fixed	2019-07-02 15:47:40 +02:00
Eelco Dolstra	33db1d35ae	Merge pull request #2582 from LnL7/fetchgit-refs fetchGit: allow fetching explicit refs	2019-07-02 15:44:31 +02:00
Daiderd Jordan	a3c77c1536	nix-store: document --add-fixed	2019-07-02 09:12:02 -04:00
Graham Christensen	c8205a3413	builtins.fetchGit: document absolute ref support	2019-07-02 09:05:56 -04:00
Daiderd Jordan	a52c331edb	build: replace 100 offset for build exit codes	2019-07-02 00:12:38 +02:00
Daiderd Jordan	1ac399dd11	nix-store: document exit codes	2019-07-02 00:12:38 +02:00
Eelco Dolstra	88571219d9	nix-channel: Don't fetch binary-cache-url This has been ignored since the Perl->C++ rewrite.	2019-06-25 13:27:16 +02:00
Bruno Bieth	74a65d313f	Nix uses the CPP SDK, not Java	2019-06-20 14:47:45 +02:00
JorisE	4b0d613383	Minor typo	2019-06-04 14:12:03 +02:00
Maximilian Bosch	b502b6682b	doc: clarify that optional attrs in a function argument will be ignored unless specified In `args@{ a ? 1 }: /* ... */` the value `a` won't be a part of `args` unless it's specified when calling the function, the default value will be ignored in this case. My personal point of view is that this behavior is a matter of taste, at least I was pretty sure that unmatched arguments will be a part of `args@` while debugging some Nix code last week. I decided to add a warning to the docs which hopefully reduces the confusion of further Nix developers who thought the same about `args@`.	2019-05-21 18:08:26 +02:00
Vladimír Čunát	c0559a1d60	docs: describe $IN_NIX_SHELL values (#2796 ) See commit `1bffd83e1a`	2019-05-17 09:50:42 +02:00
Graham Christensen	a5efe61786	Clarify where output from the diff hook goes.	2019-05-12 13:23:30 -04:00
Graham Christensen	6df61db060	diff hook: execute as the build user, and pass the temp dir	2019-05-12 13:17:26 -04:00
Graham Christensen	c78686e411	build: run diff-hook under --check and document diff-hook	2019-05-12 13:17:24 -04:00
Eelco Dolstra	71eb76a0d4	Merge pull request #2765 from nh2/manual-nixpkgs-word manual: "Nix Package collection" -> "Nixpkgs package collection".	2019-05-08 10:19:59 +02:00
Daniel Schaefer	3f192ac80c	Add builtins.hashFile For text files it is possible to do it like so: `builtins.hashString "sha256" (builtins.readFile /tmp/a)` but that doesn't work for binary files. With builtins.hashFile any kind of file can be conveniently hashed.	2019-05-03 17:23:36 +02:00
Niklas Hambüchen	288f93cec0	manual: "Nix Package collection" -> "Nixpkgs package collection". Makes difference between Nix and Nixpkgs clearer to avoid some common confusion this sentence on IRC. Also disambiguate an "it" reference.	2019-04-14 03:20:57 +02:00
Niklas Hambüchen	caa76c369a	docs: Mention `--max-jobs 0` to build remotely only	2019-03-31 03:57:45 +02:00
Dmitry Kalinkin	75ec68f93a	manual: mention the "channel:" shorthand for NIX_PATH Bumped to 15.09 because older channels, when downloaded from nixos.org, require firefox to be accessed via `pkgs.firefox`	2019-03-25 20:55:28 -04:00
zimbatm	514b3c7f83	Add isPath primop this is added for completeness' sake since all the other possible `builtins.typeOf` results have a corresponding `builtins.is<Type>`	2019-03-24 11:36:49 +01:00
Linus Heckemann	6f093073b6	manual: include builtins.* for globally available builtins This improves searchability.	2019-03-21 09:37:22 +01:00
Joachim Breitner	684c7fff80	Link to `builders-use-substitutes` in chapter on distributed builds fixes #2730.	2019-03-16 19:03:40 +01:00
Andreas Rammhold	34fade478a	docs: fix typo in AllowDirectReads It was just missing an `l` but should be fixed anyway.	2019-03-14 23:51:18 +01:00
Vladimír Čunát	4cfc131ec4	manual nitpick: document sha512 support in hashString	2019-03-01 14:30:30 +01:00
Spencer Baugh	5f1891b795	nix-store: make --dump-db take a list of paths to dump Inside a derivation, exportReferencesGraph already provides a way to dump the Nix database for a specific closure. On the command line, --dump-db gave us the same information, but only for the entire Nix database at once. With this change, one can now pass a list of paths to --dump-db to get the Nix database dumped for just those paths. (The user is responsible for ensuring this is a closure, like for --export). Among other things, this is useful for deploying a closure to a new host without using --import/--export; one can use tar to transfer the store paths, and --dump-db/--load-db to transfer the validity information. This is useful if the new host doesn't actually have Nix yet, and the closure that is being deployed itself contains Nix.	2019-01-23 01:24:34 +00:00
Domen Kožar	92d08c02c8	Merge pull request #2635 from veprbl/patch-7 manual: "sandbox" option default is "true" on Linux	2019-01-20 09:43:26 +07:00
Dmitry Kalinkin	15efd54373	manual: "sandbox" option default is "true" on Linux Fixes: `812e39313c` ('Enable sandboxing by default')	2019-01-19 15:04:43 -05:00
Samuel Evans-Powell	2ae5624b2f	Update instructions for Haskell script using nix-shell interpreter - The instructions for using nix-shell as an interpreter has a Haskell script example that doesn't work on more recent versions of Nix. Update the instructions with a working command	2019-01-18 10:50:54 +10:00
Eelco Dolstra	bbaf865655	Add 2.2 release notes	2019-01-10 21:02:09 +01:00
John Ericson	2733287046	Don't look for a "pv" program, or mention it in the manual source The manual reference was commented out, and the sole reference to this program other than the configure script. Removed both.	2019-01-07 16:40:19 -05:00
Patrick Hilhorst	567941fb59	Clarify nix-instantiate --read-write-mode	2018-12-14 09:36:40 +01:00
Eelco Dolstra	c37e6d77ea	Merge pull request #2569 from veprbl/pr/update_prerequisites docs: add missing prerequisites: brotli, boost, libseccomp	2018-12-13 10:42:02 +01:00
Dmitry Kalinkin	0cc4728f71	docs: raise minimal boost version to 1.66	2018-12-13 01:50:39 -05:00
Dmitry Kalinkin	419949bf61	docs: add missing prerequisites: brotli, boost, libseccomp	2018-12-10 12:37:15 -05:00
Daiderd Jordan	77cc632186	s3: document scheme query parameter	2018-12-08 00:15:00 +01:00
Eelco Dolstra	6c6bbeb439	Merge branch 'feature/editline-pr' of https://github.com/dtzWill/nix	2018-11-13 20:42:13 +01:00
Felix C. Stegerman	fb2c21f71c	manual: quote $servlets	2018-11-13 01:18:26 +01:00
Felix C. Stegerman	18215be59d	fix typo (s/gift/git/)	2018-11-12 17:50:39 +01:00
Eelco Dolstra	b05d6dac7b	Manual: build locally -> build	2018-11-09 16:08:36 +01:00
Eelco Dolstra	4ea4d0b1a3	Urgh	2018-11-09 10:29:16 +01:00
Linus Heckemann	34d2948f21	Fix manual build This was broken by some missing closing tags in `0bea4a50e0`	2018-11-08 14:07:19 +01:00
Eelco Dolstra	750400e0fa	Merge pull request #2524 from domenkozar/deprecate-toPath Deprecate builtins.toPath	2018-11-08 13:22:21 +01:00
Domen Kožar	0bea4a50e0	Deprecate builtins.toPath	2018-11-08 12:03:50 +00:00
Eelco Dolstra	812e39313c	Enable sandboxing by default Closes #179.	2018-11-07 17:08:28 +01:00
Eelco Dolstra	5a3f140856	Document allowSubstitutes	2018-11-07 11:42:22 +01:00
Eelco Dolstra	1109193ea3	Fix preferLocalBuild description preferLocalBuild does not in fact prevent substitution.	2018-11-07 11:37:43 +01:00
Will Dietz	3d974d31fa	editline: wip	2018-10-29 08:44:58 -05:00
Antoine Eiche	73c2ae43f0	Add --graphml option to the nix-store --query command This prints the references graph of the store paths in the graphML format [1]. The graphML format is supported by several graph tools such as the Python Networkx library or the Apache Thinkerpop project. [1] http://graphml.graphdrawing.org	2018-10-20 09:48:34 +02:00
Benjamin Hipple	65453e2d77	Docs: update fixed output hashes `fetchurl` will now throw if given an `md5`, and the hashes have generally been upgraded to avoid it and use `sha256` as a default. This updates the documentation examples in the manual accordingly.	2018-10-04 02:37:15 +00:00
Profpatsch	05cfc71cab	manual: add XML IDs to all builtin list entries	2018-10-02 15:38:16 +02:00
Eelco Dolstra	aa5e47b2f4	Merge pull request #2456 from grahamc/s3-substituters Update docs to describe how s3:// URLS does in fact support endpoint, region, and profile for upload	2018-10-01 22:47:00 +02:00
Eelco Dolstra	5b7cfa487e	Add missing file	2018-10-01 11:58:54 +02:00
Eelco Dolstra	1e7b8deea7	Check requiredSystemFeatures for local builds For example, this prevents a "kvm" build on machines that don't have KVM. Fixes #2012.	2018-09-28 16:10:27 +02:00
Graham Christensen	51cbeec49a	Update docs to describe how s3:// URLS does in fact support endpoint, region, and profile for upload	2018-09-27 17:01:39 -04:00
Eelco Dolstra	a48c2e3411	Merge pull request #2434 from grahamc/graham-improve-upgrade Upgrade docs: improve the upgrade command	2018-09-19 21:53:50 +02:00
Anders Riutta	1915862767	Upgrade docs: improve the upgrade command and make it more copy-pastable.	2018-09-19 14:17:06 -04:00
Graham Christensen	be9e356e61	nix-shell: document double quotes being necessary for a simple Nix expression in the shebang	2018-09-19 13:01:27 -04:00
Graham Christensen	10a7f19937	nix-shell: explain the merging property close to the example	2018-09-19 12:48:08 -04:00
Graham Christensen	0cd863197b	docs: document deprecated aliases	2018-09-18 12:23:32 -04:00
Graham Christensen	0aca1ffb6e	Prefer 'remote builder' over 'slave'	2018-09-10 18:57:46 +02:00
Vladimír Čunát	5f3b72cfc2	docs: change expired bzip2.org to archive.org Fixes #2396.	2018-09-03 17:57:13 +02:00
Eelco Dolstra	4dd09210d7	Release notes tweaks	2018-09-02 21:47:10 +02:00
Eelco Dolstra	1f49926601	Merge pull request #2388 from grahamc/graham/document-multi-user Document multi-user installation, and add release notes about it not being the default on 2.1	2018-09-01 22:43:48 +02:00
Graham Christensen	c42eaaf684	Create upgrade notes	2018-09-01 15:35:46 -04:00
Eelco Dolstra	c5ab07ec2b	Merge pull request #2168 from grahamc/explain-why-netrc-is-busted manual: document why ~/.netrc doesn't work	2018-09-01 21:25:04 +02:00
Eelco Dolstra	51003f892d	Merge pull request #2309 from symphorien/disallowed-man add manual entries for disallowedRequisites and disallowedReferences	2018-09-01 21:01:41 +02:00
Eelco Dolstra	291f67aecf	Merge pull request #2237 from nh2/patch-1 manual: distributed-builds: Mention - as default	2018-09-01 20:41:49 +02:00
Graham Christensen	4be7652dd3	release notes: note that the multi-user installer is available but not selected for Linux with systemd, and the bug about selinux	2018-09-01 10:45:57 -04:00
Graham Christensen	c3e508d924	Document the multi-user installer some Use sh <(...) syntax for installation to preserve stdin and prompting also update installation docs to account for changes in multi-user selection	2018-09-01 10:45:50 -04:00
Graham Christensen	f66fa7cd20	We support aarch64 now	2018-09-01 10:44:33 -04:00
Eelco Dolstra	6ed4a6bd0e	Merge pull request #2384 from graham-at-target/fetch-git-examples docs: Add some examples to fetchGit	2018-09-01 14:08:32 +02:00
Graham Christensen	0b7568fb73	Drop ssh://... as a required formatting for builtins.fetchGit	2018-08-31 19:49:56 -04:00
Eelco Dolstra	4095cd6438	Add contributors	2018-09-01 00:01:05 +02:00
Graham Christensen	149d10c308	docs: Add IDs to important sections	2018-08-31 10:06:33 -04:00
Graham Christensen	2df21b78b9	docs: Add some examples to fetchGit	2018-08-31 10:00:32 -04:00
Eelco Dolstra	308689f94b	Merge pull request #2365 from erikarvstedt/fix-docs Docs: Fix install prefix	2018-08-30 16:24:52 +02:00
Eelco Dolstra	64d7d1a884	Update release notes	2018-08-30 15:28:18 +02:00
Domen Kožar	d16ff76c69	nix.conf: clarify -j0 doesn't affect preferLocalBuild	2018-08-29 14:33:14 +01:00
Domen Kožar	54df4bb0b5	nix.conf: mention -j0 is useful	2018-08-29 11:51:51 +01:00
Erik Arvstedt	8ad2defdf0	Docs: Fix install prefix shell.nix defines the install prefix as $(pwd)/inst	2018-08-21 21:46:43 +02:00
Graham Christensen	06080e4abc	2.1 release notes: Add note about s3-compatible stores	2018-08-03 11:09:31 -04:00
Eelco Dolstra	87356cc8a4	Add Nix 2.1 release notes	2018-08-03 17:05:17 +02:00
Eelco Dolstra	122e1a61f8	Merge pull request #2323 from samueldr/feature/selective-impurity Allows selectively adding environment variables to pure shells.	2018-08-03 16:58:18 +02:00
Samuel Dionne-Riel	438e02529d	Allows selectively adding environment variables to pure shells. Includes documentation and test.	2018-08-02 08:21:30 -04:00
Graham Christensen	49a53c1d3f	s3 binary cache: support specifying an endpoint Works for uploading and not downloading.	2018-08-02 08:19:50 -04:00
Graham Christensen	b27431b7cb	Document s3 substitutions	2018-08-01 11:07:41 -04:00
Symphorien Gibol	81d1385437	add manual entries for disallowedRequisites and disallowedReferences	2018-07-26 18:14:50 +02:00
Nathan van Doorn	41f38fbb4b	nix-channel documentation: don't suggest deprecated function Running `nix-instantiate --eval -E '(import <nixpkgs> {}).lib.nixpkgsVersion` emits a warning ``` trace: `lib.nixpkgsVersion` is deprecated, use `lib.version` instead! ```	2018-07-16 10:00:42 +01:00
Niklas Hambüchen	10ebcf8670	manual: distributed-builds: Mention - as default	2018-06-17 19:01:07 +02:00
Michael Raskin	17bc757980	manual: builtins.fromJSON: remove the claim that floats are not allowed floating-point numbers are supported now, including the fromJSON builtin. Reported on IRC by inquisitiv3	2018-06-10 14:20:18 +02:00
Peter Simons	93aa3bea2e	Merge pull request #767 from mogorman/garbage_collect_keep_last_few Implement --delete-generations + flag for keeping last N number of gens	2018-05-31 10:00:21 +02:00
Shea Levy	bbbfc180d9	Explicitly describe the effects of filterSource excluding a directory.	2018-05-30 12:34:41 -04:00
Graham Christensen	f9940f47b3	Merge pull request #2164 from mickours/doc-fetchTarball-timout Explain fetchTarball timeout behavior in the doc	2018-05-30 08:04:26 -04:00
Michael Mercier	8dd2e28374	Explain fetchTarball timeout behavior in the doc	2018-05-30 08:02:46 -04:00
Graham Christensen	e6466c20b3	Document NIX_SSL_CERT_FILE for installation	2018-05-25 15:59:14 -04:00
Eelco Dolstra	743359bc8a	Merge pull request #2157 from volth/bitwise add builtins: __bitAnd, __bitOr, __bitXor	2018-05-24 15:00:39 +02:00
volth	88c1ea30e4	add docs and tests	2018-05-24 12:51:34 +00:00
Alexandre Esteves	579f3895b4	Fix docs on --check suffix	2018-05-23 22:26:06 +01:00
Graham Christensen	33712fed38	manual: document why ~/.netrc doesn't work Maybe there is a better place to document this, which is more generic?	2018-05-18 14:21:47 -04:00
Gleb Peregud	5ba6395378	docs: mention source of env variables used by `impureEnvVars`.	2018-05-02 22:45:20 +02:00
Danylo Hlynskyi	ac22d77fd1	nix-collect-garbage: little doc fix This removes confusing documentation. It's better to remove doc than add implementation, because Nix 1.12 will surely have new GC interface anyway. Fixes https://github.com/NixOS/nix/issues/641	2018-04-30 09:36:46 -07:00
Shea Levy	8e6108ff71	Merge branch 'aarch64-armv7' of git://github.com/lheckemann/nix Support extra compatible architectures (#1916)	2018-04-23 08:48:22 -04:00
Samuel Dionne-Riel	4b3a7f93a5	doc: Adds `--quiet` to the common options. Fixes #1298	2018-04-20 16:34:06 -04:00
Eelco Dolstra	4fd28bee89	Fix broken DocBook	2018-04-13 15:12:58 +02:00
Sean Seefried	2ef8f0608c	Add to glossary and clarify garbage collection While trying to understand garbage collection it was not immediately clear that only the runtime dependency closure of output paths would be kept (instead of the build-time dependency closure). This commit attempts to clarify this by expanding some of the glossary definitions and extending the Garbage Collection section.	2018-04-12 19:23:24 +10:00
John Arnold	a405d25fa3	manual: Add all dependencies to source prerequisites (#2060 )	2018-04-09 17:31:39 -04:00
Nicolas Dudebout	d8a1c27806	fix typo in nix-env man page	2018-04-07 21:10:46 -04:00
AmineChikhaoui	e01b01c579	update/re-order the options docs	2018-04-06 11:09:52 +01:00
AmineChikhaoui	33b08899d5	re-order the options using the alphabetical order and improve the example in the positive lookup case	2018-04-06 10:51:19 +01:00
AmineChikhaoui	86930ed414	add documentation for the local disk cache TTL config	2018-04-06 10:51:18 +01:00
Justin Humm	045eb84409	document that writeTextFile from Nixpkgs is an alternative to builtins.toFile	2018-04-03 23:26:47 +02:00
Eelco Dolstra	e01c01f72c	Merge pull request #2005 from shlevy/fetchgit-docs Document fetchGit.	2018-03-27 15:57:48 +02:00
Shea Levy	6856fe62b0	Document fetchGit. Fixes #1981.	2018-03-23 07:02:45 -04:00
Dmitry Kalinkin	e2f56c1333	doc: don't mention obsolete ssh-substituter-hosts #1840	2018-03-22 19:17:45 -04:00
Corey O'Connor	22b144fea6	manual: correct repeated "--deriver". Add missing single char option aliases.	2018-03-20 17:58:25 -07:00
Eelco Dolstra	b2074f0892	Fix bad XML	2018-03-18 13:27:30 +01:00
zimbatm	43bef1b82c	doc: document the min-free and max-free options	2018-03-17 21:29:03 +00:00
zimbatm	fef8ebf51d	doc: add xml:id to all the config options	2018-03-17 21:17:28 +00:00
Linus Heckemann	637701b604	rename build-extra-platforms -> extra-platforms also document it	2018-03-16 22:50:27 +00:00
Matthew O'Gorman	467fdd8ca4	only delete things older than current gen and update logic in doc as well	2018-03-01 22:59:00 -05:00
Matthew O'Gorman	429154b74c	Implement --delete-generations + flag for keeping last N number of generations	2018-03-01 21:47:57 -05:00
Michael Fiano	ad97d1a786	nix-channel grammar and punctuation Minor changes to the nix-channel manpage for my first contribution	2018-03-01 00:27:25 -05:00
Graham Christensen	9432f3fb7d	Merge pull request #1901 from veprbl/patch-5 Fix a small typo in the release notes	2018-02-24 10:26:14 -05:00
Michael Weiss	bd94e63853	doc: Fix a URL in the release notes for Nix 2.0	2018-02-24 16:07:10 +01:00
Dmitry Kalinkin	d9d8a84a96	Fix a small typo in the release notes	2018-02-23 23:45:42 -05:00
Eelco Dolstra	39b4177500	Fix example in release notes	2018-02-22 17:42:06 +01:00
Eelco Dolstra	2691d51a33	Doh	2018-02-22 17:14:35 +01:00
Eelco Dolstra	e8d53bfdc9	Revert "Enable sandbox builds on Linux by default" This reverts commit `ddc58e7896`. https://hydra.nixos.org/eval/1435322	2018-02-22 14:20:07 +01:00
Eelco Dolstra	eaa52c34b4	Set release date	2018-02-22 12:44:46 +01:00
Eelco Dolstra	ddc58e7896	Enable sandbox builds on Linux by default The overhead of sandbox builds is a problem on NixOS (since building a NixOS configuration involves a lot of small derivations) but not for typical non-NixOS use cases. So outside of NixOS we can enable it. Issue #179.	2018-02-22 12:27:25 +01:00
Eelco Dolstra	88c90d5e6d	Manual: Put configuration options in sorted order	2018-02-21 18:08:47 +01:00
Eelco Dolstra	0d54671b7b	Manual: Update chapter on remote builds Alos add a command "nix ping-store" to make it easier to see if Nix can connect to a remote builder (e.g. 'nix ping-store --store ssh://mac').	2018-02-21 16:24:26 +01:00
Eelco Dolstra	4e44025ac5	Release notes: Add contributors	2018-02-20 15:20:14 +01:00
Eelco Dolstra	d7fdfe322b	Remove macOS multi-user instructions This is already handled by the installer.	2018-02-19 20:40:25 +01:00
Eelco Dolstra	70eb64147e	Update release notes Also add some examples to nix --help.	2018-02-19 20:38:53 +01:00
Eelco Dolstra	75a1d96cfd	Merge branch 'register-settings' of https://github.com/shlevy/nix	2018-02-19 13:58:34 +01:00
Shea Levy	b095c06139	Add splitVersion primop. Fixes #1868.	2018-02-14 09:55:43 -05:00
Shea Levy	de4934ab3b	Allow plugins to define new settings.	2018-02-13 14:43:32 -05:00
Eelco Dolstra	52c777a793	Merge pull request #1863 from shlevy/conf-includes Allow includes from nix.conf	2018-02-13 17:33:07 +01:00
Shea Levy	b8739f2fb3	Enable specifying directories in plugin-files.	2018-02-13 11:25:01 -05:00
Shea Levy	6eb1040e90	Allow includes from nix.conf	2018-02-13 08:16:32 -05:00
Shea Levy	081f14a169	Allow using RegisterPrimop to define constants. This enables plugins to add new constants, as well as new primops.	2018-02-08 14:35:50 -05:00
Shea Levy	88cd2d41ac	Add plugins to make Nix more extensible. All plugins in plugin-files will be dlopened, allowing them to statically construct instances of the various Register* types Nix supports.	2018-02-08 12:44:37 -05:00
Eelco Dolstra	abe6be578b	Merge pull request #1816 from shlevy/add-path Add path primop.	2018-02-07 13:32:35 +01:00
Shea Levy	69d82e5c58	Add path primop. builtins.path allows specifying the name of a path (which makes paths with store-illegal names now addable), allows adding paths with flat instead of recursive hashes, allows specifying a filter (so is a generalization of filterSource), and allows specifying an expected hash (enabling safe path adding in pure mode).	2018-02-06 16:48:08 -05:00
Eelco Dolstra	84722d67d2	Remove nix-build --hash Instead, if a fixed-output derivation produces has an incorrect output hash, we now unconditionally move the outputs to the path corresponding with the actual hash and register it as valid. Thus, after correcting the hash in the Nix expression (e.g. in a fetchurl call), the fixed-output derivation doesn't have to be built again. It would still be good to have a command for reporting the actual hash of a fixed-output derivation (instead of throwing an error), but "nix-build --hash" didn't do that.	2018-02-03 10:08:05 +01:00
Shea Levy	de96daf54f	Merge branch 'master' of git://github.com/catern/nix	2018-02-01 13:21:45 -05:00
Eelco Dolstra	e7b23eb5ab	Remove docs on removed --drv-link and --add-drv-link options	2018-02-01 16:40:58 +01:00
Spencer Baugh	e5432574e2	document ability to set NIX_REMOTE=unix://path/to/socket	2018-01-31 22:47:16 +00:00
Eelco Dolstra	c287d73121	Rename 1.12 -> 2.0 Following discussion with Shea and Graham. It's a big enough change from the last release. Also, from a semver perspective, 2.0 makes more sense because we did remove some interfaces (like nix-pull/nix-push).	2018-01-31 18:58:45 +01:00
Eelco Dolstra	6fa690291a	Add 'nix upgrade-nix' command This command upgrades Nix to the latest stable version by installing a store path obtained from https://github.com/NixOS/nixpkgs/raw/master/nixos/modules/installer/tools/nix-fallback-paths.nix which is the same store path that the installer at https://nixos.org/nix/install.sh uses. The upgrade fails if Nix is not installed in a profile (e.g. on NixOS, or when installed outside of the Nix store).	2018-01-31 16:24:43 +01:00
Eelco Dolstra	f8e8dd827e	Manual: Remove old cruft	2018-01-31 15:08:46 +01:00
Eric Wolf	0167eac571	Improve manual on inheriting attributes Expands first paragraph a bit Adds a more comprehensive example	2018-01-27 16:18:31 +01:00
Eelco Dolstra	cfeff3b273	Move show-trace docs	2018-01-17 11:53:16 +01:00
Renzo Carbonara	b0328c244d	nix.conf: builders-use-substitutes Fixes #937	2018-01-09 22:40:07 +01:00
Eelco Dolstra	44272d8719	Rename "use-substitutes" to "substitute" Commit `c2154d4c84` renamed "build-use-substitutes" to "use-substitutes", but that broke "nix-copy-closure --use-substitutes".	2018-01-04 16:58:39 +01:00
Eelco Dolstra	e3c19ff9bc	Merge pull request #1725 from chris-martin/pr/concatStringsSep Add builtins.concatStringSep to the manual	2017-12-12 11:46:10 +01:00
Chris Martin	2a8f09a8c1	Add builtins.concatStringSep to the manual	2017-12-11 14:28:03 -05:00
Eelco Dolstra	06d4566c2d	Merge pull request #1721 from expipiplus1/patch-2 Escape left angle brackets in XML documentation	2017-12-11 17:29:36 +01:00
Shea Levy	5ba5ca7888	Merge branch 'feature/linenoise-ng' of git://github.com/dtzWill/nix	2017-12-11 07:52:20 -05:00
Joe Hermaszewski	35a49f1d7f	Escape left angle brackets in XML documentation	2017-12-09 15:31:03 +00:00
Markus Hauck	0af668426d	nix-hash: Add sentence and example for nix-prefetch-url hash	2017-12-08 10:27:34 +01:00
Will Dietz	e50d7335bf	doc: linenoise -> linenoise-ng	2017-11-27 18:36:20 -06:00
Eelco Dolstra	7536fe31dd	Add a warning about the 'trusted-users' option	2017-11-21 18:49:52 +01:00
Eelco Dolstra	8df60b4ea8	Document secret-key-files	2017-11-20 18:51:04 +01:00
Eelco Dolstra	91a1987607	signed-binary-caches -> require-sigs Unlike signed-binary-caches (which could only be '*' or ''), require-sigs is a proper Boolean option. The default is true.	2017-11-20 17:44:07 +01:00
Eelco Dolstra	7a2b64e55c	binary-cache-public-keys -> trusted-public-keys The name had become a misnomer since it's not only for substitution from binary caches, but when adding/copying any (non-content-addressed) path to a store.	2017-11-20 17:32:34 +01:00
Eelco Dolstra	6cf7c6a6b0	Remove git:// support in NIX_PATH This didn't support specifying a revision/branch, and was restricted to git:// URIs (since https:// or ssh:// would be ambiguous).	2017-11-03 13:55:31 +01:00
Zoran Plesivčak	ae506c1ea4	Mention isFloat function in "Built-in Functions" section	2017-11-01 23:00:08 +00:00
Zoran Plesivčak	3050395810	Mention "float" type in builtins.typeOf section of the docs + remove trailing whitespace from the file	2017-11-01 21:36:25 +00:00
Eelco Dolstra	812e027e1d	Add option allowed-uris This allows network access in restricted eval mode.	2017-10-30 12:41:49 +01:00
Eelco Dolstra	f1c555cef8	fetchurl/fetchTarball are not allowed in restricted mode Accidentally committed this change as part of `f9686885be`. Restricted mode != pure mode.	2017-10-30 12:41:48 +01:00
Domen Kožar	5cb78053f0	Merge pull request #1633 from orivej/doc Update the language documentation	2017-10-30 12:21:54 +01:00
Eelco Dolstra	049322702b	fetchgit -> fetchGit Almost all other primops are camelCase so no reason not to use that here.	2017-10-30 10:25:08 +01:00
Orivej Desh	842ce8bafd	Clarify indented string escaping rules	2017-10-26 18:53:36 +00:00
Orivej Desh	15457c5673	Describe "with" scoping precedence	2017-10-26 18:53:36 +00:00
Orivej Desh	e5c499b833	Describe arithmetic operators	2017-10-26 18:53:35 +00:00
Eelco Dolstra	38dcd0c4b8	Release note updates	2017-10-23 20:50:28 +02:00
Keshav Kini	32940702fc	Mention C++14 dependency in the manual. A couple makefiles in the sources have -std=c++14 in the CFLAGS.	2017-10-19 18:03:26 -07:00
Eelco Dolstra	5324bb9399	Update release notes	2017-09-18 11:07:17 +02:00
Eelco Dolstra	0b606aad46	Add automatic garbage collection Nix can now automatically run the garbage collector during builds or while adding paths to the store. The option "min-free = <bytes>" specifies that Nix should run the garbage collector whenever free space in the Nix store drops below <bytes>. It will then delete garbage until "max-free" bytes are available. Garbage collection during builds is asynchronous; running builds are not paused and new builds are not blocked. However, there also is a synchronous GC run prior to the first build/substitution. Currently, no old GC roots are deleted (as in "nix-collect-garbage -d").	2017-09-05 20:43:42 +02:00
Eelco Dolstra	c2154d4c84	Rename a few configuration options In particular, drop the "build-" and "gc-" prefixes which are pointless. So now you can say nix build --no-sandbox instead of nix build --no-build-use-sandbox	2017-08-31 14:28:25 +02:00
Matthew Bauer	2c75945de5	Remove nix-mode.el from Nix. This removes the file nix-mode.el from Nix. The file is now available within the repository https://github.com/NixOS/nix-mode. Fixes #662 Fixes #1040 Fixes #1054 Fixes #1055 Closes #1119 Fixes #1419 NOTE: all of the above should be fixed within NixOS/nix-mode. If one of those hasn’t please reopen within NixOS/nix-mode and not within NixOS/nix.	2017-08-19 21:16:30 -07:00
Chase Adams	09a38f9125	update MD5 to SHA-256 in expression-syntax	2017-08-18 16:07:33 -07:00
Eelco Dolstra	e2f9a61dc9	Update release notes	2017-08-16 21:36:47 +02:00
Eelco Dolstra	2ee1b9359b	Merge branch 'tokenize' of https://github.com/nbp/nix	2017-08-16 21:21:36 +02:00
Nicolas B. Pierron	b8867a0239	Add builtins.string function. The function 'builtins.split' takes a POSIX extended regular expression and an arbitrary string. It returns a list of non-matching substring interleaved by lists of matched groups of the regular expression. ```nix with builtins; assert split "(a)b" "abc" == [ "" [ "a" ] "c" ]; assert split "([ac])" "abc" == [ "" [ "a" ] "b" [ "c" ] "" ]; assert split "(a)\|(c)" "abc" == [ "" [ "a" null ] "b" [ null "c" ] "" ]; assert split "([[:upper:]]+)" " FOO " == [ " " [ "FOO" ] " " ]; ```	2017-08-15 20:04:11 +00:00
Nicolas B. Pierron	27417c6160	Move builtins.match documentation between map and mul.	2017-08-15 18:34:24 +00:00
Eelco Dolstra	f76e85d8f5	Start of 1.12 release notes	2017-08-10 18:44:45 +02:00
davidak	92bcb61127	replace "Mac OS X" with "macOS" except in older release notes where the name was actually Mac OS X.	2017-07-30 12:26:17 +02:00
Graham Christensen	da2ad30054	Update the mailing list.	2017-07-18 08:02:53 -04:00

... 14 15 16 17 18 ...

2278 commits