<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 TRANSITIONAL//EN"> <HTML> <HEAD> <META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=UTF-8"> <META NAME="GENERATOR" CONTENT="GtkHTML/3.32.2"> </HEAD> <BODY> On Fri, 2011-06-03 at 22:46 +0200, Cyril Brulebois wrote: <BLOCKQUOTE TYPE=CITE> <PRE> Cyril Brulebois <<A HREF="mailto:kibi@debian.org">kibi@debian.org</A>> (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? </PRE> </BLOCKQUOTE> 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: <BLOCKQUOTE> <PRE> 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. </PRE> </BLOCKQUOTE> 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. <BLOCKQUOTE TYPE=CITE> <PRE> (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. _______________________________________________ <A HREF="mailto:xorg-devel@lists.x.org">xorg-devel@lists.x.org</A>: X.Org development Archives: <A HREF="http://lists.x.org/archives/xorg-devel">http://lists.x.org/archives/xorg-devel</A> Info: <A HREF="http://lists.x.org/mailman/listinfo/xorg-devel">http://lists.x.org/mailman/listinfo/xorg-devel</A> </PRE> </BLOCKQUOTE> </BODY> </HTML>