lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Chris Hostetter <hossman_luc...@fucit.org>
Subject Re: [jira] Issue Comment Edited: (LUCENE-1439) Inconsistent API
Date Fri, 14 Nov 2008 21:59:57 GMT

: Can anyone open an umbrella bug for this?
: I think we should first collect all inconsistencies, then someone (including me) start to
make patches.

Don't worry about it.
if you open a bunch of bugs, someone can/will group them.

: BTW one more thing I've noticed: some methods even start with uppercase.
: Common, there are books written about Lucene, such things are just painful ;)

legacy code is legacy code ... static methods with capitalized case names 
were added long ago as constructor-esque factories, probably because it 
was in voue at the time.  They may make the APIs 
inconsistent, but for all the people out there using them leaving them 
aloe has been one less thing to worry about when upgrading.

deprecating/removing methods because there signatures are confusing or 
missleading is one thing, generally a very good thing -- getting rid of 
them for aesthetics and consistency is another (less obviously good) 
thing.


-Hoss


---------------------------------------------------------------------
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