Field descriptions are missing when header files are included each other.
- From: Takao Fujiwara <tfujiwar redhat com>
- To: gtk-doc-list gnome org
- Subject: Field descriptions are missing when header files are included each other.
- Date: Thu, 9 Jul 2015 15:55:39 +0900
I have ibusproperty.h and ibusproplist.h and the header files are included each other.
If the structure has a member, gtkdoc-mkdb outputs a warning:
./a/ibusproplist.h:49: warning: Field description for IBusPropList::properties is missing in source code
comment block.
I prepared 4 files for the test:
https://fujiwara.fedorapeople.org/ibus/20150709/a.sgml
https://fujiwara.fedorapeople.org/ibus/20150709/ibusproperty.h
https://fujiwara.fedorapeople.org/ibus/20150709/ibusproplist.h
https://fujiwara.fedorapeople.org/ibus/20150709/ibustypes.h
I run the gtk-doc commands:
% ls a
ibusproperty.h ibusproplist.h ibustypes.h
% gtkdoc-scan --module=ibus --source-dir=./a --rebuild-sections
% gtkdoc-mktmpl --module=ibus
% gtkdoc-mkdb --module=ibus --output-format=xml --expand-content-files="" --main-sgml-file=a.sgml
--source-dir=./a --xml-mode --output-format=xml
Then I got the above warning.
How can I fix the problem?
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]