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 623150 - install fails: cannot stat `gtk-tut': No such file or directory
install fails: cannot stat `gtk-tut': No such file or directory
Status: RESOLVED FIXED
Product: gtk+
Classification: Platform
Component: .General
2.21.x
Other Linux
: Normal critical
: ---
Assigned To: Gil Forcada
gtk-bugs
: 627641 (view as bug list)
Depends on:
Blocks:
 
 
Reported: 2010-06-29 16:21 UTC by David Ronis
Modified: 2016-07-14 13:09 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Fix tutorial and faq gtk-doc build (1.06 KB, patch)
2010-08-10 13:44 UTC, Gil Forcada
none Details | Review
Really fix the build issue (1.07 KB, patch)
2010-08-10 14:30 UTC, Gil Forcada
needs-work Details | Review
docs: pass output directory to db2html (1.39 KB, patch)
2016-07-14 13:09 UTC, Ernestas Kulik
none Details | Review

Description David Ronis 2010-06-29 16:21:02 UTC
I'm trying to upgrade to 2.21.3 from 2.21.2.  The build dies with:

make[4]: Entering directory `/home/ronis/Project/notar/GNOME/garnome/platform/gtk+/work/main.d/gtk+-2.21.3/docs/tutorial'
if test -w .; then \
	  (cd .; \
	   db2html gtk-tut.sgml; \
	   test -d html && rm -r html; \
	   mv gtk-tut html; \
	   mkdir html/images; \
	   cp images/*.png html/images); \
	fi
Using catalogs: /etc/sgml/sgml-docbook-3.1.cat
Using stylesheet: /usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#html
Working on: /home/ronis/Project/notar/GNOME/garnome/platform/gtk+/work/main.d/gtk+-2.21.3/docs/tutorial/gtk-tut.sgml
Done.
mv: cannot stat `gtk-tut': No such file or directory
mkdir: cannot create directory `html/images': No such file or directory
cp: target `html/images' is not a directory
make[4]: *** [html] Error 1
Comment 1 David Ronis 2010-07-15 01:25:16 UTC
turns out that I have the same issue with gtk-2.90 as well as now with the faq target.  Removing both from the docs/Makefile allows both gtk2 and 3 to install
Comment 2 Gil Forcada 2010-08-10 13:12:07 UTC
The same happens to me.

The html directory isn't created and the html files aren't moved were they are supposed to move.

I'm attaching a patch that corrects it.
Comment 3 Gil Forcada 2010-08-10 13:44:46 UTC
Created attachment 167513 [details] [review]
Fix tutorial and faq gtk-doc build

Note that both master and gtk-2-22 have the same issue
Comment 4 Gil Forcada 2010-08-10 14:30:16 UTC
Created attachment 167517 [details] [review]
Really fix the build issue

Oops!

I made some mistakes on the previous patch. This one should correctly fix it (now that I tested it :)

Anyone can review it?
Comment 5 Gil Forcada 2010-08-13 21:24:49 UTC
ping for reviewing my patch on comment #4 ...
Comment 6 Javier Jardón (IRC: jjardon) 2010-08-22 19:03:18 UTC
*** Bug 627641 has been marked as a duplicate of this bug. ***
Comment 7 David Ronis 2010-08-22 19:08:52 UTC
Patch review anybody?
Comment 8 Stefan Sauer (gstreamer, gtkdoc dev) 2010-08-22 19:25:38 UTC
I wonder if db2html has changed the semantics. For me db2html says "input file
was called  -- output will be in gtk-faq" that is it creates a dir called
"gtk-faq" and that is being renamed to html by the makefile.

> db2html --version
db2html - docbook-toys 1.51.0

Maybe we could use:
-o, --output DIR        set output DIR
to use a specif output dir.
Comment 9 Robby Workman 2010-09-21 04:11:21 UTC
$ db2html --version
DocBook-utils version 0.6.14 (jw version 1.1)

Gil's patch works here (well, I did something slightly different, but the result is the same), so that should be fine to apply.  Alternatively, the -o option is valid too; I'll be happy to test that if you want to shove a patch this way...
Comment 10 Stefan Sauer (gstreamer, gtkdoc dev) 2010-09-21 08:40:54 UTC
Well the patch cannot be applied as is. It would need to be made so that it does not break things for other people. Ideally ask upstream (db2html) how it should be handled.
Comment 11 David Ronis 2010-10-17 16:47:46 UTC
I think this problem has resurfaced in 2.91.1:

make[4]: Entering directory `/home/ronis/Project/notar/GNOME/garnome/platform/gtk+-3.0/work/main.d/gtk+-2.91.1/docs/faq'
if test -w .; then \
	  (cd .; \
	   db2html gtk-faq.sgml; \
	   test -d html && rm -r html; \
	   mv gtk-faq html); \
	fi
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#html
Working on: /home/ronis/Project/notar/GNOME/garnome/platform/gtk+-3.0/work/main.d/gtk+-2.91.1/docs/faq/gtk-faq.sgml
Done.
mv: cannot stat `gtk-faq': No such file or directory
Comment 12 Matthias Clasen 2010-10-18 12:48:22 UTC
For the tutorial, this problem has been solved by removing the severely outdated, unmaintained document altogether, after lifting some parts into the api docs.

The faq needs to get the same treatment.
Comment 13 Gil Forcada 2010-12-26 12:21:56 UTC
As I don't see neither tutorial nor faq on docs folder, does that mean that this bug should be closed?
Comment 14 Pacho Ramos 2015-02-18 11:45:25 UTC
They are still present in 2.24.x branch :/
Comment 15 Ernestas Kulik 2016-07-14 13:09:35 UTC
Created attachment 331493 [details] [review]
docs: pass output directory to db2html

faq and tutorial targets fail due to the docbook-utils version of
docbook2html not automatically creating a subdirectory. This commit
ensures that they get created by passing a relevant argument.