aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/bugzilla-submit/README
diff options
context:
space:
mode:
authorkiko%async.com.br <>2003-10-31 22:00:19 +0000
committerkiko%async.com.br <>2003-10-31 22:00:19 +0000
commit4d5799ba61bd0d5be1a7148c8b2fff6db1871a01 (patch)
treee8e20a55f278d04d4e2d6f74cf239d26722d7d92 /contrib/bugzilla-submit/README
parent5a0e0a7735ff396d0a58b8c2d20b16cb0bcf6979 (diff)
downloadbugs-4d5799ba61bd0d5be1a7148c8b2fff6db1871a01.tar
bugs-4d5799ba61bd0d5be1a7148c8b2fff6db1871a01.tar.gz
bugs-4d5799ba61bd0d5be1a7148c8b2fff6db1871a01.tar.bz2
bugs-4d5799ba61bd0d5be1a7148c8b2fff6db1871a01.tar.xz
bugs-4d5799ba61bd0d5be1a7148c8b2fff6db1871a01.zip
Fix for Bug 220724: Provide standalone bug submission program. Includes
a python script that submits bugs to a specified Bugzilla instance. README, docs and an example bug are included. Work done by Eric Raymond <esr@thyrsus.com> and myself. a=justdave
Diffstat (limited to 'contrib/bugzilla-submit/README')
-rw-r--r--contrib/bugzilla-submit/README46
1 files changed, 46 insertions, 0 deletions
diff --git a/contrib/bugzilla-submit/README b/contrib/bugzilla-submit/README
new file mode 100644
index 000000000..08bc3d85c
--- /dev/null
+++ b/contrib/bugzilla-submit/README
@@ -0,0 +1,46 @@
+Bug-Bugzilla
+============
+
+Authors: Christian Reis <kiko@async.com.br>
+ Eric Raymond <esr@thyrsus.com>
+
+Bug-Bugzilla is a simple Python program that creates bugs in a Bugzilla
+instance. It takes as input text resembling message headers (RFC-822
+formatted) via standard input, or optionally a number of commandline
+parameters. It communicates using HTTP, which allows it to work over a
+network.
+
+Requirements
+------------
+
+Its only requirement is Python 2.3 or higher; you should have the
+"python" executable in your path.
+
+Usage Notes
+-----------
+
+* Please constrain testing to your own installation of Bugzilla, or use
+* http://landfill.bugzilla.org/ for testing purposes -- opening test
+* bugs on production instances of Bugzilla is definitely not a good idea
+
+Run "bug-bugzilla --help" for a description of the possible options.
+
+An example input file, named bugdata.txt, is provided. You can pipe it
+in as standard input to bug-bugzilla, providing a Bugzilla URI through
+the command-line.
+
+Note that you must create a ~/.netrc entry to authenticate against the
+Bugzilla instance. The entry's machine field is a *quoted* Bugzilla URI,
+the login field is your ID on that host, and the password field is the
+your password password. An example entry follows:
+
+ machine "http://bugzilla.mozilla.org/"
+ login foo@bar.loo
+ password snarf
+
+Documentation
+-------------
+
+Documentation for bug-bugzilla is provided in Docbook format; see
+bug-bugzilla.xml.
+