GNOME Bugzilla – Bug 733797
Documentation fails to build
Last modified: 2017-10-19 12:50:07 UTC
make[3]: Entering directory '/home/nemequ/local/src/gnome/gst-plugins-bad/docs/libs' DOC Scanning header files DOC Introspecting gobjects In file included from ../../gst-libs/gst/gl/gstgl_fwd.h:26:0, from ../../gst-libs/gst/gl/gl.h:29, from gst-plugins-bad-libs-scan.c:12: ../../gst-libs/gst/gl/glprototypes/base.h:52:23: error: unknown type name 'GLenum' (GLenum target, GLuint texture)) ^ ../../gst-libs/gst/gl/gstglapi.h:124:24: note: in definition of macro 'GST_GL_EXT_FUNCTION' ret GSTGLAPI (*name) args; ^ ../../gst-libs/gst/gl/glprototypes/base.h:52:38: error: unknown type name 'GLuint' (GLenum target, GLuint texture)) And so on (for quite some time). This is the 1.4 branch, currently at 5d1ccc93665dbfeea747f184015afc4a9ec93e63, on F21. Here is the summary from the configure script: configure: *** Plug-ins without external dependencies that will be built: accurip adpcmdec adpcmenc aiff asfmux audiofxbad audiomixer audiovisualizers autoconvert bayer camerabin2 coloreffects compositor dataurisrc debugutils dvbsuboverlay dvdspu festival fieldanalysis freeverb frei0r gaudieffects gdp geometrictransform id3tag inter interlace ivfparse ivtc jp2kdecimator jpegformat librfb liveadder midi mpegdemux mpegpsmux mpegtsdemux mpegtsmux mxf pcapparse pnm rawparse removesilence sdp segmentclip siren smooth speed stereo subenc videofilters videoparsers videosignal vmnc y4m yadif configure: *** Plug-ins without external dependencies that will NOT be built: cdxaparse dccp faceoverlay hdvparse mve nuvdemux patchdetect real sdi tta videomeasure configure: *** Plug-ins that have NOT been ported: acm apexsink cdxaparse dc1394 dccp directdraw faceoverlay gsettings hdvparse libvisual linsys lv2 musepack mve mythtv nas nuvdemux osx_video patchdetect quicktime real sdi sdl sndio teletextdec timidity tta vcd videomeasure wininet xvid configure: *** Plug-ins with dependencies that will be built: curl dash decklink dvb fbdevsink hls neonhttpsrc rsvg sbc sfdec sfenc shm smoothstreaming uvch264 wayland configure: *** Plug-ins with dependencies that will NOT be built: acm androidmedia apexsink applemedia assrender avcsrc bluez bz2 chromaprint daala dc1394 dfbvideosink direct3dsink directdrawsink directsoundsrc dtsdec faac faad flite fluidsynth gl gme gsettings gsmenc gsmdec kate ladspa libmms libvisual linsys lv2 mimic modplug mpeg2enc mpg123 mplex musepack mythtvsrc nassink ofa openal opencv openexr openjpeg openni2 opensl opus osxvideosrc pvr qtwrapper resindvd rtmp schro sdlvideosink sdlaudiosink sndio soundtouch spandsp spc srtp teletextdec timidity vcdsrc vdpau vo-aacenc vo-amrwbenc wasapi webp wildmidi wininet winks winscreencap xvid zbar configure: *** Orc acceleration disabled. Requires Orc >= 0.4.17, which was not found. Slower code paths will be used. Now type 'make' to compile gst-plugins-bad.
> configure: *** Plug-ins with dependencies that will NOT be built [snip] > gl You'll have to get the opengl plugins to build in order to build the docs properly. Last I checked, gtk-doc fails with conditional includes.
> You'll have to get the opengl plugins to build in order to build the docs > properly. Last I checked, gtk-doc fails with conditional includes. So there is an issue, but we can't easily fix it because of gtk-doc?
Yes, the problem is that the .types file includes the <gst/gl/gl.h> which assumes that some kind of GL header was included before attempting to include the stuff in gst-libs/gst/gl/glprototypes which contains references to the GL types (GLenum, GLuint, etc) thus producing the above error. Even if you get past the hurdle of the includes using #ifdef __FOOL_GTK_DOC__ then the program it builds will require symbols in the libgstgl library that will not be resolved producing a linker error. To get around this, when you attempt to selectively use the offending functions by strategically placing #if preprocesser statements in the .types file, gtk-doc assumes that these #if's are functions and will produce a source file that will have a stray '#if' in it and produce a compile error.
*** Bug 789191 has been marked as a duplicate of this bug. ***