Uniformize flag doc strings.

Change-Id: Ia116ba428a427b82db0eb6a8327046800c023bd8

cmd/slothfs-deref-manifest/main.go

diff --git a/cmd/slothfs-deref-manifest/main.go b/cmd/slothfs-deref-manifest/main.go
index 6d3e1e5..00965f4 100644
--- a/cmd/slothfs-deref-manifest/main.go
+++ b/cmd/slothfs-deref-manifest/main.go
@@ -25,8 +25,8 @@
 
 func main() {
 	gitilesOptions := gitiles.DefineFlags()
-	branch := flag.String("branch", "master", "branch to use for manifest")
-	repo := flag.String("repo", "platform/manifest", "manifest repository")
+	branch := flag.String("branch", "master", "Specify branch of the manifest repository to use.")
+	repo := flag.String("repo", "platform/manifest", "Set repository name holding manifest file.")
 	flag.Parse()
 
 	service, err := gitiles.NewService(*gitilesOptions)

cmd/slothfs-gitiles-test/main.go

diff --git a/cmd/slothfs-gitiles-test/main.go b/cmd/slothfs-gitiles-test/main.go
index 8bfe36f..50c4849 100644
--- a/cmd/slothfs-gitiles-test/main.go
+++ b/cmd/slothfs-gitiles-test/main.go
@@ -29,7 +29,7 @@
 )
 
 func main() {
-	tap := flag.Bool("tap", false, "if set, tap traffic exchanged with $http_proxy")
+	tap := flag.Bool("tap", false, "Tap traffic exchanged with $http_proxy")
 	gitilesOptions := gitiles.DefineFlags()
 	flag.Parse()
 

cmd/slothfs-gitilesfs/main.go

diff --git a/cmd/slothfs-gitilesfs/main.go b/cmd/slothfs-gitilesfs/main.go
index 3ab86f5..d08d362 100644
--- a/cmd/slothfs-gitilesfs/main.go
+++ b/cmd/slothfs-gitilesfs/main.go
@@ -28,10 +28,11 @@
 )
 
 func main() {
-	branch := flag.String("branch", "master", "branch name")
-	repo := flag.String("repo", "", "repository name")
-	debug := flag.Bool("debug", false, "print debug info")
-	cacheDir := flag.String("cache", filepath.Join(os.Getenv("HOME"), ".cache", "slothfs"), "cache dir")
+	branch := flag.String("branch", "master", "Set the branch name.")
+	repo := flag.String("repo", "", "Set the repository name.")
+	debug := flag.Bool("debug", false, "Print FUSE debug info.")
+	cacheDir := flag.String("cache", filepath.Join(os.Getenv("HOME"), ".cache", "slothfs"),
+		"Set directory for file system cache.")
 	gitilesOptions := gitiles.DefineFlags()
 	flag.Parse()
 

cmd/slothfs-manifestfs/main.go

diff --git a/cmd/slothfs-manifestfs/main.go b/cmd/slothfs-manifestfs/main.go
index 4e2cf3b..549dfd7 100644
--- a/cmd/slothfs-manifestfs/main.go
+++ b/cmd/slothfs-manifestfs/main.go
@@ -30,10 +30,11 @@
 )
 
 func main() {
-	manifestPath := flag.String("manifest", "", "expanded manifest file path")
-	cacheDir := flag.String("cache", filepath.Join(os.Getenv("HOME"), ".cache", "slothfs"), "cache dir")
-	debug := flag.Bool("debug", false, "print debug info")
-	config := flag.String("config", "", "JSON file configuring what repositories should be cloned.")
+	manifestPath := flag.String("manifest", "", "Set path to the expanded manifest file.")
+	cacheDir := flag.String("cache", filepath.Join(os.Getenv("HOME"), ".cache", "slothfs"),
+		"Set the directory holding the file system cache.")
+	debug := flag.Bool("debug", false, "Print FUSE debug info.")
+	config := flag.String("config", "", "Set path to clone configuration JSON file.")
 	gitilesOptions := gitiles.DefineFlags()
 	flag.Parse()
 

cmd/slothfs-multifs/main.go

diff --git a/cmd/slothfs-multifs/main.go b/cmd/slothfs-multifs/main.go
index 9865d78..8701ba9 100644
--- a/cmd/slothfs-multifs/main.go
+++ b/cmd/slothfs-multifs/main.go
@@ -30,9 +30,11 @@
 )
 
 func main() {
-	cacheDir := flag.String("cache", filepath.Join(os.Getenv("HOME"), ".cache", "slothfs"), "cache dir")
-	debug := flag.Bool("debug", false, "print debug info")
-	config := flag.String("config", filepath.Join(os.Getenv("HOME"), ".config", "slothfs"), "directory with configuration files.")
+	cacheDir := flag.String("cache", filepath.Join(os.Getenv("HOME"), ".cache", "slothfs"),
+		"Set the directory holding the filesystem cache.")
+	debug := flag.Bool("debug", false, "Print FUSE debug info")
+	config := flag.String("config", filepath.Join(os.Getenv("HOME"), ".config", "slothfs"),
+		"Set the directory with configuration files.")
 	gitilesOptions := gitiles.DefineFlags()
 	flag.Parse()
 

gitiles/client.go

diff --git a/gitiles/client.go b/gitiles/client.go
index d4ef53b..b5fd5e2 100644
--- a/gitiles/client.go
+++ b/gitiles/client.go
@@ -66,10 +66,10 @@
 // DefineFlags sets up standard command line flags, and returns the
 // options struct in which the values are put.
 func DefineFlags() *Options {
-	flag.StringVar(&defaultOptions.Address, "gitiles_url", "https://android.googlesource.com", "URL of the gitiles service.")
-	flag.StringVar(&defaultOptions.CookieJar, "gitiles_cookies", "", "path to cURL-style cookie jar file.")
-	flag.StringVar(&defaultOptions.UserAgent, "gitiles_agent", "slothfs", "gitiles User-Agent string to use.")
-	flag.Float64Var(&defaultOptions.SustainedQPS, "gitiles_qps", 4, "maximum Gitiles QPS")
+	flag.StringVar(&defaultOptions.Address, "gitiles_url", "https://android.googlesource.com", "Set the URL of the Gitiles service.")
+	flag.StringVar(&defaultOptions.CookieJar, "gitiles_cookies", "", "Set path to cURL-style cookie jar file.")
+	flag.StringVar(&defaultOptions.UserAgent, "gitiles_agent", "slothfs", "Set the User-Agent string to report to Gitiles.")
+	flag.Float64Var(&defaultOptions.SustainedQPS, "gitiles_qps", 4, "Set the maximum QPS to send to Gitiles.")
 	return &defaultOptions
 }