commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Gary Gregory <garydgreg...@gmail.com>
Subject Re: JDK8 compatible javadoc
Date Wed, 30 Apr 2014 01:50:27 GMT
Well, it does not support HTML in the sense that you MUST close all tags.
No lonely <p>s...

Gary


On Tue, Apr 29, 2014 at 9:35 PM, Paul Benedict <pbenedict@apache.org> wrote:

> JDK Javadoc only supports HTML. It doesn't support XHTML. I remember
> someone saying this on the OpenJDK lists but don't know where it is... but
> I do remember that.
>
>
> On Tue, Apr 29, 2014 at 8:12 PM, Gary Gregory <garydgregory@gmail.com
> >wrote:
>
> > Bernd,
> >
> > For paragraphs I use <p>la di da</p>, never the concept of a "line
> > separator", that's a rendering concept IMO, not content, which is what
> > Javadoc is. For code examples, then you end up in <pre>...</pre> unless
> > it's inline then you use {@code ...}.
> >
> > For IO-424, I've seen some discussion on the Maven ML and Jiras fly by,
> > check there, sorry I have no exact references.
> >
> >
> > Gary
> >
> >
> > On Tue, Apr 29, 2014 at 8:35 PM, Bernd Eckenfels <ecki@zusammenkunft.net
> > >wrote:
> >
> > > Am Tue, 29 Apr 2014 20:19:03 -0400
> > > schrieb Gary Gregory <garydgregory@gmail.com>:
> > >
> > > > If you think XHTML/XML you should be fine.
> > >
> > > Hm, actually I dont know. It looks that neighter <p>block</p> (HTML)
> > > nor self-closing <br/> (XHTML) is valid/preferred. (So I plan to only
> > > use <p> and <br> as paragraph or line seperators.)
> > >
> > > BTW: Gary, did you find out something about IO-424 "javadoc: warning -
> > > Error fetching URL: http://download.oracle.com/javaee/6/api". Same
> > > happens with VFS, too.
> > >
> > > Gruss
> > > Bernd
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
> > > For additional commands, e-mail: dev-help@commons.apache.org
> > >
> > >
> >
> >
> > --
> > E-Mail: garydgregory@gmail.com | ggregory@apache.org
> > Java Persistence with Hibernate, Second Edition<
> > http://www.manning.com/bauer3/>
> > JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
> > Spring Batch in Action <http://www.manning.com/templier/>
> > Blog: http://garygregory.wordpress.com
> > Home: http://garygregory.com/
> > Tweet! http://twitter.com/GaryGregory
> >
>
>
>
> --
> Cheers,
> Paul
>



-- 
E-Mail: garydgregory@gmail.com | ggregory@apache.org
Java Persistence with Hibernate, Second Edition<http://www.manning.com/bauer3/>
JUnit in Action, Second Edition <http://www.manning.com/tahchiev/>
Spring Batch in Action <http://www.manning.com/templier/>
Blog: http://garygregory.wordpress.com
Home: http://garygregory.com/
Tweet! http://twitter.com/GaryGregory

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message