You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@sling.apache.org by Konrad Windszus <ko...@netcentric.biz> on 2017/04/03 08:01:31 UTC
Javadoc generation
I am currently looking for a documentation how the javadoc for a Sling release is generated. The documentation at https://sling.apache.org/documentation.html#the-javadoc seems to be outdated. I want to make sure that for Sling9 we include some more packages here: https://issues.apache.org/jira/browse/SLING-6766.
Thanks for any pointers.
Konrad
Re: Javadoc generation
Posted by Robert Munteanu <ro...@apache.org>.
The fix you added looks good to me, thanks!
Robert
On Mon, 2017-04-03 at 10:41 +0200, Konrad Windszus wrote:
> Hi Robert,
> thanks for the info. I think that script needs to be extended,
> because currently this only considers the dependencies from
> slingfeature.txt (i.e. bundles available at run time). In addition at
> least the compile time annotations from https://github.com/apache/sli
> ng/blob/trunk/tooling/maven/adapter-annotations should be included as
> well. I will try to come up with a fix for that script.
> Thanks,
> Konrad
> > On 3 Apr 2017, at 10:09, Robert Munteanu <ro...@apache.org>
> > wrote:
> >
> > Hi Konrad,
> >
> > On Mon, 2017-04-03 at 10:01 +0200, Konrad Windszus wrote:
> > > I am currently looking for a documentation how the javadoc for a
> > > Sling release is generated. The documentation at
> > > https://sling.apache.org/documentation.html#the-javadoc seems to
> > > be
> > > outdated. I want to make sure that for Sling9 we include some
> > > more
> > > packages here: https://issues.apache.org/jira/browse/SLING-6766.
> >
> > The tooling is present at
> >
> > �http://svn.apache.org/repos/asf/sling/trunk/tooling/release/
> >
> > Take a look at the generate_javadoc_for_release.sh script.
> >
> > Robert
>
>
Re: Javadoc generation
Posted by Konrad Windszus <ko...@gmx.de>.
Hi Robert,
thanks for the info. I think that script needs to be extended, because currently this only considers the dependencies from slingfeature.txt (i.e. bundles available at run time). In addition at least the compile time annotations from https://github.com/apache/sling/blob/trunk/tooling/maven/adapter-annotations should be included as well. I will try to come up with a fix for that script.
Thanks,
Konrad
> On 3 Apr 2017, at 10:09, Robert Munteanu <ro...@apache.org> wrote:
>
> Hi Konrad,
>
> On Mon, 2017-04-03 at 10:01 +0200, Konrad Windszus wrote:
>> I am currently looking for a documentation how the javadoc for a
>> Sling release is generated. The documentation at
>> https://sling.apache.org/documentation.html#the-javadoc seems to be
>> outdated. I want to make sure that for Sling9 we include some more
>> packages here: https://issues.apache.org/jira/browse/SLING-6766.
>
> The tooling is present at
>
> http://svn.apache.org/repos/asf/sling/trunk/tooling/release/
>
> Take a look at the generate_javadoc_for_release.sh script.
>
> Robert
Re: Javadoc generation
Posted by Robert Munteanu <ro...@apache.org>.
Hi Konrad,
On Mon, 2017-04-03 at 10:01 +0200, Konrad Windszus wrote:
> I am currently looking for a documentation how the javadoc for a
> Sling release is generated. The documentation at
> https://sling.apache.org/documentation.html#the-javadoc seems to be
> outdated. I want to make sure that for Sling9 we include some more
> packages here: https://issues.apache.org/jira/browse/SLING-6766.
The tooling is present at
http://svn.apache.org/repos/asf/sling/trunk/tooling/release/
Take a look at the generate_javadoc_for_release.sh script.
Robert