From 6b607da839992bead01d7cba308f216e17eed520 Mon Sep 17 00:00:00 2001 From: "barnboy%trilobyte.net" <> Date: Thu, 8 Mar 2001 13:35:44 +0000 Subject: Documentation update; added docs/sgml, docs/html, docs/txt. No text version of The Bugzilla Guide availabe yet, however. --- docs/sgml/patches.sgml | 209 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 209 insertions(+) create mode 100644 docs/sgml/patches.sgml (limited to 'docs/sgml/patches.sgml') diff --git a/docs/sgml/patches.sgml b/docs/sgml/patches.sgml new file mode 100644 index 000000000..0992bde0d --- /dev/null +++ b/docs/sgml/patches.sgml @@ -0,0 +1,209 @@ + + + + Useful Patches and Utilities for Bugzilla + +
+ The setperl.pl Utility + + You can use the "setperl.pl" utility to quickly and easily + change the path to perl on all your Bugzilla files. + + + + + Download the "setperl.pl" utility to your Bugzilla + directory and make it executable. + + + + + + bash# + cd /your/path/to/bugzilla + + + + + + + bash# + wget -O setperl.pl 'http://bugzilla.mozilla.org/showattachment.cgi?attach_id=10795' + + + + + + + bash# + chmod u+x setperl.pl + + + + + + + + Prepare (and fix) Bugzilla file permissions. + + + + + + bash# + chmod u+w * + + + + + + + bash# + chmod u+x duplicates.cgi + + + + + + + bash# + chmod a-x bug_status.html + + + + + + + + Run the script: + + + + bash# + ./setperl.pl /your/path/to/perl + + + + +
+ +
+ Command-line Bugzilla Queries + + Users can query Bugzilla from the command line using + this suite of utilities. + + + The query.conf file contains the mapping from options to field + names and comparison types. Quoted option names are "grepped" for, so + it should be easy to edit this file. Comments (#) have no effect; you + must make sure these lines do not contain any quoted "option" + + + buglist is a shell script which submits a Bugzilla query and writes the + resulting HTML page to stdout. It supports both short options, + (such as "-Afoo" or "-Rbar") and long options (such as + "--assignedto=foo" or "--reporter=bar"). If the first character + of an option is not "-", it is treated as if it were prefixed + with "--default=". + + + The columlist is taken from the COLUMNLIST environment variable. + This is equivalent to the "Change Columns" option when you list + bugs in buglist.cgi. If you have already used Bugzilla, use + grep COLUMLIST ~/.netscape/cookies to see + your current COLUMNLIST setting. + + + bugs is a simple shell script which calls buglist and extracts + the bug numbers from the output. Adding the prefix + "http://bugzilla.mozilla.org/buglist.cgi?bug_id=" + turns the bug list into a working link if any bugs are found. + Counting bugs is easy. Pipe the results through + sed -e 's/,/ /g' | wc | awk '{printf $2 "\n"}' + + + Akkana says she has good results piping buglist output through + w3m -T text/html -dump + + + + + Download three files: + + + + + + bash$ + wget -O query.conf 'http://bugzilla.mozilla.org/showattachment.cgi?attach_id=26157' + + + + + + + bash$ + wget -O buglist 'http://bugzilla.mozilla.org/showattachment.cgi?attach_id=26944' + + + + + + + bash# + wget -O bugs 'http://bugzilla.mozilla.org/showattachment.cgi?attach_id=26215' + + + + + + + + Make your utilities executable: + + bash$ + chmod u+x buglist bugs + + + + +
+ +
+ The Quicksearch Utility + + Quicksearch is a new, experimental feature of the 2.12 release. + It consist of two Javascript files, "quicksearch.js" and "localconfig.js", + and two documentation files, "quicksearch.html" and "quicksearchhack.html" + + + The index.html page has been updated to include the QuickSearch text box. + + + To take full advantage of the query power, the Bugzilla maintainer must + edit "localconfig.js" according to the value sets used in the local installation. + + + Currently, keywords must be hard-coded in localconfig.js. If they are not, + keywords are not automatically recognized. This means, if localconfig.js + is left unconfigured, that searching for a bug with the "foo" keyword + will only find bugs with "foo" in the summary, status whiteboard, product or + component name, but not those with the keyword "foo". + + + Workarounds for Bugzilla users: + + search for '!foo' (this will find only bugs with the keyword "foo" + search 'foo,!foo' (equivalent to 'foo OR keyword:foo') + + + + When this tool is ported from client-side JavaScript to server-side Perl, + the requirement for hard-coding keywords can be fixed. + This bug + has details. + +
+ + \ No newline at end of file -- cgit v1.2.3-24-g4f1b