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 661853 - allow EXTRA_DIST to be predefined
allow EXTRA_DIST to be predefined
Status: RESOLVED FIXED
Product: gtk-doc
Classification: Platform
Component: general
unspecified
Other All
: Normal normal
: 1.19
Assigned To: gtk-doc maintainers
gtk-doc maintainers
Depends on:
Blocks:
 
 
Reported: 2011-10-15 15:51 UTC by Allison Karlitskaya (desrt)
Modified: 2011-10-17 12:51 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
the patch (1.15 KB, patch)
2011-10-15 20:10 UTC, Allison Karlitskaya (desrt)
rejected Details | Review

Description Allison Karlitskaya (desrt) 2011-10-15 15:51:53 UTC
gtk-doc currently unconditionally assigns EXTRA_DIST, even though other parts of Makefiles may alreaady have done this.  this is the case with glib, for example.

We should only do an assignment if EXTRA_DIST is not already defined and do an append (+=) otherwise.

Ideally, we could use ?= for this, but it seems that even though the automake documentation describes ?=, the currently implementation has a bug when ?= is mixed with +=.  The ifeq route seems to work OK for both the case where EXTRA_DIST is defined before including gtk-doc's makefile and not.
Comment 1 Stefan Sauer (gstreamer, gtkdoc dev) 2011-10-15 17:04:04 UTC
> gtkdocize --help
usage: gtkdocize [ --copy ] [ --docdir DIR ] [ --flavour {legacy|legacy-flat|no-tmpl|no-tmpl-flat} ]

gtkdocize --flavour xxx-flat
Comment 2 Allison Karlitskaya (desrt) 2011-10-15 19:30:45 UTC
the gtkdocize script contains this:


makefile=gtk-doc.make

....

case "$flavour" in
  legacy*)
    ;;
  no-tmpl*)
    makefile=gtk-doc.notmpl.make
    ;;
  *)
    echo "$progname: invalid value for --flavour" 1>&2
    echo "$usage" 1>&2
    exit 1 ;;
esac


and no other mentions of "flat" (except in the --help)
Comment 3 Allison Karlitskaya (desrt) 2011-10-15 19:34:11 UTC
since the 'flat' approach is non-functioning at present (and therefore surely nobody is using it), i suggest that it is removed for favour of my patch.

it seems excessive to have a separate variant for what can easier be handled with a 3-line patch.
Comment 4 Stefan Sauer (gstreamer, gtkdoc dev) 2011-10-15 19:48:26 UTC
which patch?
Comment 5 Allison Karlitskaya (desrt) 2011-10-15 20:10:26 UTC
Created attachment 199076 [details] [review]
the patch

Great question.  I think this was probably one of those "your bug was filed but we had difficulty attaching your patch" cases and I failed to notice it.
Comment 6 Stefan Sauer (gstreamer, gtkdoc dev) 2011-10-17 08:07:11 UTC
Thanks for the patch, that is indeed a lot better than the extra flavor. I guess i8t is gnu make only, but so are many other things anyway.
Comment 7 Stefan Sauer (gstreamer, gtkdoc dev) 2011-10-17 12:50:40 UTC
Reverted the changes and fixed it by fixing gtkdocize to handle the flavour because of automake and gnumake clashing on the conditional:
https://bugzilla.gnome.org/show_bug.cgi?id=661853