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 774446 - make distcheck fails due to GTKDOC_CHECK
make distcheck fails due to GTKDOC_CHECK
Status: RESOLVED FIXED
Product: totem
Classification: Core
Component: general
3.20.x
Other Linux
: Normal normal
: ---
Assigned To: General Totem maintainer(s)
General Totem maintainer(s)
Depends on:
Blocks:
 
 
Reported: 2016-11-15 01:42 UTC by Mario Sánchez Prada
Modified: 2016-11-28 09:53 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Mario Sánchez Prada 2016-11-15 01:42:22 UTC 
At the moment make distcheck is broken due to using GTKDOC_CHECK in 3.20.1:

  FAIL: gtkdoc-check
  ==================

  Running suite(s): gtk-doc-totem
  totem-undocumented.txt:1:E: 16 undocumented or incomplete symbols
  ./totem-undeclared.txt:1:E: 19 undeclared symbols
  ./totem-unused.txt:1:E: 143 unused documentation entries
  ./totem-docs.xml doesn't appear to include "xml/api-index-3.10.xml"
  0.0%: Checks 4, Failures: 4

I don't have the right environment right now to check this against master, so reporting against 3.20.1 for now, but it wouldn't hurt to check it there if possible.
Comment 1 Bastien Nocera 2016-11-16 12:38:12 UTC 
It's been failing for a while, but I've already wasted enough time trying to fix it, and gave up. Let me know how far you get fixing that one.
Comment 2 Mario Sánchez Prada 2016-11-17 11:03:52 UTC 
I'm actually quite short on time too right now :(, so for now I've removed the GTKDOC_CHECK stuff downstream but I'll let you know if I manage to fix this properly at some point. Thanks!
Comment 3 Philip Withnall 2016-11-28 09:53:07 UTC 
Fixed, because I know how to have fun.

commit 7bd39330e8b83d072945068bc88d06982eab3adc
Author: Philip Withnall <philip.withnall@collabora.co.uk>
Date:   Mon Nov 28 09:47:24 2016 +0000

    docs: Documentation checking fixes
    
     • Add some new symbols to sections.txt, and remove old ones
     • Add some missing API version indexes to the documentation
     • Add a few missing documentation comments
     • Update the list of ignored files to include new headers which are not
       public API
    
    https://bugzilla.gnome.org/show_bug.cgi?id=774446