openjpa-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Donald Woods <>
Subject Re: Documenting incompatibilities between releases
Date Mon, 02 Feb 2009 21:27:01 GMT
+1 for adding to Release Notes and to the manual (appendix is fine, as 
long as there is a link to the info in the Intro section.)

What about the 1.2.1 and 1.3.0 releases - should we mention the upcoming 
change and/or mark the method as deprecated?  Should we also think about 
adding the new method to those releases so users can start migrating now?


Dianne Richards wrote:
> Because the JPA 2.0 spec is adding a Map<String,Object> getProperties()
> method to the EntityManagerFactory interface, I've been forced to change the
> Properties getProperties() method on the OpenJPAEntityManagerFactory to
> return a Map instead of a Properties object. This creates an incompatibility
> with the 1.x.x releases that could break an application that uses this
> method. I plan to document this in the Release Notes. Let me know if you
> don't agree with this. I also have considered adding a new Appendix to the
> manual titled Migration Considerations, and adding this detail. I'd like to
> hear opinions on this idea. Also, is there anyplace else where this should
> be documented.

View raw message