[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Qemu-devel] [PULL v3 22/28] qapi: Document intended use of @name within
From: |
Markus Armbruster |
Subject: |
[Qemu-devel] [PULL v3 22/28] qapi: Document intended use of @name within alternate visits |
Date: |
Tue, 9 May 2017 10:06:39 +0200 |
Signed-off-by: Markus Armbruster <address@hidden>
Message-Id: <address@hidden>
Reviewed-by: Marc-André Lureau <address@hidden>
---
include/qapi/visitor.h | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/include/qapi/visitor.h b/include/qapi/visitor.h
index 1a1b620..b0e233d 100644
--- a/include/qapi/visitor.h
+++ b/include/qapi/visitor.h
@@ -63,8 +63,10 @@
* The @name parameter of visit_type_FOO() describes the relation
* between this QAPI value and its parent container. When visiting
* the root of a tree, @name is ignored; when visiting a member of an
- * object, @name is the key associated with the value; and when
- * visiting a member of a list, @name is NULL.
+ * object, @name is the key associated with the value; when visiting a
+ * member of a list, @name is NULL; and when visiting the member of an
+ * alternate, @name should equal the name used for visiting the
+ * alternate.
*
* The visit_type_FOO() functions expect a non-null @obj argument;
* they allocate address@hidden during input visits, leave it unchanged on
--
2.7.4
- [Qemu-devel] [PULL v3 07/28] qobject: Add helper macros for common scalar insertions, (continued)
- [Qemu-devel] [PULL v3 07/28] qobject: Add helper macros for common scalar insertions, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 25/28] qmp-shell: add -N option to skip negotiate, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 24/28] qmp-shell: add persistent command history, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 04/28] pci: Reduce scope of error injection, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 05/28] coccinelle: Add script to remove useless QObject casts, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 11/28] fdc-test: Avoid deprecated 'change' command, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 15/28] qapi: New QAPI_CLONE_MEMBERS(), Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 27/28] qmp-shell: don't show version greeting if unavailable, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 01/28] tests/check-qdict: Fix missing brackets, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 19/28] sockets: Delete unused helper socket_address_crumple(), Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 22/28] qapi: Document intended use of @name within alternate visits,
Markus Armbruster <=
- [Qemu-devel] [PULL v3 06/28] qobject: Drop useless QObject casts, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 17/28] sockets: Rename SocketAddressFlat to SocketAddress, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 12/28] test-qga: Actually test 0xff sync bytes, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 21/28] qobject-input-visitor: Document full_name_nth(), Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 26/28] qmp-shell: Cope with query-commands error, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 14/28] sockets: Prepare inet_parse() for flattened SocketAddress, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 23/28] qobject-input-visitor: Catch misuse of end_struct vs. end_list, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 08/28] qobject: Use simpler QDict/QList scalar insertion macros, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 02/28] test-keyval: fix leaks, Markus Armbruster, 2017/05/09
- [Qemu-devel] [PULL v3 18/28] sockets: Limit SocketAddressLegacy to external interfaces, Markus Armbruster, 2017/05/09