True enough - I don't think its super important for release that the
private javadocs are 100% valid. Buts its nice if it is regardless :)
Uwe Schindler wrote:
> Javadoc should normally only contain public methods/classes. Ony developers
> maybe want to have javadocs with all classes.
>
> -----
> Uwe Schindler
> H.-H.-Meier-Allee 63, D-28213 Bremen
> http://www.thetaphi.de
> eMail: uwe@thetaphi.de
>
>
>> -----Original Message-----
>> From: Mark Miller [mailto:markrmiller@gmail.com]
>> Sent: Thursday, August 27, 2009 5:23 PM
>> To: java-dev@lucene.apache.org
>> Subject: Re: [jira] Created: (LUCENE-1862) duplicate package.html files in
>> queryParser and analsysis.cn packages
>>
>> Chris Hostetter wrote:
>>
>>> : > you obviously haven't tried "ant javadocs -Djavadoc.access=private"
>>>
>> lately
>>
>>> : > ... i'm working on cleaning that up at the moment.
>>>
>>> : tried it? I'm not even aware of it. Not mentioned in the release todo.
>>>
>>> yeah ... it's admittedly esoteric, but it helps surface bugs in docs on
>>> private level methods (which are useful for long term maintence)
>>>
>>> i'm thinking we should change the nightly build to set
>>> -Djavadoc.access=private so we at least expose more errors earlier.
>>> (assuming we also setup the hudson to report stats on javadoc
>>> warnings ... i've seen it in other instances but don't know if it
>>>
>> requires
>>
>>> a special plugin)
>>>
>>>
>>> -Hoss
>>>
>>>
>>> ---------------------------------------------------------------------
>>> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
>>> For additional commands, e-mail: java-dev-help@lucene.apache.org
>>>
>>>
>>>
>> If it gives more errors, shouldnt it be set always and everywhere? Why
>> not ...
>>
>> --
>> - Mark
>>
>> http://www.lucidimagination.com
>>
>>
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
>> For additional commands, e-mail: java-dev-help@lucene.apache.org
>>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
> For additional commands, e-mail: java-dev-help@lucene.apache.org
>
>
--
- Mark
http://www.lucidimagination.com
---------------------------------------------------------------------
To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org
For additional commands, e-mail: java-dev-help@lucene.apache.org
|