lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Mark Miller <markrmil...@gmail.com>
Subject Re: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages
Date Thu, 27 Aug 2009 15:28:52 GMT
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


Mime
View raw message