summaryrefslogtreecommitdiffstats
path: root/doc/manual/generate-options.nix
blob: 3c31a4eec37dea61e3c96f2b3ce6defc5e302459 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
with builtins;
with import ./utils.nix;

options:

concatStrings (map
  (name:
    let option = options.${name}; in
    "  - `${name}`  \n\n"
    + concatStrings (map (s: "    ${s}\n") (splitLines option.description)) + "\n\n"
    + "    **Default:** " + (
      if option.value == "" || option.value == []
      then "*empty*"
      else if isBool option.value
      then (if option.value then "`true`" else "`false`")
      else
        # n.b. a StringMap value type is specified as a string, but
        # this shows the value type.  The empty stringmap is "null" in
        # JSON, but that converts to "{ }" here.
        (if isAttrs option.value then "`\"\"`"
         else "`" + toString option.value + "`")) + "\n\n"
    + (if option.aliases != []
       then "    **Deprecated alias:** " + (concatStringsSep ", " (map (s: "`${s}`") option.aliases)) + "\n\n"
       else "")
    )
  (attrNames options))