commit: 336d16aa5fe8c564a15760659e1670a0e98e58b3
Author: Sam James <sam <AT> gentoo <DOT> org>
AuthorDate: Mon Mar 22 06:56:29 2021 +0000
Commit: Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Tue Mar 30 06:53:26 2021 +0000
URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=336d16aa
eclass-writing: add new eclass doc tags for Eclass Function Variables
Adds:
* @USER_VARIABLE
* @INCLUDES_EPREFIX
* @DEPRECATED
Signed-off-by: Sam James <sam <AT> gentoo.org>
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>
eclass-writing/text.xml | 90 +++++++++++++++++++++----------------------------
1 file changed, 39 insertions(+), 51 deletions(-)
diff --git a/eclass-writing/text.xml b/eclass-writing/text.xml
index 5a1015f..e8b1474 100644
--- a/eclass-writing/text.xml
+++ b/eclass-writing/text.xml
@@ -568,12 +568,8 @@ using the following tags:
<th>description</th>
</tr>
<tr>
- <ti>
- <c>@VARIABLE:</c>
- </ti>
- <ti>
- NO
- </ti>
+ <ti><c>@VARIABLE:</c></ti>
+ <ti>NO</ti>
<ti>
Name of the function-specific variable to which the documentation applies.
</ti>
@@ -584,61 +580,53 @@ using the following tags:
</ti>
</tr>
<tr>
- <ti>
- <c>@DEFAULT_UNSET</c>
- </ti>
- <ti>
- YES
- </ti>
- <ti>
- <d/>
- </ti>
+ <ti><c>@USER_VARIABLE</c></ti>
+ <ti>YES</ti>
+ <ti><d/></ti>
+ <ti>
+ This tag describes whether the variable is unsuitable for use in ebuilds,
+ i.e. if it is solely for user consumption via e.g. make.conf or a similar
+ mechanism.
+ </ti>
+</tr>
+<tr>
+ <ti><c>@DEFAULT_UNSET</c></ti>
+ <ti>YES</ti>
+ <ti><d/></ti>
<ti>
Indicates that this variable is unset by default if not set by the
developer.
</ti>
</tr>
<tr>
- <ti>
- <c>@INTERNAL</c>
- </ti>
- <ti>
- YES
- </ti>
- <ti>
- <d/>
- </ti>
- <ti>
- Indicates that the variable is internal to the eclass function.
- </ti>
+ <ti><c>@INCLUDES_EPREFIX</c></ti>
+ <ti>YES</ti>
+ <ti><d/></ti>
+ <ti>Indicates that the variable is a path which has ${EPREFIX}
prepended.</ti>
</tr>
<tr>
- <ti>
- <c>@REQUIRED</c>
- </ti>
- <ti>
- YES
- </ti>
- <ti>
- <d/>
- </ti>
- <ti>
- Indicates that this variable must be set by the developer.
- </ti>
+ <ti><c>@INTERNAL</c></ti>
+ <ti>YES</ti>
+ <ti><d/></ti>
+ <ti>Indicates that the variable is internal to the eclass function.</ti>
</tr>
<tr>
- <ti>
- <c>@DESCRIPTION:</c>
- </ti>
- <ti>
- NO
- </ti>
- <ti>
- Multiline freetext.
- </ti>
- <ti>
- Long description for the function variable.
- </ti>
+ <ti><c>@REQUIRED</c></ti>
+ <ti>YES</ti>
+ <ti><d/></ti>
+ <ti>Indicates that this variable must be set by the developer.</ti>
+</tr>
+<tr>
+ <ti><c>@DEPRECATED</c></ti>
+ <ti>YES</ti>
+ <ti>Optionally, the name of any replacement variable.</ti>
+ <ti>Declares that this variable should no longer be used in ebuilds.</ti>
+</tr>
+<tr>
+ <ti><c>@DESCRIPTION:</c></ti>
+ <ti>NO</ti>
+ <ti>Multiline freetext.</ti>
+ <ti>Long description for the function variable.</ti>
</tr>
</table>
