5824: Clarity edits in usage docs.

diff --git a/services/keep-web/anonymous.go b/services/keep-web/anonymous.go
index 85ea1c6933111b10c16717668b878867a3580f0b..bfc716f2b2b865d9a12577bcca41812e7252f4e9 100644 (file)
--- a/services/keep-web/anonymous.go
+++ b/services/keep-web/anonymous.go
@@ -20,5 +20,5 @@ func (ts *tokenSet) String() string {
 
 func init() {
        flag.Var(&anonymousTokens, "anonymous-token",
-               "API token to try when none of the tokens provided in an HTTP request succeed in reading the desired collection. If this flag is used more than once, each token will be attempted in turn until one works.")
+               "API token to try when none of the tokens provided in an HTTP request succeed in reading the desired collection. Multiple anonymous tokens can be provided by using this flag more than once; each token will be attempted in turn until one works.")
 }

diff --git a/services/keep-web/doc.go b/services/keep-web/doc.go
index 2ebda6ef72523ed66263007329e3093c32b763e2..5aa09e20a455b979954855cd4367224b36900c69 100644 (file)
--- a/services/keep-web/doc.go
+++ b/services/keep-web/doc.go
@@ -93,8 +93,8 @@
 //
 // In all of the above forms, the "uuid_or_pdh" part can be either a
 // collection UUID or a portable data hash with the "+" character
-// optionally replaced by "-". (Replacing "+" with "-" is mandatory
-// when "uuid_or_pdh" appears in the domain name only because "+" is
+// optionally replaced by "-". (When "uuid_or_pdh" appears in the
+// domain name, replacing "+" with "-" is mandatory, because "+" is
 // not a valid character in a domain name.)
 //
 // In all of the above forms, a top level directory called "_" is