Re: [patch 1/4] DocBook: allow to mark structure members private

[Alexey Dobriyan <adobriyan@gmail.com>]

Randy Dunlap wrote:
> Ahoy.  Excellent.  Compare my personal todo list item:

> 35.for kernel-doc: make some fields :private: so that a description is not
>     expected for them.

Aha! A kernel-doc hacker! Randy, by any chance, do you have "support for
nested structs" in your TODO? And if yes, what's the status? I have
parsing with the following syntax:

 # /**
 #  * struct my_struct - short description
 #  * @a: first member
 #  * @b: second member
+#  * @c: nested struct
+#  * @c.p: first member of nested struct
+#  * @c.q: second member of nested struct
 #  * 
 #  * Longer description
 #  */
 # struct my_struct {
 #     int a;
 #     int b;
+#     struct her_struct {
+#         char **p;
+#         short q;
+#     } c;
 # };

But properly nested displaying is in pretty much nil state since .. uh
crap.. summer.

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/