doc: Use self-closing tags for return and argument

For the time being we don't support writing a description for those, preferring
having all details in the method's description.

Using self-closing tags saves half the lines, and prevents contributors from
thinking that they should write the argument or return documentation there.

(cherry picked from commit 7adf4cc9b5)
This commit is contained in:
Rémi Verschelde
2021-07-30 15:28:05 +02:00
parent c5589c76ce
commit 16fd1c421e
350 changed files with 10551 additions and 21102 deletions

View File

@@ -14,24 +14,21 @@
</tutorials>
<methods>
<method name="init_ref">
<return type="bool">
</return>
<return type="bool" />
<description>
Initializes the internal reference counter. Use this only if you really know what you are doing.
Returns whether the initialization was successful.
</description>
</method>
<method name="reference">
<return type="bool">
</return>
<return type="bool" />
<description>
Increments the internal reference counter. Use this only if you really know what you are doing.
Returns [code]true[/code] if the increment was successful, [code]false[/code] otherwise.
</description>
</method>
<method name="unreference">
<return type="bool">
</return>
<return type="bool" />
<description>
Decrements the internal reference counter. Use this only if you really know what you are doing.
Returns [code]true[/code] if the decrement was successful, [code]false[/code] otherwise.