[gst-devel] gtk-doc, and deprecation

Stefan Kost kost at imn.htwk-leipzig.de
Tue Jan 18 07:12:42 CET 2005

hi hi,

I am currently ruuning my patched version of gtk-doc and that warns about more
issues (see attached excerpt from make).

This made my aware that our docs don't use comments like
 * Deprecated: use frob_ng() instead
When trying to fix that, I've learned about a nother feature of gtk-doc. It
checks that these deprecated symbols are wrapped by a #ifdef and warns
otherwise. The major problem is if gtk-doc warns the buildbot turns red :(

So the question is, should I add a configure statement to disable deprecated
symbols and add the guards as I find them (#ifdef GST_DISABLE_DEPRECATED).
IMHO this would be good to test how well our own code avoids deprecated stuff as

      \|/            Stefan Kost
     <@ @>           private            business
+-oOO-(_)-OOo------------------------------------------------------ - - -  -   -
|       __  Address  Simildenstr. 5     HTWK Leipzig, Fb IMN, Postfach 301166
|      ///           04277 Leipzig      04251 Leipzig
| __  ///            Germany            Germany
| \\\///    Phone    +49341 2253538     +49341 30766101
|  \__/     EMail    st_kost_at_gmx.net kost_at_imn.htwk-leipzig.de
|           WWW      www.sonicpulse.de  www.imn.htwk-leipzig.de/~kost/about.html
===-=-=--=---=---------------------------------- - - -  -    -
-------------- next part --------------
An embedded and charset-unspecified text was scrubbed...
Name: make.log
URL: <http://lists.freedesktop.org/archives/gstreamer-devel/attachments/20050118/3175255a/attachment.txt>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: kost.vcf
Type: text/x-vcard
Size: 345 bytes
Desc: not available
URL: <http://lists.freedesktop.org/archives/gstreamer-devel/attachments/20050118/3175255a/attachment.vcf>

More information about the gstreamer-devel mailing list