.

wcfs/internal/zdata/δftail.go

@@ -319,9 +319,9 @@ func (δFtail *ΔFtail) rebuildAll() (err error) {
 	return nil
 }
 
-// rebuild1IfNeeded rebuilds vδE if there is such need.
+// rebuild1IfNeeded rebuilds vδE for a file if there is such need.
 //
-// it returns corresponding δftail for convenience. XXX
+// It also returns corresponding δftail.root for convenience.
 // the only case when vδE actually needs to be rebuilt is when the file just started to be tracked.
 //
 // XXX naming -> vδEForFile ?  vδEBuildIfNeeded?
@@ -351,7 +351,7 @@ func (δFtail *ΔFtail) rebuild1IfNeeded(foid zodb.Oid) (vδE []_ΔFileEpoch, he
 	}
 
 	// we become responsible to build vδE
-	// do the build without the lock
+	// release the lock while building
 	job = &_RebuildJob{ready: make(chan struct{})}
 	δftail.rebuildJob = job
 	δFtail.trackNew.Del(foid)