diff options
| author | Eric Blake <eblake@redhat.com> | 2015-10-26 16:34:43 -0600 |
|---|---|---|
| committer | Markus Armbruster <armbru@redhat.com> | 2015-11-02 08:30:26 +0100 |
| commit | 255960dd374d4497d6ea537305f1b0d8a3433789 (patch) | |
| tree | 49b56b41812702438ef9f3441c61d8efd84a86c9 /docs/qapi-code-gen.txt | |
| parent | f9e6102b48f21e464a847a858a456c521e7a83e5 (diff) | |
| download | qemu-255960dd374d4497d6ea537305f1b0d8a3433789.zip qemu-255960dd374d4497d6ea537305f1b0d8a3433789.tar.gz qemu-255960dd374d4497d6ea537305f1b0d8a3433789.tar.bz2 | |
qapi: Reserve '*List' type names for list types
Type names ending in 'List' can clash with qapi list types in
generated C. We don't currently use such names. It is easier to
outlaw them now than to worry about how to resolve such a clash
in the future. For precedence, see commit 4dc2e69, which did the
same for names ending in 'Kind' versus implicit enum types for
qapi unions.
Update the testsuite to match.
Signed-off-by: Eric Blake <eblake@redhat.com>
Message-Id: <1445898903-12082-5-git-send-email-eblake@redhat.com>
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Diffstat (limited to 'docs/qapi-code-gen.txt')
| -rw-r--r-- | docs/qapi-code-gen.txt | 3 |
1 files changed, 2 insertions, 1 deletions
diff --git a/docs/qapi-code-gen.txt b/docs/qapi-code-gen.txt index 2afab20..c4264a8 100644 --- a/docs/qapi-code-gen.txt +++ b/docs/qapi-code-gen.txt @@ -106,7 +106,8 @@ Types, commands, and events share a common namespace. Therefore, generally speaking, type definitions should always use CamelCase for user-defined type names, while built-in types are lowercase. Type definitions should not end in 'Kind', as this namespace is used for -creating implicit C enums for visiting union types. Command names, +creating implicit C enums for visiting union types, or in 'List', as +this namespace is used for creating array types. Command names, and field names within a type, should be all lower case with words separated by a hyphen. However, some existing older commands and complex types use underscore; when extending such expressions, |