Build fixes (was Anything more for xproto 7.0.22?)

[Gaetan Nadon]

On Fri, 2011-06-03 at 22:46 +0200, Cyril Brulebois wrote:

> Cyril Brulebois <kibi at debian.org> (03/06/2011):
> > Except it needs a patch for specs/SIAddresses (will be sent as a
> > follow-up to this mail), and after that it still doesn't pass
> > distcheck:
> 
> (Reviewed-by: Alan, thanks.)
> 
> > | make[3]: Entering directory `/home/kibi/debian-x/proto/x11proto-core.git/xproto-7.0.22/_build/specs'
> > | make[4]: Entering directory `/home/kibi/debian-x/proto/x11proto-core.git/xproto-7.0.22/_build/specs'
> > | make[4]: Nothing to be done for `install-exec-am'.
> > | test -z "/home/kibi/debian-x/proto/x11proto-core.git/xproto-7.0.22/_inst/share/doc/xproto" || /bin/mkdir -p "/home/kibi/debian-x/proto/x11proto-core.git/xproto-7.0.22/_inst/share/doc/xproto"
> > |  /usr/bin/install -c -m 644 ../../specs/x11protocol.xml ../../specs/encoding.xml ../../specs/glossary.xml ../../specs/keysyms.xml ../../specs/sect1-9.xml '/home/kibi/debian-x/proto/x11proto-core.git/xproto-7.0.22/_inst/share/doc/xproto'
> > | test -z "/usr/share/sgml/X11/dbs" || /bin/mkdir -p "/usr/share/sgml/X11/dbs"
> > |  /usr/bin/install -c -m 644 x11protocol.html.db x11protocol.fo.db '/usr/share/sgml/X11/dbs'
> > | /usr/bin/install: cannot create regular file `/usr/share/sgml/X11/dbs/x11protocol.html.db': Permission denied
> > | /usr/bin/install: cannot create regular file `/usr/share/sgml/X11/dbs/x11protocol.fo.db': Permission denied
> > | make[4]: *** [install-sgmldbsDATA] Error 1
> > | make[4]: Leaving directory `/home/kibi/debian-x/proto/x11proto-core.git/xproto-7.0.22/_build/specs'
> > | make[3]: *** [install-am] Error 2
> > 
> > Any clue? Gaetan, maybe?


Is it intentional for these files to be installed in /usr/share? The
docs are installed in $home, so I wonder.

The DocBook/XML olink databases (this is what those files are) are
installed in the location provided by the specs/Makefile variable
sgmldbsdir which is set to $(XORG_SGML_PATH)/X11/dbs. The value of
XORG_SGML_PATH is obtained from the macro XORG_CHECK_SGML_DOCTOOLS (see
config.log). The macro obtains the value from pkg-config
--variable=sgmlrootdir xorg-sgml-doctools. Perhaps the
xorg-sgml-doctools was installed in /usr/share.

In order for the docs to be able to cross-reference, the docs (and their
supporting db files) must form a "tree" once installed. In X.Org, one
can install each of the hundreds of modules in different directory. This
won't work for docs with cross-reference. I tried to explain this in the
README:

        Build assumptions
        -----------------
        Packages provide great flexibility, including the one to install each package
        documentation in a separate, totally unrelated directory using the --docdir
        configure option. For external references to work, it is assumed that
        the each package installs the documentation using the relative
        doc/${PACKAGE_TARNAME} location.
        
        The Docbook stylesheet technology will create references with paths relative
        to this location. It will navigate up to "doc" using ../ and then navigate
        down to the document it refers to.

I may not have mentioned the same is true for the db files. They are
created by the modules but installed in xorg-sgml-doctools. Bottom line
is the installed docs and their dbs must be installed in the same tree. 

One scenario that I know would not work (for docs) is for people who
build a single package against a distro. The docs in their home dir
cannot refer to docs in /usr/share due to the db files and vice-versa. I
don't recall I had anticipated the failure to install the db files
however.

All I can think of for now is to disable building the docs or install
xorg-sgml-doctools in a user writable location.








> 
> (Now cc'd)
> 
> Apparently you should know about it. :D I git bisected it to (no surprise):
>   da46c2d0e11c1709b7dd6b2c79253ce8751c81bb
> aka. “Documentation: add Docbook external references support”
> 
> ;)
> 
> Mraw,
> KiBi.
> _______________________________________________
> xorg-devel at lists.x.org: X.Org development
> Archives: http://lists.x.org/archives/xorg-devel
> Info: http://lists.x.org/mailman/listinfo/xorg-devel


-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110604/cb68a8d0/attachment.html>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: This is a digitally signed message part
URL: <http://lists.x.org/archives/xorg-devel/attachments/20110604/cb68a8d0/attachment.pgp>