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 145292 - Confusing mention of make failure
Confusing mention of make failure
Status: RESOLVED FIXED
Product: gtk-doc
Classification: Platform
Component: general
unspecified
Other All
: Normal normal
: ---
Assigned To: gtk-doc maintainers
gtk-doc maintainers
Depends on:
Blocks:
 
 
Reported: 2004-07-02 07:23 UTC by Geert Stappers
Modified: 2004-12-22 21:47 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Geert Stappers 2004-07-02 07:23:58 UTC 
Hello,

In the file setting-up.txt there is this text:

   (Note that due to make being awkward the build
    may fail the first time,
    but if you run make again it should work.)

This design "feature" causes problems on fresh builds.
But even first time builds should be possible.

gtk-doc should have a proper Makefile
Comment 1 Owen Taylor 2004-07-02 07:29:03 UTC 
I think what this means is that when you are *first* setting
up gtk-doc in a project,you might get a make failure or
two until tmpl/ is created. But certainly fresh checkouts
from CVS work fine for properly set up modules.
Comment 2 Geert Stappers 2004-07-02 07:37:44 UTC 
Bug 125646 is the reason for filing this bugreport.
(hey, this was a mid air collision)
Comment 3 Nickolay V. Shmyrev 2004-07-02 14:39:14 UTC 
> But certainly fresh checkouts from CVS work fine for properly set up modules. 

The problem is that for proper setup those modules requires to include
autogenerated files into CVS. That is the main point of a bug.
Comment 4 Damon Chaplin 2004-07-02 17:54:00 UTC 
The discussion of the issue is here:
http://lists.gnome.org/archives/gtk-doc-list/2001-May/msg00028.html

As Owen said, it only happens because there aren't any files in tmpl/ at first.
So I don't think it is too important. I should probably have explained it better,
though.

Anyway, setting-up.txt is out of date and needs to be completely rewritten.
There is another bug about that.
Comment 5 Damon Chaplin 2004-09-10 14:19:29 UTC 
I've update the docs so I'm closing this.