GNOME Bugzilla – Bug 384249
Multiline macro argument lists look bad
Last modified: 2007-01-16 20:54:17 UTC
If the argument list of a macro is split over several lines using backslash continuation, gtk-doc's reproduction looks bad. I suggest we remove the backslashes and correct the spacing of consecutive lines (currently it uses the source file's spacing).
See bug #384247 for a patch.
The macro fix is the added $declaration =~ ... line.
I'm a bit unsure about applying this one, as some macros can be extremely lengthy and complicated (e.g. in Glib/GTK+) so getting gtk-doc to format the output may make it worse. I'll have to see what difference it makes to the Glib and GTK+ docs to decide.
But then, you don't show the macro itself when it's very long or complicated. I'd be fine with doing this only to the macro arguments, myself.
Can you give me an example macro that I can test this with.
Created attachment 80346 [details] Header file with example macros. Here's a header file containing example macros with multiline argument lists. E.g. FLOW_GOBJECT_PROPERTY(...).
Yes, I see what you mean now. Should be better now.