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 bra...@endoframe.com wrote: Actually, EXTRA_DIST can pull in a whole subdirectory. Thank

Re: advice for pre-generating documentation

2010-02-20 Thread Stefano Lattarini
At Saturday 20 February 2010, Ralf Wildenhues ralf.wildenh...@gmx.de 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

Re: advice for pre-generating documentation

2010-02-12 Thread Steffen Dettmer
On Thu, Feb 11, 2010 at 5:08 PM, Gaetan Nadon mems...@videotron.ca 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

Re: advice for pre-generating documentation

2010-02-12 Thread Steffen Dettmer
On Thu, Feb 11, 2010 at 6:06 PM, Andreas Jellinghaus a...@dungeon.inka.de 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

Re: advice for pre-generating documentation

2010-02-12 Thread Stefano Lattarini
At Friday 12 February 2010, Braden McDaniel bra...@endoframe.com 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.

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 bra...@endoframe.com 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: 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 mems...@videotron.ca 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

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: *

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 default as it

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 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 would be

Re: advice for pre-generating documentation

2010-02-11 Thread Stefano Lattarini
At Thursday 11 February 2010, Andreas Jellinghaus a...@dungeon.inka.de 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

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

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 a...@dungeon.inka.de 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,