logging-log4j-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Matt Sicker <boa...@gmail.com>
Subject Re: Javadoc with v8 doclet
Date Sun, 21 Sep 2014 16:29:48 GMT
What I don't get is that the OpenJDK javadocs are still a mix of
never-touched 1.0 docs (which definitely uses the loose format), yet they
still manage to build it without fixing all their docs. There must be a way
to auto-fix everything.

On 21 September 2014 08:10, Gary Gregory <garydgregory@gmail.com> wrote:

> Bah, at some point, that will be the new normal for everyone.
>
> The best way to deal with this is to agree to build with Java 8 with
> compiler settings that generate java 6 byte codes which we already have.
>
> If we all pitch in it won't take long.
>
> Personally I do everything in Java 7 and I am migrating to 8 project by
> project.
>
> Gary
>
>
> -------- Original message --------
> From: Remko Popma
> Date:09/21/2014 07:12 (GMT-05:00)
> To: Log4J Developers List
> Subject: Re: Javadoc with v8 doclet
>
> I was a bit shocked after reading the article.
> The requirements are very strict.
>
> If you ask me what would be a better use of my time: fix outstanding jiras
> or add new features or make javadoc conform to some standard, I think out
> of those three, javadoc would benefit our users least...
>
> (I don't object to writing new javadoc according to the stricter rules, it
> just seems like a bit of a waste of time to fix the old docs.)
>
> And if we can get the benefit of the nicer looking javadoc HTML without
> paying the price of spending our valuable time to reformat etc, I'd say go
> for it!
>
>
> On Sun, Sep 21, 2014 at 7:49 PM, Gary Gregory <garydgregory@gmail.com>
> wrote:
>
>> Nah, we should just fix our comments...
>>
>> Gary
>>
>>
>> -------- Original message --------
>> From: Remko Popma
>> Date:09/20/2014 23:11 (GMT-05:00)
>> To: Developers List Log4J
>> Subject: Javadoc with v8 doclet
>>
>> Matt has mentioned a few times that he wanted to use the Javadoc format
>> produced by java 8, but the doclet is too strict.
>>
>> This blog post may have a solution for that:
>> http://blog.joda.org/2014/02/turning-off-doclint-in-jdk-8-javadoc.html
>>
>> Sent from my iPhone
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: log4j-dev-unsubscribe@logging.apache.org
>> For additional commands, e-mail: log4j-dev-help@logging.apache.org
>>
>>
>


-- 
Matt Sicker <boards@gmail.com>

Mime
View raw message