<!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 Mon, 2010-01-11 at 09:53 -0500, Kristian Høgsberg wrote:
<BLOCKQUOTE TYPE=CITE>
On Mon, Jan 11, 2010 at 9:35 AM, Gaetan Nadon <<A HREF="mailto:memsize@videotron.ca">memsize@videotron.ca</A>> wrote:
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
<BLOCKQUOTE>
<BR>
</BLOCKQUOTE>
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
<BLOCKQUOTE>
On Sun, 2010-01-10 at 14:06 -0800, Keith Packard wrote:
<BLOCKQUOTE TYPE=CITE>
<PRE>
On Sun, 10 Jan 2010 16:06:51 -0500, Gaetan Nadon <<A HREF="mailto:memsize@videotron.ca">memsize@videotron.ca</A>> wrote:
> The dmx and scaled text files are generated from sgml files.
> The linuxdoc program is used to generated them.
We've generally been distributing the .txt files with the .tar.gz
package so that people don't have to figure out how to get linuxdoc or
doxygen to run. That will take some additional effort to get that to
happen when doing 'make distcheck' which I do for each release.
</PRE>
</BLOCKQUOTE>
<BR>
<BR>
</BLOCKQUOTE>
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
<BLOCKQUOTE>
The .txt generated by linuxdoc isn't a problem so as long as it isn't built by default, which is the case now. We can ignore this patch.<BR>
<BR>
The html generated by doxygen are a problem. It breaks "make dist". By default, html files are not generated, so the tarball creation fails.<BR>
<BR>
<BLOCKQUOTE>
<PRE>
hw/dmx/doc
make[3]: *** No rule to make target `html/ChkNotMaskEv_8h_source.html', needed by `distdir'. Stop.
</PRE>
</BLOCKQUOTE>
<BR>
This is the subject of the other patch (which I need to reparent):<BR>
<BR>
<BLOCKQUOTE>
<TABLE CELLPADDING="0">
<TR>
<TH NOWRAP ALIGN="right" VALIGN="top">
<B> </B>
</TH>
<TD>
[PATCH xserver] dmx-doc: do not distribute generated html files.
</TD>
</TR>
</TABLE>
</BLOCKQUOTE>
It won't stop a knowledgeable person from creating a tarball for a release, but it discourages developers from routinely running dist or distcheck as a good free test case. <BR>
<BR>
</BLOCKQUOTE>
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
<BR>
<BR>
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
Add
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
<BR>
<BR>
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
DISTCHECK_CONFIGURE_FLAGS = --enable-docs
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
<BR>
<BR>
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
(or whatever the ./configure option is) to the toplevel Makefile.am?
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
<BR>
</BLOCKQUOTE>
That will help distcheck but not dist and only if you have doxygen installed (some platforms don't). I first propose to solve the root cause of the problem, and if that's not feasible, then patch some of the symptoms.<BR>
<BR>
Thanks.<BR>
<BR>
<BLOCKQUOTE TYPE=CITE>
<BR>
</BLOCKQUOTE>
<BLOCKQUOTE TYPE=CITE>
Kristian
</BLOCKQUOTE>
</BODY>
</HTML>