commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Paul Benedict <pbened...@apache.org>
Subject Re: JDK8 compatible javadoc
Date Wed, 30 Apr 2014 02:00:42 GMT
That's actually a really good point :-)


On Tue, Apr 29, 2014 at 8:50 PM, Gary Gregory <garydgregory@gmail.com>wrote:

> 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
>



-- 
Cheers,
Paul

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