GNOME Bugzilla – Bug 574530
gtkmm-documentation: html should not rebuild when building the tarball.
Last modified: 2009-09-17 05:32:07 UTC
Currently it is not easy to pass --nonet to xsltproc when building gtkmm-documentation. The proposed patch makes XSLTPROC check for envvar as done by DOCBOOK_STYLESHEET, so that one can control its behavior through envvar as well. The --nonet is intend to help with easier building when network connection is not feasible, such as auto build daemon in Debian.
Created attachment 130267 [details] [review] gtkmm-doc_xsltproc.patch
But surely this should not be necessary when building from a tarball? All the HTML should be in the tarball already.
Indeed. Then there must be something wrong with gtkmm-documentation 2.14.0, which builds the tutorial anyway though htmls are already generated, and I haven't figured out why yet.
I can confirm this.
I think this is caused because somehow C/gtkmm-tut-with-examples.xml is newer than html/index.html in the tarball: murrayc@murrayc-desktop:~/svn/gnome220/gtkmm-documentation/gtkmm-documentation-2.14.2/docs/tutorial$ ls -lah C/gtkmm-tut-with-examples.xml -rw-r--r-- 1 murrayc murrayc 581K 2009-03-09 17:52 C/gtkmm-tut-with-examples.xml murrayc@murrayc-desktop:~/svn/gnome220/gtkmm-documentation/gtkmm-documentation-2.14.2/docs/tutorial$ ls -lah html/index.html -rw-r--r-- 1 murrayc murrayc 26K 2009-03-09 17:46 html/index.html Though that is not true in the svn checkout where I ran distcheck: murrayc@murrayc-desktop:~/svn/gnome220/gtkmm-documentation/docs/tutorial$ ls -lah C/gtkmm-tut-with-examples.xml -rw-r--r-- 1 murrayc murrayc 581K 2009-03-09 17:46 C/gtkmm-tut-with-examples.xml murrayc@murrayc-desktop:~/svn/gnome220/gtkmm-documentation/docs/tutorial$ ls -lah html/index.html -rw-r--r-- 1 murrayc murrayc 26K 2009-03-09 17:46 html/index.html Maybe something is causing gtkmm-tut-with-examples.xml to be regenerated during distcheck.
Of course, it would be nice if the timestamps were irrelevant when not using maintainer mode, so it would not try to rebuild these files even if some files were newer.
Created attachment 131847 [details] distcheck.log.gz Attaching a local distcheck log. There is a possibility that C/gtkmm-tut-with-examples.xml is copied later than html/index.html and hence end up with a newer timestamp, though I don't quite get the full idea of a distcheck and on which stage the tarball is actually created.
I guess this is fixed now, Daniel?
It wasn't fixed, but it is now. Turns out the doc-dist-hook rule of gnome-doc-utils.make invokes $(INSTALL_DATA) to copy the files into the distribution, which is inappropriate outside of an install rule. As a result, the files copied into the tarball had their timestamps updated, which then triggered the rebuild. I completely got rid of the dist-hook now and use plain Automake functionality to distribute these files, which works nicely. Nonetheless, gnome-doc-utils.make should still be fixed after the freeze.
Thanks. So did you file a bug for gnome-doc-utils?