1 files changed, 46 insertions, 0 deletions
diff --git a/contrib/bug-bugzilla/README b/contrib/bug-bugzilla/README
new file mode 100644
index 000000000..08bc3d85c
--- /dev/null
+++ b/contrib/bug-bugzilla/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.
+