[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