bugzilla: Regenerate man page

crobinso · crobinso · commit ee8559a137e6 · 2016-05-25T07:47:55.000-04:00
diff --git a/bugzilla.1 b/bugzilla.1
@@ -1,4 +1,4 @@
-.TH bugzilla 1  "September 22, 2015" "version 1.2.2" "User Commands"
+.TH bugzilla 1  "May 25, 2016" "version 1.2.2" "User Commands"
 .SH NAME
 bugzilla \- command-line interface to Bugzilla over XML-RPC
 .SH SYNOPSIS
@@ -32,12 +32,12 @@ show this help message and exit
 bugzilla XMLRPC URI. default: https://bugzilla.redhat.com/xmlrpc.cgi
 .IP "--nosslverify"
 Don't error on invalid bugzilla SSL certificate
-.IP "--user=USER"
-Optional bugzilla login username
-.IP "--password=PASSWORD"
-Optional bugzilla login password
 .IP "--login"
 Run interactive "login" before performing the specified command.
+.IP "--username=USERNAME"
+Log in with this username
+.IP "--password=PASSWORD"
+Log in with this password
 .IP "--ensure-logged-in"
 Raise an error if we aren't logged in to bugzilla. Consider using this if you are depending on cached credentials, to ensure that when they expire the tool errors, rather than subtly change output.
 .IP "--no-cache-credentials"
@@ -325,19 +325,20 @@ should work, like --bug_status becomes %{bug_status}, etc.
 .SH AUTHENTICATION COOKIES AND TOKENS
 
 Older bugzilla instances use cookie-based authentication, and
-bugzilla.redhat.com uses a non-cookie token system.
+newer bugzilla instances (around 5.0) use a non-cookie token system.
 
 When you log into bugzilla with the "login" subcommand or the "--login"
-argument, we cache the cookie in ~/.bugzillacookies. If you are using
-bugzilla.redhat.com, we also cache the token in ~/.bugzillatoken.
+argument, we cache the login credentials in ~/.cache/python-bugzilla/
+Previously we cached credentials in ~/.<filename>. If you want to see
+which file the tool is using, check --debug output.
 
 To perform an authenticated bugzilla command on a new machine, run a one time
 "bugzilla login" to cache credentials before running the desired command. You
 can also run "bugzilla --login" and the login process will be initiated before
 invoking the command.
 
 Additionally, the --no-cache-credentials option will tell the bugzilla tool to
-_not_ save any credentials to ~/.bugzillacookies or ~/.bugzillatoken.
+_not_ save any credentials in $HOME, or use any previously cached credentials.
 
 .SH EXAMPLES
 .PP
