nix-gh/doc/manual
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
..
advanced-topics diff hook: execute as the build user, and pass the temp dir 2019-05-12 13:17:26 -04:00
command-ref docs: describe $IN_NIX_SHELL values (#2796) 2019-05-17 09:50:42 +02:00
expressions doc: clarify that optional attrs in a function argument will be ignored unless specified 2019-05-21 18:08:26 +02:00
figures Fix corrupt PNG 2013-08-21 12:53:51 +02:00
glossary docs: Add IDs to important sections 2018-08-31 10:06:33 -04:00
images/callouts Add docbook icons to the distribution 2014-04-09 14:52:43 +02:00
installation docs: raise minimal boost version to 1.66 2018-12-13 01:50:39 -05:00
introduction editline: wip 2018-10-29 08:44:58 -05:00
packages manual: "Nix Package collection" -> "Nixpkgs package collection". 2019-04-14 03:20:57 +02:00
release-notes Add 2.2 release notes 2019-01-10 21:02:09 +01:00
hacking.xml Docs: Fix install prefix 2018-08-21 21:46:43 +02:00
local.mk Add a new option to disable documentation generation at configure time 2016-09-20 14:34:43 +00:00
manual.xml Create upgrade notes 2018-09-01 15:35:46 -04:00
nix-lang-ref.xml * Various updates. 2009-11-05 09:07:43 +00:00
quote-literals.xsl Generate release notes again 2014-03-12 14:24:29 +01:00
schemas.xml * Document setuid Nix installs. 2004-10-31 17:08:48 +00:00
style.css Update release notes 2018-02-19 20:38:53 +01:00