go/zodb/zodbtools: Minor godoc cosmetics

go/zodb/zodbtools/catobj.go

-// Copyright (C) 2017  Nexedi SA and Contributors.
-//                     Kirill Smelkov <kirr@nexedi.com>
+// Copyright (C) 2017-2019  Nexedi SA and Contributors.
+//                          Kirill Smelkov <kirr@nexedi.com>
 //
 // This program is free software: you can Use, Study, Modify and Redistribute
 // it under the terms of the GNU General Public License version 3, or (at your
@@ -49,7 +49,7 @@ func Catobj(ctx context.Context, w io.Writer, stor zodb.IStorage, xid zodb.Xid)
 	return err
 }
 
-// Dumpobj dumps content of one ZODB object with zodbdump-like header
+// Dumpobj dumps content of one ZODB object with zodbdump-like header.
 func Dumpobj(ctx context.Context, w io.Writer, stor zodb.IStorage, xid zodb.Xid, hashOnly bool) error {
 	var objInfo zodb.DataInfo
 

go/zodb/zodbtools/dump.go

-// Copyright (C) 2016-2017  Nexedi SA and Contributors.
+// Copyright (C) 2016-2019  Nexedi SA and Contributors.
 //                          Kirill Smelkov <kirr@nexedi.com>
 //
 // This program is free software: you can Use, Study, Modify and Redistribute
@@ -67,7 +67,7 @@ import (
 )
 
 
-// dumper dumps zodb record to a writer
+// dumper dumps zodb record to a writer.
 type dumper struct {
 	W          io.Writer
 	HashOnly   bool		// whether to dump only hashes of data without content
@@ -80,7 +80,7 @@ type dumper struct {
 var _LF = []byte{'\n'}
 
 
-// DumpData dumps one data record
+// DumpData dumps one data record.
 func (d *dumper) DumpData(datai *zodb.DataInfo) (err error) {
 	// XXX do we need this context ?
 	// see for rationale in similar place in DumpTxn
@@ -139,7 +139,7 @@ func (d *dumper) DumpData(datai *zodb.DataInfo) (err error) {
 	return err
 }
 
-// DumpTxn dumps one transaction record
+// DumpTxn dumps one transaction record.
 func (d *dumper) DumpTxn(ctx context.Context, txni *zodb.TxnInfo, dataIter zodb.IDataIterator) (err error) {
 	// XXX do we need this context ?
 	// rationale: dataIter.NextData() if error in db - will include db context
@@ -185,7 +185,7 @@ func (d *dumper) DumpTxn(ctx context.Context, txni *zodb.TxnInfo, dataIter zodb.
 	return err
 }
 
-// Dump dumps transaction records in between tidMin..tidMax
+// Dump dumps transaction records in between tidMin..tidMax .
 func (d *dumper) Dump(ctx context.Context, stor zodb.IStorage, tidMin, tidMax zodb.Tid) error {
 	var txni     *zodb.TxnInfo
 	var dataIter zodb.IDataIterator

go/zodb/zodbtools/info.go

-// Copyright (C) 2017  Nexedi SA and Contributors.
-//                     Kirill Smelkov <kirr@nexedi.com>
+// Copyright (C) 2017-2019  Nexedi SA and Contributors.
+//                          Kirill Smelkov <kirr@nexedi.com>
 //
 // This program is free software: you can Use, Study, Modify and Redistribute
 // it under the terms of the GNU General Public License version 3, or (at your
@@ -32,7 +32,7 @@ import (
 	"lab.nexedi.com/kirr/neo/go/zodb"
 )
 
-// paramFunc is a function to retrieve 1 storage parameter
+// paramFunc is a function to retrieve 1 storage parameter.
 type paramFunc func(ctx context.Context, stor zodb.IStorage) (string, error)
 
 var infov = []struct {name string; getParam paramFunc} {
@@ -56,7 +56,7 @@ func init() {
 	}
 }
 
-// Info prints general information about a ZODB storage
+// Info prints general information about a ZODB storage.
 func Info(ctx context.Context, w io.Writer, stor zodb.IStorage, parameterv []string) error {
 	wantnames := false
 	if len(parameterv) == 0 {

go/zodb/zodbtools/main.go

@@ -17,7 +17,7 @@
 // See COPYING file for full licensing terms.
 // See https://www.nexedi.com/licensing for rationale and options.
 
-// Package zodbtools provides tools for managing ZODB databases
+// Package zodbtools provides tools for managing ZODB databases.
 package zodbtools
 
 import "lab.nexedi.com/kirr/go123/prog"