Return-Path: 
 <dev-return-148832-apmail-commons-dev-archive=commons.apache.org@commons.apache.org>
X-Original-To: apmail-commons-dev-archive@www.apache.org
Delivered-To: apmail-commons-dev-archive@www.apache.org
Received: from mail.apache.org (hermes.apache.org [140.211.11.3])
	by minotaur.apache.org (Postfix) with SMTP id 0911610C78
	for <apmail-commons-dev-archive@www.apache.org>;
 Wed, 30 Apr 2014 02:01:09 +0000 (UTC)
Received: (qmail 41863 invoked by uid 500); 30 Apr 2014 02:01:07 -0000
Delivered-To: apmail-commons-dev-archive@commons.apache.org
Received: (qmail 41648 invoked by uid 500); 30 Apr 2014 02:01:06 -0000
Mailing-List: contact dev-help@commons.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:dev-help@commons.apache.org>
List-Unsubscribe: <mailto:dev-unsubscribe@commons.apache.org>
List-Post: <mailto:dev@commons.apache.org>
List-Id: <dev.commons.apache.org>
Reply-To: "Commons Developers List" <dev@commons.apache.org>
Delivered-To: mailing list dev@commons.apache.org
Received: (qmail 41640 invoked by uid 99); 30 Apr 2014 02:01:06 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 30 Apr 2014 02:01:06 +0000
X-ASF-Spam-Status: No, hits=2.2 required=5.0
	tests=HTML_MESSAGE,RCVD_IN_DNSWL_NONE,SPF_PASS
X-Spam-Check-By: apache.org
Received-SPF: pass (athena.apache.org: domain of paulus.benedictus@gmail.com
 designates 209.85.192.50 as permitted sender)
Received: from [209.85.192.50] (HELO mail-qg0-f50.google.com) (209.85.192.50)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 30 Apr 2014 02:01:02 +0000
Received: by mail-qg0-f50.google.com with SMTP id 63so1176212qgz.37
        for <dev@commons.apache.org>; Tue, 29 Apr 2014 19:00:42 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20120113;
        h=mime-version:sender:in-reply-to:references:date:message-id:subject
         :from:to:content-type;
        bh=4Dc7APGvbY5OqZMw7EjlgQdfs/5UL10E7XDshSmo1Co=;
        b=x7bDzWeaKzFUhXZTXlvDEf1+UGZ+hZfEotTe3WQTX4AL0EUeNTZ77U8tMlgZKx80Sg
         S4bcS9hPGQoFRd7hE5JU37MASiZd8En9dJRStlePS51Kmn3wnxKQmOsiLZ9miwcYw5mo
         qHpoc1mH0OVsP05HIyeMo9pGe9SQ+o8FZhrCttUw7VNVkIOP0kq2l4iFTEDlOA6xagL2
         bRS2886QXAVmYnfHnBpng9etFMfQkRKbeSYoPj8FYg23ordeqTW4foZdbuWE7bzJ+jUi
         CqLjF2p/a9Tb0yNTAIS2l1ctNT6l/L/LyoKtHQnWTZf5h6Eo1eTtBpGv6uHbvsNTMgLQ
         L0jg==
MIME-Version: 1.0
X-Received: by 10.140.100.203 with SMTP id s69mr1434099qge.106.1398823242236;
 Tue, 29 Apr 2014 19:00:42 -0700 (PDT)
Sender: paulus.benedictus@gmail.com
Received: by 10.96.193.100 with HTTP; Tue, 29 Apr 2014 19:00:42 -0700 (PDT)
In-Reply-To: 
 <CACZkXPyv+QCtaMEvG0TZEJ1Qjsak_jwX9JBnQ2nVwRrBQC+PbA@mail.gmail.com>
References: <20140430020316.00000b43.ecki@zusammenkunft.net>
	<CACZkXPwGa6sKeEJZE-EB=Z8W6eVonh4JfdsVB6+2nuE1tt7jyw@mail.gmail.com>
	<20140430023541.00003d60.ecki@zusammenkunft.net>
	<CACZkXPwe8VH9X_AS6Fb05mwAkEzb6C4FBd8bKGyVPTzpFPE30w@mail.gmail.com>
	<CABLGb9wXA6fhq_dxhCprOgUav4Wyz=gfms+1gubPbUskBFfx3w@mail.gmail.com>
	<CACZkXPyv+QCtaMEvG0TZEJ1Qjsak_jwX9JBnQ2nVwRrBQC+PbA@mail.gmail.com>
Date: Tue, 29 Apr 2014 21:00:42 -0500
X-Google-Sender-Auth: 1eIpyFf9fWFz6qT-xUVtjWuOfcM
Message-ID: 
 <CABLGb9zJB4RDX3bK0ndJr=8rrWwwzhSD8rfFHT8sw2ezNBu5+w@mail.gmail.com>
Subject: Re: JDK8 compatible javadoc
From: Paul Benedict <pbenedict@apache.org>
To: Commons Developers List <dev@commons.apache.org>
Content-Type: multipart/alternative; boundary=001a1134f8607555f804f838ea87
X-Virus-Checked: Checked by ClamAV on apache.org

--001a1134f8607555f804f838ea87
Content-Type: text/plain; charset=UTF-8

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

--001a1134f8607555f804f838ea87--