Am 11.11.2013 12:43, schrieb Tanu Kaskinen:
On Fri, 2013-11-08 at 20:29 +0100, Thomas Martitz wrote:
Am 08.11.2013 14:46, schrieb Tanu Kaskinen:
The effect of the \deprecated tag is (for a reason unknown to me) that
all documentation for the tagged entity is removed. That's not nice,
so this patch replaces the tag with plain text "Deprecated" with bold
formatting.
Have you tried "GENERATE_DEPRECATEDLIST = YES" in doxygen.conf? It's
seems to be set to NO.
No, I hadn't tried that. Now I have. The result was that in the summary
part of e.g. pa_card_port_info there was no text for the "profiles"
field, but the detailed documentation for "profiles" contained
everything it was supposed to, so setting GENERATE_DEPRECATEDLIST = YES
was a definite improvement. I still would prefer to make it easy to see
already in the summary section that the "profiles" field is deprecated,
so I'd prefer to merge this patch, but if I'm alone with that opinion,
I'm fine with just changing GENERATE_DEPRECATEDLIST to YES.
IMO the deprecated information shouldn't be removed from doxygen. You
can do some interesting things with doxygen (other than generating HTML
docs) provided it has all necessary information. Perhaps there is some
other way to promote this text into the summary. On the other hand
people that have to deal with the data structure need to look at the
details anyway so it might not be a big deal if it's not in the summary.
Best regards.
_______________________________________________
pulseaudio-discuss mailing list
[email protected]
http://lists.freedesktop.org/mailman/listinfo/pulseaudio-discuss
