After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 689767 - gdbus-codegen --generate-docbook doesn't like line breaks
gdbus-codegen --generate-docbook doesn't like line breaks
Status: RESOLVED OBSOLETE
Product: glib
Classification: Platform
Component: gdbus
2.35.x
Other Linux
: Normal normal
: ---
Assigned To: David Zeuthen (not reading bugmail)
gtkdev
Depends on:
Blocks:
 
 
Reported: 2012-12-06 14:22 UTC by Cosimo Cecchi
Modified: 2018-05-24 14:52 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Cosimo Cecchi 2012-12-06 14:22:03 UTC 
gdbus-codegen --generate-docbook seems to generate broken documentation for method parameters if their documentation comment is split amongst multiple lines.

For example, this works fine

<!--
Foo():
@bar: very long description of what bar is
@baz: very long description of what baz is

Does foo
-->

but this doesn't

<!--
Foo():
@bar: very long description of what
bar is
@baz: very long description of what
baz is

Does foo
-->
Comment 1 David Zeuthen (not reading bugmail) 2012-12-06 18:36:18 UTC 
That is correct, line-breaks are not current supported. I'm not sure it's worth adding it but, hey, as they say, patches welcome...
Comment 2 GNOME Infrastructure Team 2018-05-24 14:52:59 UTC 
-- GitLab Migration Automatic Message --

This bug has been migrated to GNOME's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.gnome.org/GNOME/glib/issues/641.