X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/c978ad2d773b1ffc1ec6608123e27b89e65c428e..ba57b6537679889b42693ecd839a94d59c716aaf:/services/arv-git-httpd/usage.go

diff --git a/services/arv-git-httpd/usage.go b/services/arv-git-httpd/usage.go
index dd0ae922b5..1fb25b92f2 100644
--- a/services/arv-git-httpd/usage.go
+++ b/services/arv-git-httpd/usage.go
@@ -1,16 +1,21 @@
+// arvados-git-httpd provides authenticated access to Arvados-hosted
+// git repositories.
+//
+// See http://doc.arvados.org/install/install-arv-git-httpd.html.
 package main
 
 import (
-	"encoding/json"
 	"flag"
 	"fmt"
 	"os"
+
+	"github.com/ghodss/yaml"
 )
 
 func usage() {
 	c := defaultConfig()
 	c.Client.APIHost = "zzzzz.arvadosapi.com:443"
-	exampleConfigFile, err := json.MarshalIndent(c, "    ", "  ")
+	exampleConfigFile, err := yaml.Marshal(c)
 	if err != nil {
 		panic(err)
 	}
@@ -28,7 +33,8 @@ Options:
 	flag.PrintDefaults()
 	fmt.Fprintf(os.Stderr, `
 Example config file:
-    %s
+
+%s
 
 Client.APIHost:
 
@@ -43,18 +49,26 @@ Client.Insecure:
     True if your Arvados API endpoint uses an unverifiable SSL/TLS
     certificate.
 
-Listen:
-
-    Local port to listen on. Can be "address:port" or ":port", where
-    "address" is a host IP address or name and "port" is a port number
-    or name.
-
 GitCommand:
 
     Path to git or gitolite-shell executable. Each authenticated
     request will execute this program with the single argument
     "http-backend".
 
+GitoliteHome:
+
+    Path to Gitolite's home directory. If a non-empty path is given,
+    the CGI environment will be set up to support the use of
+    gitolite-shell as a GitCommand: for example, if GitoliteHome is
+    "/gh", then the CGI environment will have GITOLITE_HTTP_HOME=/gh,
+    PATH=$PATH:/gh/bin, and GL_BYPASS_ACCESS_CHECKS=1.
+
+Listen:
+
+    Local port to listen on. Can be "address:port" or ":port", where
+    "address" is a host IP address or name and "port" is a port number
+    or name.
+
 RepoRoot:
 
     Path to git repositories.