"make dist" shouldn't create doxygen documentation

[Chris Shoemaker]

On Mon, Oct 10, 2005 at 08:32:57PM +0200, Christian Stimming wrote:
> Just recently I discovered that our Makefile rules are set up in a way that 
> will include the doxygen HTML output into the "make dist" tarball packages. 
> This is true for both HEAD and gnome2-dev CVS and, even worse, also for 
> gnucash-1-8-branch.
> 
> I propose to remove that rules altogether. The doxygen HTML documentation is 
> only interesting for developers who really want to program. Those guys should 
> be intelligent enough to follow the directions from the README, which tells 
> them to call "make doc" in order to have the doxygen documentation created. 
> IMHO there is no reason for shipping a generated version of that HTML with 
> the tarball. It only increases building time of "make dist" and increases the 
> size of the release tarball. (And for those with historic interest: This rule 
> was introduced in the gnucash-1.7.x series, and the ChangeLog says 
> "2002-11-27 Doxygen is now required for make dist.")
> 
> Unless anyone objects with very important reasons, I would remove those rules 
> from src/doc/Makefile.am. Note again that this doesn't affect the manual 
> creation of the doxygen documentation by "make doc". It will only turn off 
> that step when running "make dist" or "make distcheck".

I've run 'make dist' about 100 times over the past week, so I'd be
glad to save the time spent generating doxygen docs.  At the very
least, (if we don't remove it altogether) can we make it last rather
than so early on?

-chris

> 
> Christian
> 
> _______________________________________________
> gnucash-devel mailing list
> gnucash-devel at gnucash.org
> https://lists.gnucash.org/mailman/listinfo/gnucash-devel