nix/doc/manual/generate-builtins.nix

with builtins;
with import ./utils.nix;

builtins:

concatStrings (map
  (name:
    let builtin = builtins.${name}; in
    "<dt id=\"builtins-${name}\"><a href=\"#builtins-${name}\"><code>${name} "
    + concatStringsSep " " (map (s: "<var>${s}</var>") builtin.args)
    + "</code></a></dt>"
    + "<dd>\n\n"
    + builtin.doc
    + "\n\n</dd>"
  )
  (attrNames builtins))
jq -> nix 2020-09-16 12:55:24 +00:00			`with builtins;`
			`with import ./utils.nix;`

			`builtins:`

			`concatStrings (map`
			`(name:`
			`let builtin = builtins.${name}; in`
Anchor with prefix 2022-02-24 12:50:50 +00:00			`"<dt id=\"builtins-${name}\"><a href=\"#builtins-${name}\"><code>${name} "`
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 13:56:23 +00:00			`+ concatStringsSep " " (map (s: "<var>${s}</var>") builtin.args)`
Anchor link for builtin functions in HTML doc 2022-02-23 14:07:01 +00:00			`+ "</code></a></dt>"`
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 13:56:23 +00:00			`+ "<dd>\n\n"`
			`+ builtin.doc`
			`+ "\n\n</dd>"`
jq -> nix 2020-09-16 12:55:24 +00:00			`)`
			`(attrNames builtins))`