[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