commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Benedikt Ritter <>
Subject [LANG] Document API breakage in FastDateFormat in JavaDoc?
Date Tue, 24 Dec 2013 08:51:51 GMT

we have this API breakage in FastDateFormat between 3.1 and the upcoming
3.2 release [1]. Gary suggested to make this explicit in the JavaDoc of
FastDateFormat [2].

I personally don't like this idea for the following reasons:
- JavaDoc is about the functionality of a class. It is no migration guide.
- The information already is in two places: RELEASE_NOTES and Clirr
- In this special case it is very unlikely that users will even notice this

I like to hear other opinions on this before I cut the next release.




  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message