ad1188ba7f
Jobs and Roles frequently have the same variable names, so use create unique directives and roles for each so that they are easy to disambiguate. This lets us say :jobvar:`tox.environment` rather than :var:`job-tox.environment` which seems a bit arbitrary. Change-Id: I9d72d11bfdb700037a6a08f92a2dbfa95ee519ad
70 lines
1005 B
ReStructuredText
70 lines
1005 B
ReStructuredText
Examples
|
|
========
|
|
|
|
Configuration Attributes
|
|
------------------------
|
|
|
|
.. attr:: example-attr
|
|
:required:
|
|
|
|
This is an example configuration attribute.
|
|
|
|
.. attr:: foo
|
|
:default: bar
|
|
|
|
A sub attribute.
|
|
|
|
.. value:: bar
|
|
|
|
An attribute value.
|
|
|
|
.. value:: baz
|
|
|
|
Another attribute value.
|
|
|
|
This is an attribute role: :attr:`example-attr.foo`
|
|
|
|
This is an attribute value role: :value:`example-attr.foo.bar`
|
|
|
|
|
|
Job Variables
|
|
-------------
|
|
|
|
.. var:: example-variable
|
|
|
|
This is an example variable.
|
|
|
|
.. var:: foo
|
|
|
|
This is a variable.
|
|
|
|
.. var:: bar
|
|
|
|
This is a sub key.
|
|
|
|
.. var:: items
|
|
:type: list
|
|
|
|
This variable is a list.
|
|
|
|
.. var:: baz
|
|
|
|
This is an item in a list.
|
|
|
|
This is a variable role: :var:`example-variable.items.baz`
|
|
|
|
|
|
Statistics
|
|
----------
|
|
|
|
.. stat:: example-stat
|
|
|
|
This is an example statistic.
|
|
|
|
.. stat:: foo
|
|
:type: counter
|
|
|
|
A sub stat.
|
|
|
|
This is a statistics role: :stat:`example-stat.foo`
|