incubator-kato-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ant elder <antel...@apache.org>
Subject Re: Specification building
Date Fri, 17 Jul 2009 09:11:24 GMT
On Tue, Jul 14, 2009 at 9:30 AM, Steve Poole<spoole167@googlemail.com> wrote:
> On Tue, Jul 14, 2009 at 9:21 AM, ant elder <ant.elder@gmail.com> wrote:
>
>> On Sun, Jul 12, 2009 at 11:38 AM, Steve Poole<spoole167@googlemail.com>
>> wrote:
>> > I've now got a trial process going  which results in a pdf of the API
>> > javadoc + a cover sheet.    Its available here
>> >
>> http://hudson.zones.apache.org/hudson/view/Kato/job/org.apache.kato/org.apache.kato$kato.api/ws/target/site/spec/spec.pdf
>> >
>> > The front sheet is not pretty (not sure why there are no margins)  but
>> I'm
>> > sure its fixable,     It relies on using a  javadoc doclet from
>> > http://aurigadoclet.sourceforge.net/      Once you've downloaded
>> > aurigadoclet to your local environment you need to add a property to your
>> > maven settings file like
>> >
>>
>> Could you explain a bit more about how aurigadoclet is being used? Its
>> license is GPL which is a dependency license that can't be used by ASF
>> projects, that may not be a problem depending how its being used but
>> i'm not sure i quite grok that yet. Is this generation of the javadoc
>> going to be part of the regular build or distribution process?
>>
>
> Aurigadoclet currently is used to produce the PDF file directly from the
> javadoc.    I am looking into a way to replace it with a non GPL version.
>   I would like to have the spec document generated as part of the regular
> build process.
>
>

How about the Maven Docbkx plugin  -
http://docs.codehaus.org/display/MAVENUSER/Docbkx+Maven+Plugin, don't
know if it does what you need but its quite flexible so could be worth
a look.

   ...ant

Mime
View raw message