[elbe-devel] [PATCH v3 04/16] schema: addgroup: Add attributes for missing documentation

[Bastian Germann]

Am 23.09.22 um 16:03 schrieb Viraj Shah:
> * Add missing attribute documentation for addgroup finetuning action.
> * Replace tabs with space, fix indentation for this section.
> 
> Signed-off-by: Viraj Shah <viraj.shah at linutronix.de>

Reviewed-by: Bastian Germann <bage at linutronix.de>

> ---
>   schema/dbsfed.xsd | 30 ++++++++++++++++++++++--------
>   1 file changed, 22 insertions(+), 8 deletions(-)
> 
> diff --git a/schema/dbsfed.xsd b/schema/dbsfed.xsd
> index 232b1961d..b20322e01 100644
> --- a/schema/dbsfed.xsd
> +++ b/schema/dbsfed.xsd
> @@ -2475,18 +2475,32 @@
>     <complexType name="addgroup">
>       <annotation>
>         <documentation>
> -        describes an additional user group to be created. the following parameters are
> -	available:
> -	'gid' - group id.
> -	'system = "True" - system group.
> -	The value of the tag describes the group name name
> -        for the account.
> +       describes an additional user group to be created. the following parameters are
> +       available:
> +       'gid' - group id.
> +       'system = "True" - system group.
> +       The value of the tag describes the group name for the account.
>         </documentation>
>       </annotation>
>       <simpleContent>
>         <extension base="rfs:string">
> -        <attribute name="gid" type="string" use="optional" />
> -        <attribute name="system" type="boolean" use="optional" />
> +       <attribute name="gid" type="string" use="optional">
> +        <annotation>
> +         <documentation>
> +          Describes the numerical value of group's ID. Since the type is string, this
> +          can be a numerical or textual alias
> +         </documentation>
> +        </annotation>
> +        </attribute>
> +        <attribute name="system" type="boolean" use="optional">
> +         <annotation>
> +          <documentation>
> +           It needs to be True by default to create a new system group. This
> +           makes it possible to have the system groups chosen in the range of
> +           SYS_GID_MIN-SYS_GID_MAX.
> +          </documentation>
> +         </annotation>
> +        </attribute>
>         </extension>
>       </simpleContent>
>     </complexType>