prepare for 0.5.9 tools release

doc/guide/JavaCodeGeneration.md

@@ -132,7 +132,7 @@ The generated code has JPA annotations to allow storing in RDBs with compliant s
 
 Operations are not in general cascaded into references - so that the references need to be explicitly managed. In most cases this will be the "natural" way to do things 
 for the model - however at creation time it might be inconvenient to do this so that there is a method
-`persistRefs(jakarta.persistence.EntityManager _em)` that will do a deep persist of any references in the child objects, which in turn then will allow an error free persist of the parent. 
+`persistRefs(jakarta.persistence.EntityManager _em)` on the model that will do a deep persist of any references in the child objects, which in turn then will allow an error free persist of the content. Note that in general it is only possible to run the persistRefs once all of the content has been added to the model, and only for the first time a reference is created - for subsequent updates of the model it will be necessary to manage the references manually. 
 
 In general collections are marked for lazy loading, and as a convenience there is a `forceLoad()`
 method generated that will do a deep walk of all the collections in a particular type, which will force the loading of the whole instance tree if that is desired.

models/ivoa/build.gradle.kts

@@ -1,5 +1,5 @@
 plugins {
-    id("net.ivoa.vo-dml.vodmltools") version "0.5.8"
+    id("net.ivoa.vo-dml.vodmltools") version "0.5.9"
 //    id ("com.diffplug.spotless") version "5.17.1"
     `maven-publish`
     id("io.github.gradle-nexus.publish-plugin") version "1.3.0"

tools/ChangeLog.md

@@ -60,5 +60,6 @@
   * Added support for validation against IVOA vocabularies
   * Added support for rdb serialization of primitive attributes with unbounded multiplicity as colon separated string
 * 0.5.8 - a release mainly cleaning up some internals
+* 0.5.9 - redo how references are managed.
 
 N.B hibernate 6.6 does not like @embeddable amd @mapped-superclass - fixed in 6.6.1

tools/gradletooling/gradle-plugin/build.gradle.kts

@@ -14,7 +14,7 @@ plugins {
 }
 
 group = "net.ivoa.vo-dml"
-version = "0.5.8"
+version = "0.5.9"
 
 repositories {
     mavenLocal() // FIXME remove this when releasing - just here to pick up local vodsl updates