<!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 Sat, 2010-01-09 at 09:14 -0800, Dan Nicholson wrote:
<BLOCKQUOTE TYPE=CITE>
<PRE>
On Sat, Jan 9, 2010 at 9:04 AM, Julien Cristau &lt;<A HREF="mailto:jcristau@debian.org">jcristau@debian.org</A>&gt; wrote:
&gt; On Sat, Jan &nbsp;9, 2010 at 11:53:24 -0500, Gaetan Nadon wrote:
&gt;
&gt;&gt; When building of docs is disabled (the default) the
&gt;&gt; distribution of the doc output must be as well.
&gt;&gt; Otherwise the make dist target fails.
&gt;&gt;
&gt; I disagree with this. &nbsp;make dist should give reproducible results.

Right. Also, the onus is on the developer making the tarball to have
all the necessary doc tools so that people building from tarballs
don't need them.

</PRE>
</BLOCKQUOTE>
<BR>
I must have overlooked something. As it is now, the make dist target fails (and so does distcheck). Simply type 'make dist' to confirm. The docs are not built by default, which is fine. If I do build them, they build successfully. What is different and confusing is that the output of the build process is distributed. <BR>
<BR>
My only intention was to prevent the dist/distcheck target to fail. I agree that the tarball must always be the same and not subject to variable. The solution is no good, so I withdraw the patch. <BR>
<BR>
That leaves us with the broken dist target to fix. Based on comments in git, the html files used to be checked-in, they were removed in favour of being built. <BR>
<BR>
<BLOCKQUOTE>
<PRE>
We probably shouldn't include the built versions in the tarball, but we do, 
so this is an attempt to make that work by having both the 'all' and 'dist' 
targets depends on the doxygen output.
</PRE>
</BLOCKQUOTE>
<BR>
I see two options:<BR>
Always build docs *and* distribute html. Only clean using maintainer-clean target as doxygen is then considered a special tool.<BR>
Consider doxygen as a normal build process tool *and* do not distribute html.<BR>
Suggestions?<BR>
<BR>
I had a quick look and doxygen is only used in xserver/dmx and in xcb/libxcb/doc.<BR>
<BR>
This reminds me a lot&nbsp; of the INSTALL/ChangeLog targets.<BR>
<BR>
Thanks a lot!<BR>
<BR>
Gaetan<BR>
<BR>
<BLOCKQUOTE TYPE=CITE>
<PRE>
--
Dan
</PRE>
</BLOCKQUOTE>
</BODY>
</HTML>