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 729076 - [patch]Make gtk-doc optional
[patch]Make gtk-doc optional
Status: RESOLVED OBSOLETE
Product: libsoup
Classification: Core
Component: HTTP Transport
unspecified
Other Linux
: Normal normal
: ---
Assigned To: libsoup-maint@gnome.bugs
libsoup-maint@gnome.bugs
Depends on:
Blocks:
 
 
Reported: 2014-04-27 21:46 UTC by Jon Nordby
Modified: 2018-09-21 16:20 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Proposd patch (2.02 KB, patch)
2014-04-27 21:47 UTC, Jon Nordby
reviewed Details | Review

Description Jon Nordby 2014-04-27 21:46:55 UTC
This is practical for building in very sparse environment like Heroku,
where pulling in gtk-doc requires building many more dependencies.
Comment 1 Jon Nordby 2014-04-27 21:47:33 UTC
Created attachment 275281 [details] [review]
Proposd patch
Comment 2 Dan Winship 2014-04-28 14:19:36 UTC
Comment on attachment 275281 [details] [review]
Proposd patch

> This is practical for building in very sparse environment like Heroku,
> where pulling in gtk-doc requires building many more dependencies.

Are you building from git or from tarballs?

>+        echo "*** No GTK-Doc found, you will not be able to create API documentation***"
>+        echo 'EXTRA_DIST =' > gtk-doc.make

disted tarballs should always include built documentation, so if don't have gtk-doc, then "make dist" should fail (as it does if you --disable-gtk-doc).

>+else
>+        gtkdocize
> fi
> 
>-gtkdocize || exit $?

should keep the "|| exit $?" so that gtkdocize failure causes autogen.sh to fail

>+AM_CONDITIONAL([ENABLE_GTK_DOC], false)

it's more like HAVE_GTK_DOC, not ENABLE_GTK_DOC...

>diff --git a/docs/Makefile.am b/docs/Makefile.am
>diff --git a/docs/reference/Makefile.am b/docs/reference/Makefile.am

It seems like you should only need to modify one or the other of these Makefiles.
Comment 3 Dan Winship 2015-02-10 11:58:05 UTC
[mass-moving all "UNCONFIRMED" libsoup bugs to "NEW" after disabling the "UNCONFIRMED" status for this product now that bugzilla.gnome.org allows that. bugspam-libsoup-20150210]
Comment 4 Tomas Popela 2018-04-16 08:22:01 UTC
This will be obsolete once we move to Meson and the Autotools support will be removed. The meson port allows building without documentation with -Ddoc=false
Comment 5 GNOME Infrastructure Team 2018-09-21 16:20:27 UTC
-- GitLab Migration Automatic Message --

This bug has been migrated to GNOME's GitLab instance and has been closed from further activity.

You can subscribe and participate further through the new bug through this link to our GitLab instance: https://gitlab.gnome.org/GNOME/libsoup/issues/76.