summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorOwen W. Taylor <otaylor@fishsoup.net>2010-09-06 19:30:53 -0400
committerOwen W. Taylor <otaylor@fishsoup.net>2010-09-06 19:30:53 -0400
commit31ed23c9e140669e8e430bd899313d2155098130 (patch)
treec2b71c85d25f3f3e33bdbacb32d3b1d8fb029838
parent952e408b3a0d0da1321c313003581021eaaf207a (diff)
Document new per-tracker configuration
Add documentation for 'path', 'auth-user', and 'auth-password'
-rw-r--r--git-bz.txt21
1 files changed, 16 insertions, 5 deletions
diff --git a/git-bz.txt b/git-bz.txt
index 648b4ec..e318cc2 100644
--- a/git-bz.txt
+++ b/git-bz.txt
@@ -336,11 +336,22 @@ PER-TRACKER CONFIGURATION
-------------------------
git-bz needs some configuration specific to the bugzilla instance (tracker),
in particular it needs to know initial field values to use when submitting
-bugs; legal values for some fields depend on the instance.
-
-You can also set whether to use http or https by setting the 'https' variabe
-For https, *certificates are not checked* so you are completely vulnerable
-to DNS spoofing and man-in-the-middle attacks. Blame httplib.
+bugs; legal values for some fields depend on the instance. Initial field
+values are specified by the config variable +default-<field-name>+.
+
+In addition to initial field values, some other variables can be configured
+per tracker:
+
+auth-user:: the user to use for basic HTTP authentication. Since
+ basic auth sends passwords in clear text, you should not use this unless
+ you are also using https.
+auth-password:: the password to use for basic HTTP authentication.
+https:: use https rather than http.
+ For https, *certificates are not checked* so you are completely vulnerable
+ to DNS spoofing and man-in-the-middle attacks. Blame httplib.
+path:: the root path of the bugzilla installation. If bugs are accessed
+ as http://example.com/bugzilla/show_bug.cgi, this variable would be set
+ to /bugzilla.
Configuration comes from 4 sources, in descending order of priority