diff options
Diffstat (limited to 'DOCS/man/input.rst')
-rw-r--r-- | DOCS/man/input.rst | 25 |
1 files changed, 24 insertions, 1 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index db544d3ddd..65e734187a 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -1446,7 +1446,15 @@ Property list Additional per-option information. This has a number of sub-properties. Replace ``<name>`` with the name of - a top-level option. + a top-level option. No guarantee of stability is given to any of these + sub-properties - they may change radically in the feature. + + ``option-info/<name>/name`` + Returns the name of the option. + + ``option-info/<name>/type`` + Return the name of the option type, like ``String`` or ``Integer``. + For many complex types, this isn't very accurate. ``option-info/<name>/set-from-commandline`` @@ -1454,6 +1462,21 @@ Property list ``no`` otherwise. What this is set to if the option is e.g. changed at runtime is left undefined (meaning it could change in the future). + ``option-info/<name>/default-value`` + The default value of the option. May not always be available. + + ``option-info/<name>/min``, ``option-info/<name>/max`` + Integer minimum and maximum values allowed for the option. Only + available if the options are numeric, and the minimum/maximum has been + set internally. It's also possible that only one of these is set. + + ``option-info/<name>/choices`` + If the option is a choice option, the possible choices. Choices that + are integers may or may not be included (they can be implied by ``min`` + and ``max``). Note that options which behave like choice options, but + are not actual choice options internally, may not have this info + available. + ``property-list`` Return the list of top-level properties. |