summaryrefslogtreecommitdiffstats
path: root/contrib/bugzilla-submit
diff options
context:
space:
mode:
authorkiko%async.com.br <>2004-07-16 11:52:34 +0200
committerkiko%async.com.br <>2004-07-16 11:52:34 +0200
commit8114329f09d699b6ef6251da4d9c88a8488016fd (patch)
tree52006af57d721e648649a16dfb974c2c91f31af9 /contrib/bugzilla-submit
parentca56edb97f447bcb6aaba950528f5384219f1b36 (diff)
downloadbugzilla-8114329f09d699b6ef6251da4d9c88a8488016fd.tar.gz
bugzilla-8114329f09d699b6ef6251da4d9c88a8488016fd.tar.xz
Updating manpage for bugzilla-submit, part of bug 244324:
bugzilla-submit crashed.
Diffstat (limited to 'contrib/bugzilla-submit')
-rw-r--r--contrib/bugzilla-submit/bugzilla-submit.xml24
1 files changed, 22 insertions, 2 deletions
diff --git a/contrib/bugzilla-submit/bugzilla-submit.xml b/contrib/bugzilla-submit/bugzilla-submit.xml
index 2ffa9b601..ada0c475b 100644
--- a/contrib/bugzilla-submit/bugzilla-submit.xml
+++ b/contrib/bugzilla-submit/bugzilla-submit.xml
@@ -53,7 +53,11 @@ instance specified by the single positional argument. Login/password
credentials are read from the calling user's <filename>~/.netrc</filename>
file.</para>
-<para>The program accepts the following options to set or override fields:</para>
+<para>bugzilla-submit accepts a single argument:
+<replaceable>bugzilla-url</replaceable>. Its value must match the
+relevant Bugzilla instance's base URL (technically, its
+<replaceable>urlbase</replaceable> param). The program also accepts the
+following options to set or override fields:</para>
<variablelist>
<varlistentry>
<term>-b. --bug-status</term>
@@ -187,7 +191,23 @@ the bug is to be submitted.</para>
<listitem><para>Must contain an entry in which the machine field is
the Bugzilla instance URL, the login field is your ID on that host, and the
password field is the right password. The URL in the machine field
-must be enclosed in double quotes.</para></listitem>
+must be enclosed in double quotes.</para>
+
+<para>For example, if your Bugzilla instance is at
+"http://landfill.bugzilla.org/bztest/", and your login and password
+there are "john@doe.com" and "foo", respectively, your
+<filename>.netrc</filename> entry should look something like:</para>
+
+<screen>
+machine "http://landfill.bugzilla.org/bztest/"
+login john@doe.com
+password foo
+</screen>
+
+Note that the machine entry should match exactly the instance URL
+specified to <application>bugzilla-submit</application>.
+
+</listitem>
</varlistentry>
</variablelist>