[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PULL 13/21] docs/devel/qom: Use *emphasis* for emphasis
From: |
Eduardo Habkost |
Subject: |
[PULL 13/21] docs/devel/qom: Use *emphasis* for emphasis |
Date: |
Tue, 6 Oct 2020 18:09:22 -0400 |
<emphasis> is not valid reST syntax.
Signed-off-by: Eduardo Habkost <ehabkost@redhat.com>
Reviewed-by: Philippe Mathieu-Daudé <f4bug@amsat.org>
Reviewed-by: Paolo Bonzini <pbonzini@redhat.com>
Message-Id: <20201003025424.199291-5-ehabkost@redhat.com>
Signed-off-by: Eduardo Habkost <ehabkost@redhat.com>
---
docs/devel/qom.rst | 6 +++---
1 file changed, 3 insertions(+), 3 deletions(-)
diff --git a/docs/devel/qom.rst b/docs/devel/qom.rst
index a47e1b9a23..0c610e20d6 100644
--- a/docs/devel/qom.rst
+++ b/docs/devel/qom.rst
@@ -174,17 +174,17 @@ dynamically cast it to an object that implements the
interface.
Methods
=======
-A <emphasis>method</emphasis> is a function within the namespace scope of
+A *method* is a function within the namespace scope of
a class. It usually operates on the object instance by passing it as a
strongly-typed first argument.
If it does not operate on an object instance, it is dubbed
-<emphasis>class method</emphasis>.
+*class method*.
Methods cannot be overloaded. That is, the #ObjectClass and method name
uniquely identity the function to be called; the signature does not vary
except for trailing varargs.
-Methods are always <emphasis>virtual</emphasis>. Overriding a method in
+Methods are always *virtual*. Overriding a method in
#TypeInfo.class_init of a subclass leads to any user of the class obtained
via OBJECT_GET_CLASS() accessing the overridden function.
The original function is not automatically invoked. It is the responsibility
--
2.26.2
- [PULL 06/21] hw/core/qdev-properties: Export some integer-related functions, (continued)
- [PULL 06/21] hw/core/qdev-properties: Export some integer-related functions, Eduardo Habkost, 2020/10/06
- [PULL 09/21] qom: Improve error message displayed with missing object properties, Eduardo Habkost, 2020/10/06
- [PULL 08/21] hw/core/cpu: Add missing 'exec/cpu-common.h' include, Eduardo Habkost, 2020/10/06
- [PULL 18/21] qom: Explicitly tag doc comments for typedefs and structs, Eduardo Habkost, 2020/10/06
- [PULL 14/21] docs/devel/qom: Remove usage of <code>, Eduardo Habkost, 2020/10/06
- [PULL 10/21] qom: Fix DECLARE_*CHECKER documentation, Eduardo Habkost, 2020/10/06
- [PULL 07/21] hw/core/qdev-properties: Extract system-mode specific properties, Eduardo Habkost, 2020/10/06
- [PULL 17/21] kernel-doc: Handle function typedefs without asterisks, Eduardo Habkost, 2020/10/06
- [PULL 19/21] memory: Explicitly tag doc comments for structs, Eduardo Habkost, 2020/10/06
- [PULL 11/21] docs/devel/qom: Fix indentation of bulleted list, Eduardo Habkost, 2020/10/06
- [PULL 13/21] docs/devel/qom: Use *emphasis* for emphasis,
Eduardo Habkost <=
- [PULL 12/21] docs/devel/qom: Fix indentation of code blocks, Eduardo Habkost, 2020/10/06
- [PULL 15/21] docs/devel/qom: Avoid long lines, Eduardo Habkost, 2020/10/06
- [PULL 16/21] kernel-doc: Handle function typedefs that return pointers, Eduardo Habkost, 2020/10/06
- [PULL 21/21] numa: hmat: require parent cache description before the next level one, Eduardo Habkost, 2020/10/06
- [PULL 20/21] kernel-doc: Remove $decl_type='type name' hack, Eduardo Habkost, 2020/10/06
- Re: [PULL 00/21] machine + QOM queue, 2020-10-06, Peter Maydell, 2020/10/08