[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: advice for pre-generating documentation

From: Braden McDaniel
Subject: Re: advice for pre-generating documentation
Date: Thu, 11 Feb 2010 23:40:28 -0500

On Fri, 2010-02-12 at 00:03 +0100, Stefano Lattarini wrote: 
> At Thursday 11 February 2010, Andreas Jellinghaus <address@hidden> wrote:
> > Hi,
> Hello Andreas.  I'm by no means an expert on complex Automake usage, but
> maybe I can provide a hint or two.
> > 
> > we generate some docs with doxygen, others with a shell
> > script using wget and xslt to download our wiki and
> > create local html files from that).
> > 
> > that mechanism is currently enabled with "--enable-doc",
> > off by default as it is time-consuming and usualy not
> > wanted.
> > 
> > the problem I have is this:
> > * I want people to checkout svn and compile and test the
> >   software without generating documentation.
> > * if people want the docs, they should be able to create
> >   them too.
> > * if I run "make distcheck", I want the existing documentation
> >   to be included in the tar.gz file.
> Maybe a dist-hook can help here:
>  -
> A dist-hook can be especially useful if you don't know in advance the names
> of all the files to be included in the distribution tarball, in which case
> EXTRA_DIST is useless (and if I recall correctly, Doxygen generates *a lot*
> of files when creating HTML output).

Actually, EXTRA_DIST can pull in a whole subdirectory. Wildcards work
there as well.

That doesn't help you with install; but you can add an
install-data-local hook for that.

Braden McDaniel <address@hidden>

reply via email to

[Prev in Thread] Current Thread [Next in Thread]