diff options
Diffstat (limited to 'schemas/pathentry.xsd')
-rw-r--r-- | schemas/pathentry.xsd | 29 |
1 files changed, 28 insertions, 1 deletions
diff --git a/schemas/pathentry.xsd b/schemas/pathentry.xsd index e5d2ef6af..44c86f9bc 100644 --- a/schemas/pathentry.xsd +++ b/schemas/pathentry.xsd @@ -12,7 +12,34 @@ schemaLocation="genshi.xsd"/> <xsd:complexType name='PathEntry'> - <xsd:attribute type='xsd:string' name='name' use='required'/> + <xsd:annotation> + <xsd:documentation> + Abstract description of a path to be installed. This can + either be a single explicit path (e.g., ``<Path + name="/etc/foo.conf"/>``) or a glob that matches a set of + paths (e.g., ``<Path glob="/etc/foo/*"/>``). Path + globbing may not work for some dynamically handled Path + entries, for instance :ref:`Packages client configs + <generating-client-configs>`. + </xsd:documentation> + </xsd:annotation> + <xsd:attribute type='xsd:string' name='name'> + <xsd:annotation> + <xsd:documentation> + Install the single named path. Either ``name`` or + :xml:attribute:`PathEntry:glob` must be specified. + </xsd:documentation> + </xsd:annotation> + </xsd:attribute> + <xsd:attribute type="xsd:string" name="glob"> + <xsd:annotation> + <xsd:documentation> + Install all Cfg entries matching the given glob. Either + ``glob`` or :xml:attribute:`PathEntry:name` must be + specified. + </xsd:documentation> + </xsd:annotation> + </xsd:attribute> <xsd:attribute type='xsd:string' name='altsrc' use='optional'/> <xsd:attributeGroup ref="py:genshiAttrs"/> </xsd:complexType> |