[libvirt PATCH v2 2/3] docs: Use definition list instead of table in coding style
Andrea Bolognani
abologna at redhat.com
Thu May 7 17:35:16 UTC 2020
This format is much easier to tweak and update.
Signed-off-by: Andrea Bolognani <abologna at redhat.com>
---
docs/coding-style.rst | 47 ++++++++++++++++++++++++-------------------
1 file changed, 26 insertions(+), 21 deletions(-)
diff --git a/docs/coding-style.rst b/docs/coding-style.rst
index 151ea87b6a..03b89c86e5 100644
--- a/docs/coding-style.rst
+++ b/docs/coding-style.rst
@@ -547,27 +547,32 @@ Attribute annotations
Use the following annotations to help the compiler and/or static
analysis tools understand the code better:
-+-------------------------------+------------------------------------------------------------+
-| Macro | Meaning |
-+===============================+============================================================+
-| ``ATTRIBUTE_NONNULL`` | passing NULL for this parameter is not allowed |
-+-------------------------------+------------------------------------------------------------+
-| ``ATTRIBUTE_PACKED`` | force a structure to be packed |
-+-------------------------------+------------------------------------------------------------+
-| ``G_GNUC_FALLTHROUGH`` | allow code reuse by multiple switch cases |
-+-------------------------------+------------------------------------------------------------+
-| ``G_GNUC_NO_INLINE`` | the function is mocked in the test suite |
-+-------------------------------+------------------------------------------------------------+
-| ``G_GNUC_NORETURN`` | the function never returns |
-+-------------------------------+------------------------------------------------------------+
-| ``G_GNUC_NULL_TERMINATED`` | last parameter must be NULL |
-+-------------------------------+------------------------------------------------------------+
-| ``G_GNUC_PRINTF`` | validate that the formatting string matches parameters |
-+-------------------------------+------------------------------------------------------------+
-| ``G_GNUC_UNUSED`` | parameter is unused in this implementation of the function |
-+-------------------------------+------------------------------------------------------------+
-| ``G_GNUC_WARN_UNUSED_RESULT`` | the return value must be checked |
-+-------------------------------+------------------------------------------------------------+
+``ATTRIBUTE_NONNULL``
+ passing NULL for this parameter is not allowed
+
+``ATTRIBUTE_PACKED``
+ force a structure to be packed
+
+``G_GNUC_FALLTHROUGH``
+ allow code reuse by multiple switch cases
+
+``G_GNUC_NO_INLINE``
+ the function is mocked in the test suite
+
+``G_GNUC_NORETURN``
+ the function never returns
+
+``G_GNUC_NULL_TERMINATED``
+ last parameter must be NULL
+
+``G_GNUC_PRINTF``
+ validate that the formatting string matches parameters
+
+``G_GNUC_UNUSED``
+ parameter is unused in this implementation of the function
+
+``G_GNUC_WARN_UNUSED_RESULT``
+ the return value must be checked
File handling
-------------
--
2.25.4
More information about the libvir-list
mailing list