lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Uwe Schindler" <...@thetaphi.de>
Subject RE: [jira] Created: (LUCENE-1862) duplicate package.html files in queryParser and analsysis.cn packages
Date Thu, 27 Aug 2009 15:26:36 GMT
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


Mime
View raw message