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: u...@thetaphi.de > > >> -----Original Message----- >> From: Mark Miller [mailto:markrmil...@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-unsubscr...@lucene.apache.org >>> For additional commands, e-mail: java-dev-h...@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-unsubscr...@lucene.apache.org >> For additional commands, e-mail: java-dev-h...@lucene.apache.org >> > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: java-dev-unsubscr...@lucene.apache.org > For additional commands, e-mail: java-dev-h...@lucene.apache.org > > -- - Mark http://www.lucidimagination.com --------------------------------------------------------------------- To unsubscribe, e-mail: java-dev-unsubscr...@lucene.apache.org For additional commands, e-mail: java-dev-h...@lucene.apache.org
