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 590718 - docs build failures with -jN: cp: cannot create regular file `build/image.entities': File exists
docs build failures with -jN: cp: cannot create regular file `build/image.ent...
Status: RESOLVED FIXED
Product: GStreamer
Classification: Platform
Component: gstreamer (core)
git master
Other Linux
: Normal normal
: 0.10.29
Assigned To: GStreamer Maintainers
GStreamer Maintainers
Depends on:
Blocks:
 
 
Reported: 2009-08-04 10:30 UTC by Tim-Philipp Müller
Modified: 2010-04-13 11:43 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Tim-Philipp Müller 2009-08-04 10:30:51 UTC
I regularly get build failures when building/distchecking GStreamer core with -j4:

...
Writing index.html for book(index)
Writing index.sgml for book(index)
Writing gstreamer-plugins.devhelp for book(index)
Writing gstreamer-plugins.devhelp2 for book(index)
-- Fixing Crossreferences
Making all in faq
cp: cannot create regular file `build/image.entities': File exists
make[6]: *** [check-local] Error 1
make[5]: *** [html/index.html] Error 2
make[5]: *** Waiting for unfinished jobs....
*** Generating PS output ***
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/docbook-utils/docbook-utils.dsl#print
Working on: /home/tpm/gst/git/gstreamer/gstreamer-0.10.23.5/_build/docs/faq/build/faq.xml
jade:/usr/share/sgml/declaration/xml.dcl:31:27:W: characters in the document character set with numbers exceeding 65535 not supported
x -i print -d /usr/share/docbook-utils/docbook-utils.dsl#print -V paper-type=A4 /usr/share/sgml/declaration/xml.dcl /home/tpm/gst/git/gstreamer/gstreamer-0.10.23.5/_build/docs/faq/build/faq.xml
Done.
make[4]: *** [all-recursive] Error 1
make[3]: *** [all] Error 2
make[2]: *** [all-recursive] Error 1
make[1]: *** [all] Error 2
make: *** [distcheck] Error 2


This looks like a problem in docs/manuals.mak (I attempted to fix this in commit 7a265c1451ff97bf11064f8d214ef89083ba6641 but in retrospect that commit doesn't make sense at all and doesn't even touch the bits where images.entities are created).
Comment 1 Stefan Sauer (gstreamer, gtkdoc dev) 2009-10-11 12:30:40 UTC
Just to make it easier for others, link to the commit:
http://cgit.freedesktop.org/gstreamer/gstreamer/commit/?id=7a265c1451ff97bf11064f8d214ef89083ba6641&h=master

As this is during "make distcehck" its a out of source dir build and if one gets such message:
cp: cannot create regular file `build/image.entities': File exists
it looks like the file is tried to be copied again.

I think the commit is the kind of commit that help parallel build, but as you said not fixes the image problem. What about making similar change for "html/index.html:" "$(DOC).ps:" and "$(DOC).pdf:" rules?
Comment 2 Tim-Philipp Müller 2010-03-25 20:20:15 UTC
Let's just work around it, I don't think anyone's going to spend a lot of time finding the proper fix, seeing how many people run make distcheck regularly..

commit ba60de2fa0e4ccdfe40464b531c2e21dd5768ab2
Author: Tim-Philipp Müller <tim.muller@collabora.co.uk>
Date:   Thu Mar 25 19:56:00 2010 +0000

    docs: fix intermittent make distcheck failures
    
    Use .NOTPARALLEL when building docs. This avoids intermittent
    make distcheck failures like 'cp: cannot create regular file
    `build/image.entities': File exists' when using -jN.
    
    Fixes #590718.