sd-bus: add brief inline comment explaining the "reserved" field in the bus vtable structure

Follow-up for: #20253
2021-07-28 20:44:49 +02:00
parent 02f2d2b33b
commit 0c4801738e
1 changed files with 5 additions and 2 deletions
@@ -76,7 +76,10 @@ struct sd_bus_vtable {
                        const unsigned *vtable_format_reference;
                } start;
                struct {
-                        size_t reserved;
+                        /* This field exists only to make sure we have something to initialize in
+                         * SD_BUS_VTABLE_END in a way that is both compatible with pedantic versions of C and
+                         * C++. It's unused otherwise. */
+                        size_t _reserved;
                } end;
                struct {
                        const char *member;
@@ -190,7 +193,7 @@ struct sd_bus_vtable {
                .flags = 0,                                             \
                .x = {                                                  \
                        .end = {                                        \
-                                .reserved = 0,                          \
+                                ._reserved = 0,                         \
                        },                                              \
                },                                                      \
        }