Re: [hibernate-dev] Realising the JavaDoc jars as well
On 22 December 2017 at 18:16, Steve Ebersole <steve(a)hibernate.org> wrote:
I wanted to get everyone's opinion about the api/spi/internal
package
grouping we do in the aggregated Javadoc in regards to the per-module
javadocs. Adding this logic adds significant overhead to the process of
building the Javadoc, to the point where I am considering not performing
that grouping there.
Thoughts?
For Hibernate Search we recently decided to not produce javadocs at
all for "internal"; everything else is just documented as a single
group.
That cuts on the "need to know" complexity of end users. Advanced
users who could have benefitted from knowing more about the internals
will likely have sources.
On Tue, Dec 12, 2017 at 11:37 AM Vlad Mihalcea <mihalcea.vlad(a)gmail.com>
wrote:
>
> I tested it locally, and when publishing the jars to Maven local, the
> JavaDoc is now included.
>
> Don't know if there's anything to be done about it.
>
> Vlad
>
> On Mon, Dec 11, 2017 at 9:32 PM, Sanne Grinovero <sanne(a)hibernate.org>
> wrote:
>
> > +1 to merge it (if it works - which I didn't check)
> >
> > Some history can easily be found:
> > -
> > http://lists.jboss.org/pipermail/hibernate-dev/2017-January/015758.html
> >
> > Thanks,
> > Sanne
> >
> >
> > On 11 December 2017 at 15:24, Vlad Mihalcea <mihalcea.vlad(a)gmail.com>
> > wrote:
> > > Hi,
> > >
> > > I've noticed this Pull Request which is valid and worth integrating:
> > >
> > > https://github.com/hibernate/hibernate-orm/pull/2078
> > >
> > > Before I merge it, I wanted to make sure whether this change was
> > accidental
> > > or intentional.
> > >
> > > Was there any reason not to ship the JavaDoc jars along with the
> > > release
> > > artifacts and the sources jars as well?
> > >
> > > Thanks,
> > > Vlad
> > > _______________________________________________
> > > hibernate-dev mailing list
> > > hibernate-dev(a)lists.jboss.org
> > > https://lists.jboss.org/mailman/listinfo/hibernate-dev
> >
> _______________________________________________
> hibernate-dev mailing list
> hibernate-dev(a)lists.jboss.org
> https://lists.jboss.org/mailman/listinfo/hibernate-dev