diff options
| author | Stone Tickle <lattis@mochiro.moe> | 2022-02-17 10:06:02 -0600 |
|---|---|---|
| committer | Jussi Pakkanen <jpakkane@gmail.com> | 2022-02-20 14:24:05 +0200 |
| commit | e8e7fd98e280baa346a13a75c337832a4fd7f66a (patch) | |
| tree | 94acabb2682f36403ada1caf772ac04197ace8fa | |
| parent | c85f7a39a80ccbadb9ffb76102da30c05e3db66f (diff) | |
| download | meson-e8e7fd98e280baa346a13a75c337832a4fd7f66a.zip meson-e8e7fd98e280baa346a13a75c337832a4fd7f66a.tar.gz meson-e8e7fd98e280baa346a13a75c337832a4fd7f66a.tar.bz2 | |
add all supported arguments in docs for summary()
| -rw-r--r-- | docs/yaml/functions/summary.yaml | 33 |
1 files changed, 28 insertions, 5 deletions
diff --git a/docs/yaml/functions/summary.yaml b/docs/yaml/functions/summary.yaml index 3e7d463..29bff0b 100644 --- a/docs/yaml/functions/summary.yaml +++ b/docs/yaml/functions/summary.yaml @@ -10,7 +10,7 @@ description: | the section keyword argument is omitted, those key/value pairs are implicitly grouped into a section with no title. key/value pairs can optionally be grouped into a dictionary, but keep in mind that - dictionaries does not guarantee ordering. `key` must be string, + dictionaries do not guarantee ordering. `key` must be string, `value` can be: - an integer, boolean or string @@ -62,10 +62,33 @@ example: | ``` posargs: - key: - type: str - description: The name of the new entry + key_or_dict: + type: str | dict[str | bool | int | dep | external_program | list[str | bool | int | dep | external_program]] + description: | + The name of the new entry, or a dict containing multiple entries. If a + dict is passed it is equivalent to calling summary() once for each + key-value pair. Keep in mind that dictionaries do not guarantee + ordering. +optargs: value: type: str | bool | int | dep | external_program | list[str | bool | int | dep | external_program] - description: The value to print for the `key` + description: | + The value to print for the `key`. Only valid if `key_or_dict` is a str. + +kwargs: + bool_yn: + type: bool + default: false + description: Convert bool values to yes and no + section: + type: str + description: The section to put this summary information under. If the + section keyword argument is omitted, key/value pairs are implicitly + grouped into a section with no title. + list_sep: + type: str + since: 0.54.0 + description: | + The separator to use when printing list values in this summary. If no + separator is given, each list item will be printed on its own line. |