.

go/zodb/connection.go

@@ -23,7 +23,9 @@ import (
 	"lab.nexedi.com/kirr/neo/go/zodb/internal/weak"
 )
 
-// Connection represents an isolated view of ZODB database. XXX + live application objects.
+// Connection represents an isolated application-level view of ZODB database. XXX + live application objects.
+//
+// The view is represented by IPersistent objects associated with the connection.
 //
 // The view is representing state of ZODB objects as of `at` transaction.
 //

go/zodb/persistent.go

@@ -437,7 +437,7 @@ type Broken struct {
 	state *mem.Buf
 }
 
-type brokenState Broken
+type brokenState Broken // hide state methods from public API
 
 func (b *brokenState) DropState() {
 	b.state.XRelease()

go/zodb/zodbpy.go

@@ -37,8 +37,9 @@ type PyStateful interface {
 }
 
 // pySetState decodes raw state as zodb/py serialized stream, and sets decoded
-// state on PyStateful obj. It is an error if decoded state has python class
-// not as specified.
+// state on PyStateful obj.
+//
+// It is an error if decoded state has python class not as specified.
 func pySetState(obj PyStateful, objClass string, state *mem.Buf) error {
 	pyclass, pystate, err := PyData(state.Data).Decode()
 	if err != nil {