You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Gary Gregory <ga...@gmail.com> on 2017/05/17 19:25:30 UTC
[ALL] Build Javadoc with Java 9
Hi All:
I wonder if we should build all of our Javadocs for our sites with Java 9
since it provides nice new features like searchable Javadocs and HTML5.
Notice the search box on the page
http://download.java.net/java/jdk9/docs/api/overview-summary.html
Gary
--
E-Mail: garydgregory@gmail.com | ggregory@apache.org
Java Persistence with Hibernate, Second Edition
<https://www.amazon.com/gp/product/1617290459/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1617290459&linkCode=as2&tag=garygregory-20&linkId=cadb800f39946ec62ea2b1af9fe6a2b8>
<http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1617290459>
JUnit in Action, Second Edition
<https://www.amazon.com/gp/product/1935182021/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182021&linkCode=as2&tag=garygregory-20&linkId=31ecd1f6b6d1eaf8886ac902a24de418%22>
<http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1935182021>
Spring Batch in Action
<https://www.amazon.com/gp/product/1935182951/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182951&linkCode=%7B%7BlinkCode%7D%7D&tag=garygregory-20&linkId=%7B%7Blink_id%7D%7D%22%3ESpring+Batch+in+Action>
<http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1935182951>
Blog: http://garygregory.wordpress.com
Home: http://garygregory.com/
Tweet! http://twitter.com/GaryGregory
Re: [ALL] Build Javadoc with Java 9
Posted by Matt Sicker <bo...@gmail.com>.
Speaking of javadoc checks, maybe I'll considering enabling them when
OpenJDK does.
On 18 May 2017 at 03:10, Stian Soiland-Reyes <st...@apache.org> wrote:
> Agree to wait for Java 9 GA before it's general practice. Would not -1 a
> release candidate with nicer Java 9 javadoc though!
>
> With Java 8 there were many issues with javadoc checks and options
> incompatible with Java 7. I I don't know if anything changes here for
> Java 9, but trying to comply both with Java 8 and a pre-release of Java 9
> sounds like wasted effort if Java 9 javadoc defaults still can change.
>
> On 17 May 2017 9:55 pm, "Benedikt Ritter" <br...@apache.org> wrote:
>
> > Hi,
> >
> > > Am 17.05.2017 um 15:25 schrieb Gary Gregory <ga...@gmail.com>:
> > >
> > > Hi All:
> > >
> > > I wonder if we should build all of our Javadocs for our sites with
> Java 9
> > > since it provides nice new features like searchable Javadocs and HTML5.
> > > Notice the search box on the page
> > > http://download.java.net/java/jdk9/docs/api/overview-summary.html <
> > http://download.java.net/java/jdk9/docs/api/overview-summary.html>
> >
> > Looks nice! But I think every RM should decide which JDK she want’s to
> > build the JavaDocs with. I for example wait until Java 9 goes GA, before
> I
> > use it as my main build environment.
> >
> > Regards,
> > Benedikt
> >
> > >
> > > Gary
> > >
> > > --
> > > E-Mail: garydgregory@gmail.com | ggregory@apache.org
> > > Java Persistence with Hibernate, Second Edition
> > > <https://www.amazon.com/gp/product/1617290459/ref=as_li_
> > tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1617290459&
> > linkCode=as2&tag=garygregory-20&linkId=cadb800f39946ec62ea2b1af9fe6a2b8>
> > >
> > > <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=
> > 1617290459>
> > > JUnit in Action, Second Edition
> > > <https://www.amazon.com/gp/product/1935182021/ref=as_li_
> > tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182021&
> > linkCode=as2&tag=garygregory-20&linkId=31ecd1f6b6d1eaf8886ac902a24de4
> 18%22
> > >
> > >
> > > <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=
> > 1935182021>
> > > Spring Batch in Action
> > > <https://www.amazon.com/gp/product/1935182951/ref=as_li_
> > tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182951&
> > linkCode=%7B%7BlinkCode%7D%7D&tag=garygregory-20&linkId=%7B%
> > 7Blink_id%7D%7D%22%3ESpring+Batch+in+Action>
> > > <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=
> > 1935182951>
> > > Blog: http://garygregory.wordpress.com
> > > Home: http://garygregory.com/
> > > Tweet! http://twitter.com/GaryGregory
> >
> >
>
--
Matt Sicker <bo...@gmail.com>
Re: [ALL] Build Javadoc with Java 9
Posted by Stian Soiland-Reyes <st...@apache.org>.
Agree to wait for Java 9 GA before it's general practice. Would not -1 a
release candidate with nicer Java 9 javadoc though!
With Java 8 there were many issues with javadoc checks and options
incompatible with Java 7. I I don't know if anything changes here for
Java 9, but trying to comply both with Java 8 and a pre-release of Java 9
sounds like wasted effort if Java 9 javadoc defaults still can change.
On 17 May 2017 9:55 pm, "Benedikt Ritter" <br...@apache.org> wrote:
> Hi,
>
> > Am 17.05.2017 um 15:25 schrieb Gary Gregory <ga...@gmail.com>:
> >
> > Hi All:
> >
> > I wonder if we should build all of our Javadocs for our sites with Java 9
> > since it provides nice new features like searchable Javadocs and HTML5.
> > Notice the search box on the page
> > http://download.java.net/java/jdk9/docs/api/overview-summary.html <
> http://download.java.net/java/jdk9/docs/api/overview-summary.html>
>
> Looks nice! But I think every RM should decide which JDK she want’s to
> build the JavaDocs with. I for example wait until Java 9 goes GA, before I
> use it as my main build environment.
>
> Regards,
> Benedikt
>
> >
> > Gary
> >
> > --
> > E-Mail: garydgregory@gmail.com | ggregory@apache.org
> > Java Persistence with Hibernate, Second Edition
> > <https://www.amazon.com/gp/product/1617290459/ref=as_li_
> tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1617290459&
> linkCode=as2&tag=garygregory-20&linkId=cadb800f39946ec62ea2b1af9fe6a2b8>
> >
> > <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=
> 1617290459>
> > JUnit in Action, Second Edition
> > <https://www.amazon.com/gp/product/1935182021/ref=as_li_
> tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182021&
> linkCode=as2&tag=garygregory-20&linkId=31ecd1f6b6d1eaf8886ac902a24de418%22
> >
> >
> > <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=
> 1935182021>
> > Spring Batch in Action
> > <https://www.amazon.com/gp/product/1935182951/ref=as_li_
> tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182951&
> linkCode=%7B%7BlinkCode%7D%7D&tag=garygregory-20&linkId=%7B%
> 7Blink_id%7D%7D%22%3ESpring+Batch+in+Action>
> > <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=
> 1935182951>
> > Blog: http://garygregory.wordpress.com
> > Home: http://garygregory.com/
> > Tweet! http://twitter.com/GaryGregory
>
>
Re: [ALL] Build Javadoc with Java 9
Posted by Benedikt Ritter <br...@apache.org>.
Hi,
> Am 17.05.2017 um 15:25 schrieb Gary Gregory <ga...@gmail.com>:
>
> Hi All:
>
> I wonder if we should build all of our Javadocs for our sites with Java 9
> since it provides nice new features like searchable Javadocs and HTML5.
> Notice the search box on the page
> http://download.java.net/java/jdk9/docs/api/overview-summary.html <http://download.java.net/java/jdk9/docs/api/overview-summary.html>
Looks nice! But I think every RM should decide which JDK she want’s to build the JavaDocs with. I for example wait until Java 9 goes GA, before I use it as my main build environment.
Regards,
Benedikt
>
> Gary
>
> --
> E-Mail: garydgregory@gmail.com | ggregory@apache.org
> Java Persistence with Hibernate, Second Edition
> <https://www.amazon.com/gp/product/1617290459/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1617290459&linkCode=as2&tag=garygregory-20&linkId=cadb800f39946ec62ea2b1af9fe6a2b8>
>
> <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1617290459>
> JUnit in Action, Second Edition
> <https://www.amazon.com/gp/product/1935182021/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182021&linkCode=as2&tag=garygregory-20&linkId=31ecd1f6b6d1eaf8886ac902a24de418%22>
>
> <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1935182021>
> Spring Batch in Action
> <https://www.amazon.com/gp/product/1935182951/ref=as_li_tl?ie=UTF8&camp=1789&creative=9325&creativeASIN=1935182951&linkCode=%7B%7BlinkCode%7D%7D&tag=garygregory-20&linkId=%7B%7Blink_id%7D%7D%22%3ESpring+Batch+in+Action>
> <http:////ir-na.amazon-adsystem.com/e/ir?t=garygregory-20&l=am2&o=1&a=1935182951>
> Blog: http://garygregory.wordpress.com
> Home: http://garygregory.com/
> Tweet! http://twitter.com/GaryGregory