1514 commits

Author	SHA1	Message	Date
Valentin Gagarin	b5728ace5d	add articles	2022-11-09 01:29:01 +01:00
Valentin Gagarin	be8744f937	manual: architecture overview ... these changes were not merged properly and had to be reverted. see merge commit d8e54d19f7 for full history leading up to here.	2022-11-09 01:29:01 +01:00
Valentin Gagarin	f7ab93b068	manual: build action -> build task ... after discussing this with multiple people, I'm convinced that "build task" is more precise: a derivation is not an action, but inert until it is built. also it's easier to pronounce. proposal: use "build task" for the generic concept "description of how to derive new files from the contents of existing files". then it will be easier to distinguish what we mean by "derivation" (a specific data structure and Nix language value type) and "store derivation" (a serialisation of a derivation into a file in the Nix store).	2022-11-06 13:28:18 +01:00
Théophane Hufschmitt	74cc24f4cf	Merge pull request #7191 from jherland/antiquoted-paths ... Explain how Nix handles antiquotation of paths	2022-10-26 12:42:59 +02:00
Patrick Jackson	b44df13701	manual: update options generation code to use default values	2022-10-20 12:05:04 -07:00
Johan Herland	1ec8810687	Explain how Nix handles antiquotation of paths ... Specifically, explain why Nix does not _re_evaluate paths during a `nix repl` session. This is a thing that bit me while playing around with paths and antiquotation in `nix repl` while reading the Nix language tutorial at https://nix.dev/tutorials/nix-language. Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-10-19 11:50:58 +02:00
Ana Hobden	069409d167	Print common flags in --help	2022-10-07 09:07:22 -07:00
Valentin Gagarin	ac0fb38e8a	Merge pull request #6652 from abathur/doc_install_tests	2022-10-05 17:45:42 +02:00
Travis A. Everett	e1418430ac	Apply suggestions from code review ... Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-10-05 09:52:53 -05:00
Valentin Gagarin	927234cfb2	Merge pull request #6870 from amjoseph-nixpkgs/pr/doc/explain-local-remote-binary-substituter	2022-10-05 09:01:42 +02:00
Théophane Hufschmitt	3ae9467d57	Merge pull request #6969 from fricklerhandwerk/refactor-generate-manpage ... refactor rendering command documentation to markdown	2022-10-03 15:50:17 +02:00
Valentin Gagarin	d8bef7358f	bring back lost newline	2022-09-30 01:43:57 +02:00
Valentin Gagarin	70eea97742	use more self-explanatory names	2022-09-30 01:43:57 +02:00
Valentin Gagarin	61188cb820	move final template to the top ... this allows readers to enter the code starting with what is visible from the outside, instead of working themselves up from purely technical details.	2022-09-30 01:43:57 +02:00
Valentin Gagarin	0e0f1832de	remove superfluous let-in pair	2022-09-30 01:43:57 +02:00
Valentin Gagarin	a85df04fcb	refactor showOptions ... it was quite a pain to manipulate strings just with `builtins`	2022-09-30 01:43:53 +02:00
Valentin Gagarin	4655563470	refactor rendering command documentation to markdown ... idea: - make document structure visible, like in a template - order functions by descending abstraction - avoid nested let bindings	2022-09-30 01:42:46 +02:00
Valentin Gagarin	6b56bb4a79	use indented strings where appropriate	2022-09-30 01:42:46 +02:00
Solene Rapenne	847cd49909	nix-copy-closure: improve wording	2022-09-28 01:05:46 +02:00
Théophane Hufschmitt	6a64820cb4	Merge pull request #7082 from rapenne-s/ccache ... add ccacheStdenv	2022-09-24 12:45:27 +02:00
Solène Rapenne	e04b38f789	add ccacheStdenv ... when using ccache, rebuild time has been measured 89% faster while not slowing the speed of cold builds	2022-09-23 11:21:19 +02:00
Travis A. Everett	84bdb0e3ad	address review feedback ... Mainly: - Try to triangulate between narrative that framed this as a new/easy process and the need for a reference that will not quickly grow stale. - Fix a ~continuity issue where the text was talking about "your Cachix cache" before saying that you'd need to make a Cachix cache to enable the installer tests. - Adopt suggestion on titling, and nest subtitles in the installer test section.	2022-09-18 13:02:42 -05:00
Travis A. Everett	4bd52bf6c4	Apply suggestions from code review ... Co-authored-by: Valentin Gagarin <valentin.gagarin@tweag.io>	2022-09-17 13:20:11 -05:00
Adam Joseph	ad5b09423a	release-notes/rl-next.md: note new argument to fetchurl.nix	2022-09-16 01:59:24 -07:00
Valentin Gagarin	dc8c0b173c	Update doc/manual/src/contributing/hacking.md	2022-09-16 09:36:55 +02:00
Valentin Gagarin	1ae974120a	Update doc/manual/src/contributing/hacking.md	2022-09-16 09:36:37 +02:00
Valentin Gagarin	0a4bd9fe88	Update doc/manual/src/contributing/hacking.md	2022-09-16 09:36:30 +02:00
Valentin Gagarin	47fa1087c8	Update doc/manual/src/contributing/hacking.md	2022-09-16 09:36:20 +02:00
Valentin Gagarin	1d295e5fe7	Merge pull request #6934 from fricklerhandwerk/revert-architecture ... Revert #6420 "Document what Nix *is*" so we can start over with smaller change sets	2022-09-09 13:31:05 +02:00
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
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