Modify configure line for Gcr-3.28.0

[christopher]

Hello,

They have made a default setting of yes for building the html documentation, however that fails at the make install stage with the error below. It needs to have --without-gtk-doc-html in the configure line for a successful installation.

Traceback (most recent call last):

File "/usr/bin/gtkdoc-rebase", line 56, in <module>

sys.exit(rebase.run(options))

File "/usr/share/gtk-doc/python/gtkdoc/rebase.py", line 75, in run

ScanDirectory(dir, options)

File "/usr/share/gtk-doc/python/gtkdoc/rebase.py", line 133, in ScanDirectory

ScanDirectory(subdir, options)

File "/usr/share/gtk-doc/python/gtkdoc/rebase.py", line 114, in ScanDirectory

onlinedir = ReadIndex(dir, entry)

File "/usr/share/gtk-doc/python/gtkdoc/rebase.py", line 153, in ReadIndex

for line in common.open_text(os.path.join(dir, file)):

File "/usr/lib/python2.7/posixpath.py", line 70, in join

elif path == or path.endswith('/'):

AttributeError: 'builtin_function_or_method' object has no attribute 'endswith' make[3]: * [Makefile:883: install-data-local] Error 1 make[3]: Leaving directory '/opt/sources/gnome/gcr-3.28.0/docs/reference/gck' make[2]: * [Makefile:626: install-am] Error 2 make[2]: Leaving directory '/opt/sources/gnome/gcr-3.28.0/docs/reference/gck' make[1]: * [Makefile:5337: install-recursive] Error 1 make[1]: Leaving directory '/opt/sources/gnome/gcr-3.28.0' make: * [Makefile:6098: install] Error 2

Regards,

Christopher.

[ken@…]

AFAICS, the dependencies and instructions for gcr in the sysv and systemd books are the same.

I am extremely reluctant to install gtk-doc, and in the past I have avoided specific versions of another package which required that. But in this case I cannot agree that it is needed:

ken@origin /tmp/gcr-3.28.0 $ls /usr/bin/gtkdoc*
ls: cannot access '/usr/bin/gtkdoc*': No such file or directory

Using the commands in the book, followed by a DESTDIR install, completed the install. In $DESTDIR/usr/share/gtk-doc/html/gck I have 27 html and png files, in the neighbouring gcr-3 directory I have 59 files.

The configure script reported:

checking for gtk-doc... no
configure: WARNING:
  You will not be able to create source packages with 'make dist'
  because gtk-doc >= 1.9 is not found.
checking for gtkdoc-check... no
checking for gtkdoc-check... no
checking for gtkdoc-rebase... no
checking for gtkdoc-mkpdf... no
checking whether to build gtk-doc documentation... no

[christopher]

Hello Ken,

Sorry but in this case the decision to close this ticket is incorrect. You are testing the package without gtk-doc installed.

The failure of yelp to install cleanly along with 4 other packages was due to the fact that gtk-doc WAS installed. You may not like gtk-doc for your own reasons but it IS part of the book and does build a number of packages documentation correctly.

This is a defect in the documentation itself. As they have set the default for building html documentation to yes you need to be able to set it to no if you have gtk-doc installed.

Please also check you spam folder, as I have forwarded you a couple of my replies to the list. It did say that the mail was sent.

[Douglas R. Reno]

Fixed at r20232