<!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.26.0">
</HEAD>
<BODY>
On Wed, 2011-03-30 at 18:59 +0200, Cyril Brulebois wrote:
<BLOCKQUOTE TYPE=CITE>
<PRE>
Hi Gaetan,

Gaetan Nadon &lt;<A HREF="mailto:memsize@videotron.ca">memsize@videotron.ca</A>&gt; (29/03/2011):
&gt; Gaetan Nadon (3):
&gt;       config: comment, minor upgrade, quote and layout configure.ac
&gt;       DocBook/XML: add support for docbook external references
&gt;       Version bump: 1.7

building an updated package, a few new files come up, which have a
surprising name:
| dh_install --fail-missing
| dh_install: usr/share/sgml/X11/xorg-fo.xsl exists in debian/tmp but is not installed to anywhere
| dh_install: usr/share/sgml/X11/xorg-xhtml.xsl exists in debian/tmp but is not installed to anywhere
</PRE>
</BLOCKQUOTE>
Both of these are new files, replacing xorg.xsl
<BLOCKQUOTE TYPE=CITE>
<PRE>
| dh_install: usr/share/sgml/X11/dbs/masterdb.txt.xml exists in debian/tmp but is not installed to anywhere
| dh_install: usr/share/sgml/X11/dbs/masterdb.pdf.xml exists in debian/tmp but is not installed to anywhere
| dh_install: usr/share/sgml/X11/dbs/masterdb.ps.xml exists in debian/tmp but is not installed to anywhere
| dh_install: usr/share/sgml/X11/dbs/masterdb.html.xml exists in debian/tmp but is not installed to anywhere
| dh_install: missing files, aborting

(dh_install warns us about the new files)

Do we really have a .xml per output format?

</PRE>
</BLOCKQUOTE>
This is correct. There has to be one master db per format. It points to a real filename such as secint.html, secint.pdf, etc...
<BLOCKQUOTE TYPE=CITE>
<PRE>

On a related note, I've been killing (not shipping) *.xml files which
get make install'ed in other packages (along with *.pdf, *.html, *.txt)
but I think I forgot to ask you whether they could be useful for some
purposes. Is there any point in shipping them? If not, what about
stopping make install'ing them?
</PRE>
</BLOCKQUOTE>
I am not sure if you are talking about the .xml alone, or if you are also talking about the html/pdf/ps/txt output formats.<BR>
The .xml for DocBook.xml is both an input format (someone types in modification) and an output format (the file is read<BR>
by a human being). For example, gnome-help can read DocBook/XML and so can some editors. This is why it is installed.<BR>
I had the same impression a while back. It has a dual role.<BR>
<BR>
Thanks for asking. In xorg-docs and any other modules with DocBook documents, a couple of new files will get generated<BR>
and installed. They are *.fo.db and *.html.db. Check the README in xorg-sgml-doctools, I tried to explain some of these.<BR>
So I can remember in a few weeks from now :-)
<BLOCKQUOTE TYPE=CITE>
<PRE>

KiBi.
</PRE>
</BLOCKQUOTE>
</BODY>
</HTML>