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 603428 - Make docextract_to_xml.py successful with the gst-plugins-base source file mixer.c
Make docextract_to_xml.py successful with the gst-plugins-base source file mi...
Status: RESOLVED FIXED
Product: pygobject
Classification: Bindings
Component: codegen
unspecified
Other Linux
: Normal normal
: ---
Assigned To: Nobody's working on this now (help wanted and appreciated)
Python bindings maintainers
Depends on:
Blocks:
 
 
Reported: 2009-12-01 00:34 UTC by José Alburquerque
Modified: 2010-06-02 15:08 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
The source file to be processed correctly (24.62 KB, text/x-csrc)
2009-12-01 00:34 UTC, José Alburquerque
Details

Description José Alburquerque 2009-12-01 00:34:11 UTC
Created attachment 148799 [details]
The source file to be processed correctly

Hi.  Is the codegen stuff in pygobject still being worked on?  I was wondering if it is possible for a modification to be made so that it successfully processes the gst-plugins-base source file gst-libs/gst/interfaces/mixer.c, particularly the gst_mixer_list_track() function.  In the source it has this doc comment:

/**
 * gst_mixer_list_tracks:
 * @mixer: the #GstMixer (a #GstElement) to get the tracks from.
 *
 * Returns a list of available tracks for this mixer/element. Note
 * that it is allowed for sink (output) elements to only provide
 * the output tracks in this list. Likewise, for sources (inputs),
 * it is allowed to only provide input elements in this list.
 *
 * Returns: A #GList consisting of zero or more #GstMixerTracks.
 *          The list is owned by the #GstMixer instance and must not be freed
 *          or modified.
 */

However, the docextract_to_xml.py output for this function is:

<function name="gst_mixer_list_tracks">
<description>
Returns: A #GList consisting of zero or more #GstMixerTracks.

</description>
<parameters>
<parameter name="mixer">
<parameter_description> the #GstMixer (a #GstElement) to get the tracks from.
</parameter_description>
</parameter>
</parameters>
<return> A #GList consisting of zero or more #GstMixerTracks.
The list is owned by the #GstMixer instance and must not be freed
or modified.
</return>
</function>

The problem is that the description is not entirely accurate.  I'm not sure if it's a comment problem or a processing problem.  I'll attach the source file to make things easier for testing.  Thanks so much.
Comment 1 José Alburquerque 2010-06-02 15:08:04 UTC
I believe this has been fixed by the enhancement bug #615136.  Closing.