cmd/upspin-audit: use the word 'block' to describe stored data

Refererring to blocks as 'references' was getting confusing.
Hopefully this makes things clearer.

Change-Id: I6097d6b870766edcfea9ad1d17b013eea7b4473b
Reviewed-on: https://upspin-review.googlesource.com/17540
Reviewed-by: Rob Pike <r@golang.org>
Reviewed-by: David Presotto <presotto@gmail.com>
diff --git a/cmd/upspin-audit/deletegarbage.go b/cmd/upspin-audit/deletegarbage.go
index 528a6c6..913bcbd 100644
--- a/cmd/upspin-audit/deletegarbage.go
+++ b/cmd/upspin-audit/deletegarbage.go
@@ -16,11 +16,11 @@
 
 func (s *State) deleteGarbage(args []string) {
 	const help = `
-Audit delete-garbage deletes garbage references as listed by the most recent
+Audit delete-garbage deletes garbage blocks as listed by the most recent
 run of find-garbage. It operates on the store endpoint of the current user.
 
 It must be run as the same Upspin user as the store server itself,
-as only that user has permission to delete references.
+as only that user has permission to delete blocks.
 
 Misuse of this command may result in permanent data loss. Use with caution.
 `
diff --git a/cmd/upspin-audit/findgarbage.go b/cmd/upspin-audit/findgarbage.go
index cefab0d..8ebf251 100644
--- a/cmd/upspin-audit/findgarbage.go
+++ b/cmd/upspin-audit/findgarbage.go
@@ -17,7 +17,7 @@
 func (s *State) findGarbage(args []string) {
 	const help = `
 Audit find-garbage analyses the output of scan-dir and scan-store to finds
-references that are present in the store server but missing from the scanned
+blocks that are present in the store server but not referred to by the scanned
 directory trees.
 `
 	fs := flag.NewFlagSet("find-garbage", flag.ExitOnError)
diff --git a/cmd/upspin-audit/main.go b/cmd/upspin-audit/main.go
index e13856f..3b0f5fb 100644
--- a/cmd/upspin-audit/main.go
+++ b/cmd/upspin-audit/main.go
@@ -52,27 +52,27 @@
 
 scan-dir
 scan-store
-	Scan the directory and store servers and report the storage consumed
-	by those servers.
+	Scan the directory and store servers, creating a list of blocks
+	each uses, and report the total storage held by those blocks.
 
 find-garbage
 	Use the results of scan-dir and scan-store operations to create a list
-	of references that are present in a store server but not referenced
+	of blocks that are present in a store server but not referenced
 	by the scanned directory servers.
 
 delete-garbage
-	Delete the references found by find-garbage from the store server.
+	Delete the blocks found by find-garbage from the store server.
 
 To delete the garbage references in a given store server:
 1. Run scan-store (as the store server user) to generate a list of references
-   in the store server.
+   to blocks in the store server.
 2. Run scan-dir for each Upspin tree that stores data in the store server (as
-   the Upspin users that own those trees) to generate lists of references
-   referred to by those trees.
+   the Upspin users that own those trees) to generate lists of block
+   references mentioned by those trees.
 3. Run find-garbage to compile a list of references that are in the scan-store
    output but not in the combined output of the scan-dir runs.
-4. Run delete-garbage (as the store server user) to delete the references in
-   the find-garbage output.
+4. Run delete-garbage (as the store server user) to delete the blocks in the
+   find-garbage output.
 `
 
 func main() {
diff --git a/cmd/upspin-audit/scandir.go b/cmd/upspin-audit/scandir.go
index 26944de..776c029 100644
--- a/cmd/upspin-audit/scandir.go
+++ b/cmd/upspin-audit/scandir.go
@@ -48,8 +48,11 @@
 
 func (s *State) scanDirectories(args []string) {
 	const help = `
-Audit scan-dir scans the directory tree for the named user roots.
-For now it just prints the total storage consumed.`
+Audit scan-dir scans the directory trees of the named user roots and produces a
+list of store block references mentioned in those trees.
+
+It should be run as a user that has full read access to the named roots.
+`
 
 	fs := flag.NewFlagSet("scan-dir", flag.ExitOnError)
 	glob := fs.Bool("glob", true, "apply glob processing to the arguments")
diff --git a/cmd/upspin-audit/scanstore.go b/cmd/upspin-audit/scanstore.go
index 6ff0f3c..0b9d0a2 100644
--- a/cmd/upspin-audit/scanstore.go
+++ b/cmd/upspin-audit/scanstore.go
@@ -20,9 +20,9 @@
 
 func (s *State) scanStore(args []string) {
 	const help = `
-Audit scan-store scans the storage server to identify all references.
-By default it scans the storage server mentioned in the config file.
-For now it just prints the total storage they represent.
+Audit scan-store produces a list of references to the blocks held
+by the given store server.
+By default it scans the store endpoint specified by the given config.
 
 It must be run as the same Upspin user as the store server itself,
 as only that user has permission to list references.