[PATCH xserver] dmx-doc: remove from git the linuxdoc generated files
Gaetan Nadon
memsize at videotron.ca
Mon Jan 11 08:40:53 PST 2010
On Mon, 2010-01-11 at 09:53 -0500, Kristian Høgsberg wrote:
> On Mon, Jan 11, 2010 at 9:35 AM, Gaetan Nadon <memsize at videotron.ca>
> wrote:
>
>
> On Sun, 2010-01-10 at 14:06 -0800, Keith Packard wrote:
>
> > On Sun, 10 Jan 2010 16:06:51 -0500, Gaetan Nadon <memsize at videotron.ca> 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.
> >
>
>
>
>
> 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.
>
> The html generated by doxygen are a problem. It breaks "make
> dist". By default, html files are not generated, so the
> tarball creation fails.
>
>
> hw/dmx/doc
> make[3]: *** No rule to make target `html/ChkNotMaskEv_8h_source.html', needed by `distdir'. Stop.
>
>
> This is the subject of the other patch (which I need to
> reparent):
>
>
>
> [PATCH xserver] dmx-doc: do
> not distribute generated
> html files.
>
> 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.
>
>
>
> Add
>
>
> DISTCHECK_CONFIGURE_FLAGS = --enable-docs
>
>
> (or whatever the ./configure option is) to the toplevel Makefile.am?
>
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.
Thanks.
>
> Kristian
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.x.org/archives/xorg-devel/attachments/20100111/6e7f992f/attachment.html
More information about the xorg-devel
mailing list