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 631910 - GTK+ 2.22.0 FAILS on compiling the documentation branch
GTK+ 2.22.0 FAILS on compiling the documentation branch
Status: RESOLVED OBSOLETE
Product: gtk+
Classification: Platform
Component: Documentation
2.22.x
Other Linux
: Normal normal
: ---
Assigned To: gtk-bugs
gtk-bugs
Depends on:
Blocks:
 
 
Reported: 2010-10-11 18:07 UTC by alupu
Modified: 2012-02-20 19:24 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
The 'config.log' file of the 'configure' step (with the subsequently failed make) (113.64 KB, application/octet-stream)
2010-10-11 18:07 UTC, alupu
Details

Description alupu 2010-10-11 18:07:49 UTC
Created attachment 172122 [details]
The 'config.log' file of the 'configure' step (with the subsequently failed make)

SYSTEM
(B)LFS, i686-pc-linux-gnu, 2.6.35.2,
Xorg-7.5, GNU Make 3.81, gcc 4.1.2

DETAILS
1) Basic 'configure' command line:
"./configure --prefix=/usr --sysconfdir=/etc"
------
2) Compile (make) error:
<< ...
Making all in tutorial
make[3]: Entering directory `/usr/src/gtk+-2.22.0/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/catalog
Using stylesheet: /usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#html
Working on: /usr/src/gtk+-2.22.0/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[3]: *** [html] Error 1
make[3]: Leaving directory `/usr/src/gtk+-2.22.0/docs/tutorial'
make[2]: *** [all-recursive] Error 1
make[2]: Leaving directory `/usr/src/gtk+-2.22.0/docs'
make[1]: *** [all-recursive] Error 1
make[1]: Leaving directory `/usr/src/gtk+-2.22.0'
make: *** [all] Error 2
-------
3) Any related 'configure' argument combinations such as
--enable-gtk-doc=no
--enable-gtk-doc=no --enable-gtk-doc-html=no
--enable-gtk-doc-html=no
--enable-gtk-doc
--enable-gtk-doc-html
lead to the same compile (make) error:
<< ...
Working on: /usr/src/gtk+-2.22.0/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[3]: *** [html] Error 1
make[3]: Leaving directory `/usr/src/gtk+-2.22.0/docs/tutorial'
 ... >>
------
4) An ad hoc work-around (fix?) seems to eliminate
 the "tutorial" subdir problem (something similar might then work for
 the other 'docs' subdirectories, like 'faq', etc.)

Before the 'configure' step, in the code of
'docs/tutorial/Makefile.am', I replaced four lines (4-7):
 ...
@HAVE_DOCBOOK_TRUE@html: gtk-tut.sgml
@HAVE_DOCBOOK_TRUE@     if test -w $(srcdir); then \
@HAVE_DOCBOOK_TRUE@       (cd $(srcdir); \
@HAVE_DOCBOOK_TRUE@        db2html gtk-tut.sgml; \
@HAVE_DOCBOOK_TRUE@        test -d html && rm -r html; \
@HAVE_DOCBOOK_TRUE@        mv gtk-tut html; \
@HAVE_DOCBOOK_TRUE@        mkdir html/images; \
@HAVE_DOCBOOK_TRUE@        cp images/*.png html/images); \
@HAVE_DOCBOOK_TRUE@     fi
 ...

with two lines (4-5):
 ...
@HAVE_DOCBOOK_TRUE@html: gtk-tut.sgml
@HAVE_DOCBOOK_TRUE@     if test -w $(srcdir); then \
@HAVE_DOCBOOK_TRUE@       (cd $(srcdir); \
@HAVE_DOCBOOK_TRUE@        db2html -u gtk-tut.sgml; \
@HAVE_DOCBOOK_TRUE@        mv gtk-tut.html html; \
@HAVE_DOCBOOK_TRUE@        cp images/*.png html/images); \
@HAVE_DOCBOOK_TRUE@     fi
 ...,

I end up with a successful 'docs/tutorial' compile:
 ...
Making all in docs
make[2]: Entering directory `/usr/src/gtk+-2.22.0/docs'
Making all in tutorial
make[3]: Entering directory `/usr/src/gtk+-2.22.0/docs/tutorial'
if test -w .; then \
          (cd .; \
        db2html -u gtk-tut.sgml; \
        mv gtk-tut.html html; \
           cp images/*.png html/images); \
        fi
Using catalogs: /etc/sgml/catalog
Using stylesheet: /usr/share/sgml/docbook/utils-0.6.14/docbook-utils.dsl#html
Working on: /usr/src/gtk+-2.22.0/docs/tutorial/gtk-tut.sgml
Done.
make[3]: Leaving directory `/usr/src/gtk+-2.22.0/docs/tutorial'
Making all in faq
make[3]: Entering directory `/usr/src/gtk+-2.22.0/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: /usr/src/gtk+-2.22.0/docs/faq/gtk-faq.sgml
Done.
mv: cannot stat `gtk-faq': No such file or directory
make[3]: *** [html] Error 1
make[3]: Leaving directory `/usr/src/gtk+-2.22.0/docs/faq'
 ...

(using, './configure --prefix=/usr --sysconfdir=/etc && make')

I end up with
 in 'docs/tutorial/html',
drwxr-xr-x 2   4096 2010-09-23 10:56 stylesheet-images
drwxr-xr-x 2   4096 2010-09-23 10:56 images
-rw-r--r-- 1 542641 2010-10-11 12:42 gtk-tut.html

and in 'docs/tutorial/html/images',
arrow.png
 ...
tictactoe.png
------
5) FINAL NOTES
5.1) I have no idea if the author(s) intended the above result,
the html tutorial in one chunk (gtk-tut.html) and the image file
configuration as shown.  That might affect the 'make install', etc.
5.2) If I eliminate the 'docs' subdirectory from the make chain,
the resulting compilation ends perfectly (so to speak).
5.3) My system meets the prerequisites (stated in the INSTALL file):
<< GTK+ requires the following packages:
 - The GLib, Pango, GdkPixbuf, ATK and cairo libraries, available at the same
   location as GTK+. GTK+ 2.22.0 requires at least GLib 2.23.6,
   Pango 1.20, GdkPixbuf 2.21.0, ATK 1.29.2 and cairo 1.6.0.
 - gobject-introspection 0.9.3 or newer. >>.
and then some.
Obviously, answering requests for additional files, results,
clarificaions, etc., will be forthcoming.

Thanks,
-- Alex
Comment 1 David King 2012-02-20 19:24:37 UTC
The tutorial was removed from GTK+ 3, and seems to build fine with GTK+ 2.24(.8, for me), so closing this as obsolete.