.

go/zodb/storage/fs1/filestorage.go

@@ -17,11 +17,11 @@
 // See COPYING file for full licensing terms.
 // See https://www.nexedi.com/licensing for rationale and options.
 
+// Package fs1 implements so-called FileStorage v1 ZODB storage.
+// FileStorage is a single file organized as a log of transactions with data changes.
+//
 // XXX partly based on code from ZODB ?
 // TODO link to format in zodb/py
-
-// Package fs1 implements so-called FileStorage v1 ZODB storage.
-// XXX text
 package fs1
 
 import (

go/zodb/storage/fs1/fs1tools/main.go

@@ -24,7 +24,15 @@ import "lab.nexedi.com/kirr/neo/go/zodb/zodbtools"
 
 var commands = zodbtools.CommandRegistry{
 	{"tail",    tailSummary,    tailUsage,    tailMain},
+	// dump, dump+verbose 	(fsdump.py)
+	// + fsstats?		(fsstats.py)
+
 	{"reindex", reindexSummary, reindexUsage, reindexMain},
+	// XXX reindex -> reindex, verify-index
+	// recover		(fsrecover.py)
+	// verify		(fstest.py)
+
+	// XXX repozo ?
 }
 
 var helpTopics = zodbtools.HelpRegistry{

go/zodb/storage/fs1/fs1tools/tail.go

@@ -79,6 +79,7 @@ func Tail(w io.Writer, path string, ntxn int) (err error) {
 	// use sequential IO buffer
 	fSeq := xbufio.NewSeqReaderAt(f)
 
+	// XXX -> LoadPrev starting @ NextPrevStartMagic ?
 	// start iterating at tail.
 	// this should get EOF but read txnh.LenPrev ok.
 	err = txnh.Load(fSeq, topPos, fs1.LoadAll)