From 4d5799ba61bd0d5be1a7148c8b2fff6db1871a01 Mon Sep 17 00:00:00 2001 From: "kiko%async.com.br" <> Date: Fri, 31 Oct 2003 22:00:19 +0000 Subject: 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 and myself. a=justdave --- contrib/bugzilla-submit/bugzilla-submit.xml | 199 ++++++++++++++++++++++++++++ 1 file changed, 199 insertions(+) create mode 100644 contrib/bugzilla-submit/bugzilla-submit.xml (limited to 'contrib/bugzilla-submit/bugzilla-submit.xml') diff --git a/contrib/bugzilla-submit/bugzilla-submit.xml b/contrib/bugzilla-submit/bugzilla-submit.xml new file mode 100644 index 000000000..da8a34c77 --- /dev/null +++ b/contrib/bugzilla-submit/bugzilla-submit.xml @@ -0,0 +1,199 @@ + + + + +bug-bugzilla +1 +Oct 30, 2003 + + +bug-bugzilla +post bugs to a Bugzilla instance + + + + + bug-bugzilla + --status bug_status + --url bug_file_loc + --product product + --version version + --component component + --summary short_desc + --hardware rep_platform + --os op_sys + --priority priority + --severity bug_severity + --assigned-to assigned-to + --cc cc + --keywords keywords + --depends-on dependson + --blocked blocked + --description comment + --no-read + bugzilla-url + + + + +DESCRIPTION + +bug-bugzilla is a command-line tool +for posting bug reports to any instance of Bugzilla. It accepts on +standard input text resembling an RFC-822 message. The headers of +that message, and its body, are used to set error-report field values. +More field values are merged in from command-line options. If required +fields have not been set, bug-bugzilla +tries to compute them. Finally, the resulting error report is +validated. If all required fields are present, and there are no +illegal fields or values, the report is shipped off to the Mozilla +instance specified by the single positional argument. Login/password +credentials are read from the calling user's ~/.netrc +file. + +The program accepts the following options to set or override fields: + + +-b. --bug-status + +Set the bug_status field, overriding the Status header from +standard input if present. (The stock Bugzilla web presentation +identifies this field as Status.) + + + +-u, --url + +Set the bug_file_loc field, overriding the URL header from +standard input if present. (The stock Bugzilla web presentation +identifies this field as URL.) + + + +-p, --product + +Set the product field, overriding the Product header from +standard input if necessary. + + + +-v, --version +Set the version field, overriding the Version header +from standard input if necessary. + + +-c, --component +Set the component field, overriding the Component header +from standard input if necessary. + + +-s, --summary +Set the short_desc field, overriding the Summary header +from standard input if necessary. (The stock Bugzilla web presentation +identifies this field as Summary.) + + +-H, --hardware +Set the rep_platform field, overriding the Hardware header +from standard input if necessary. (The stock Bugzilla web presentation +identifies this field as Hardware.) + + +-o, --os +Set the op_sys field, overriding the Operating-System header +from standard input if necessary. (The stock Bugzilla web presentation +identifies this field as OS.) + + +-r, --priority +Set the priority field, overriding the Priority header +from standard input if necessary. + + +-x, --severity +Set the severity field, overriding the Severity header +from standard input if necessary. + + +-d, --description +Set the comment field, overriding the Description header +from standard input if necessary. (The stock Bugzilla web presentation +identifies this field as Description.) If there is a +message body and no Description field and this option is not +specified, the message body is used as a description. + + + +-a, --assigned-to + +Set the optional assigned_to field, overriding the Assigned-To +header from standard input if necessary. + + + +-C, --cc + +Set the optional cc field, overriding the Cc +header from standard input if necessary. + + + +-k, --keywords + +Set the optional keywords field, overriding the Keywords +header from standard input if necessary. + + + +-D, --depends-on + +Set the optional dependson field, overriding the Depends-On +header from standard input if necessary. + + + +-B, --assigned-to + +Set the optional blocked field, overriding the Blocked +header from standard input if necessary. + + + +-n, --no-stdin +Suppress reading fields from standard input. + + +-h, --help +Print usage help and exit. + + + +This program will try to deduce OS and Hardware if those are not +specified. If it fails, validation will fail before shipping the +report. + +There is expected to be a single positional argument following +any options. It should be the URL of the Bugzilla instance to which +the bug is to be submitted. + + +FILES + + +~/.netrc +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. + + + + +AUTHORS +Christian Reis <kiko@async.com.br>, Eric S. Raymond +<esr@thyrsus.com>. + + + -- cgit v1.2.3-24-g4f1b