diff options
Diffstat (limited to 'contrib/gnatsparse/README')
-rwxr-xr-x | contrib/gnatsparse/README | 62 |
1 files changed, 0 insertions, 62 deletions
diff --git a/contrib/gnatsparse/README b/contrib/gnatsparse/README deleted file mode 100755 index f7cf01c68..000000000 --- a/contrib/gnatsparse/README +++ /dev/null @@ -1,62 +0,0 @@ -gnatsparse -========== - -Author: Daniel Berlin <dan@dberlin.org> - -gnatsparse is a simple Python program that imports a GNATS database -into a Bugzilla system. It is based on the gnats2bz.pl Perl script -but it's a rewrite at the same time. Its parser is based on gnatsweb, -which gives a 10 times speed improvement compared to the previous code. - -Features --------- - -* Chunks audit trail into separate comments, with the right From's, times, etc. - -* Handles followup emails that are in the report, with the right From's, times, -etc. - -* Properly handles duplicates, adding the standard bugzilla duplicate message. - -* Extracts and handles gnatsweb attachments, as well as uuencoded attachments -appearing in either followup emails, the how-to-repeat field, etc. Replaces -them with a message to look at the attachments list, and adds the standard -"Created an attachment" message that bugzilla uses. Handling them includes -giving them the right name and mime-type. "attachments" means multiple -uuencoded things/gnatsweb attachments are handled properly. - -* Handles reopened bug reports. - -* Builds the cc list from the people who have commented on the report, -and the reporter. - -Requirements ------------- - -It requires python 2.2+, it won't work with 1.5.2 (Linux distributions -ship with 2.2+ these days, so that shouldn't be an issue). - -Documentation -------------- - -Documentation can be found inside the scripts. The source code is self -documenting. - -Issues for someone trying to use it to convert a gnats install ------------------------------------ - -1. We have three custom fields bugzilla doesn't ship with, -gcchost, gcctarget, and gccbuild. -We removed two bugzilla fields, rep_platform and op_sys. -If you use the latter instead of the former, you'll need to -update the script to account for this. -2. Because gcc attachments consist of preprocessed source, all attachments -inserted into the attachment database are compressed with zlib.compress. -This requires associated bugzilla changes to decompress before sending to -the browser. -Unless you want to make those changes (it's roughly 3 lines), you'll -need to remove the zlib.compress call. -3. You will need to come up with your own release to version mapping and -install it. -4. Obviously, any extra gnats fields you have added will have to -be handled in some manner. |