Re: advice for pre-generating documentation

2010-02-20 Thread Stefano Lattarini
At Saturday 20 February 2010, Ralf Wildenhues wrote: > Hello, > > to round this up: > > Wildcards in EXTRA_DIST are pretty much a must-not-break because > too many packages depend on it. Of course the caveats mentioned > in the FAQ apply. > > extra[567].test and distdir.test check semantics

Re: advice for pre-generating documentation

2010-02-20 Thread Ralf Wildenhues
Hello, to round this up: * Braden McDaniel wrote on Fri, Feb 12, 2010 at 05:28:26PM CET: > On Fri, 2010-02-12 at 12:59 +0100, Stefano Lattarini wrote: > > At Friday 12 February 2010, Braden McDaniel > > wrote: > > > Actually, EXTRA_DIST can pull in a whole subdirectory. > > Thank you for the i

Re: advice for pre-generating documentation

2010-02-12 Thread Gaetan Nadon
On Fri, 2010-02-12 at 12:21 +0100, Steffen Dettmer wrote: > On Thu, Feb 11, 2010 at 5:08 PM, Gaetan Nadon wrote: > > generated using tools such as doxygen, asciidoc, xmlto, groff, and > > ps2pdf. I can state some reasons why generated docs and included in the > > tarball: > > This is interesting

Re: advice for pre-generating documentation

2010-02-12 Thread Braden McDaniel
On Fri, 2010-02-12 at 12:59 +0100, Stefano Lattarini wrote: > At Friday 12 February 2010, Braden McDaniel > wrote: > > Actually, EXTRA_DIST can pull in a whole subdirectory. > Thank you for the information, I didn't know that (or I forgot it). I > guess It's time for me to re-read the Automake

Re: advice for pre-generating documentation

2010-02-12 Thread Stefano Lattarini
At Friday 12 February 2010, Braden McDaniel wrote: > Actually, EXTRA_DIST can pull in a whole subdirectory. Thank you for the information, I didn't know that (or I forgot it). I guess It's time for me to re-read the Automake documentation. > Wildcards work there as well. Mmhhh... technically, y

Re: advice for pre-generating documentation

2010-02-12 Thread Steffen Dettmer
On Thu, Feb 11, 2010 at 6:06 PM, Andreas Jellinghaus wrote: > also I wonder: > what about builddir vs. sourcedir? how do you handle that? > does automake handle that automaticaly? make does handle it (at least GNU Make, I don't know others): If you have in Makefile.am let's say: EXTRA_DIST = s

Re: advice for pre-generating documentation

2010-02-12 Thread Steffen Dettmer
On Thu, Feb 11, 2010 at 5:08 PM, Gaetan Nadon wrote: > generated using tools such as doxygen, asciidoc, xmlto, groff, and > ps2pdf. I can state some reasons why generated docs and included in the > tarball: This is interesting and many seem to agree here, but I think this is wrong. In my team we

Re: advice for pre-generating documentation

2010-02-11 Thread Braden McDaniel
On Fri, 2010-02-12 at 00:03 +0100, Stefano Lattarini wrote: > At Thursday 11 February 2010, Andreas Jellinghaus > 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 wit

Re: advice for pre-generating documentation

2010-02-11 Thread Peter Johansson
Hi Andreas, On 2/11/10 12:06 PM, Andreas Jellinghaus wrote: also I wonder: what about builddir vs. sourcedir? how do you handle that? if people have a tar.gz with pre-build documentation, it is in sourcedir. if people checkout svn and build in a seperate build root, the documentation is created

Re: advice for pre-generating documentation

2010-02-11 Thread Stefano Lattarini
At Thursday 11 February 2010, Andreas Jellinghaus 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 loc

Re: advice for pre-generating documentation

2010-02-11 Thread Gaetan Nadon
On Thu, 2010-02-11 at 18:06 +0100, Andreas Jellinghaus wrote: > Ah, thanks. I didn't know about EXTRA_DIST. > > Is there some mechanism I can put a wildcard into automake > files? for example it would be easier to specify "*.html", > as the script downloads all wiki pages, and thus new pages > wo

Re: advice for pre-generating documentation

2010-02-11 Thread Andreas Jellinghaus
Ah, thanks. I didn't know about EXTRA_DIST. Is there some mechanism I can put a wildcard into automake files? for example it would be easier to specify "*.html", as the script downloads all wiki pages, and thus new pages would be added automaticaly that way. also I wonder: what about builddir vs.

Re: advice for pre-generating documentation

2010-02-11 Thread Gaetan Nadon
On Thu, 2010-02-11 at 15:31 +0100, Andreas Jellinghaus wrote: > Hi, > > 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 defaul

advice for pre-generating documentation

2010-02-11 Thread Andreas Jellinghaus
Hi, 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: *