X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=UPGRADE;h=b4ab626b93ee6d30347a9a6aa24d2bdd03ec3e26;hb=2d8fff61383d49ae0829d338513070bcb3d0610e;hp=607d698b4cd6190aa3bf06d9cf6832ebf81412ef;hpb=271381214e0c81c6653cea2b9fc51602a1fbe28f;p=debbugs.git diff --git a/UPGRADE b/UPGRADE index 607d698..b4ab626 100644 --- a/UPGRADE +++ b/UPGRADE @@ -1,3 +1,115 @@ + + Debbugs upgrade notes + +=====================+ + +From 2.4.1 to 2.4.2 +------------------- + +The file format used to store the status of a bug (package, severity, etc.) +has changed; it is now in an RFC822-like format in order to be more +extensible, and is written to .summary files rather than the old .status +files. Before accepting any mail with the new version of debbugs, you must +run the 'debbugs-upgradestatus' program over your bug spool. The old .status +files will be left intact, and will continue to be written in sync with the +.summary files for compatibility with external tools. + +There is a new standalone spam-scanning script called spamscan, which uses +the SpamAssassin modules. To use it, set the $gSpamScan variable in +/etc/debbugs/config to a true value and $gSpamMailbox to an mbox file to +which detected spam should be appended, add /usr/lib/debbugs/spamscan to +your crontab as per the example, and optionally set $gSpamRulesDir and +$gSpamLocalTestsOnly as desired. + +From 2.4 to 2.4.1 +----------------- + +Add the following variables to the /etc/debbugs/config file: + +$gHTMLSuffix = ".html"; + +The use of $gCGIDomain has been cleaned up; formerly, it needed to begin +with "http://", which was confusingly inconsistent with all the other domain +variables. If you worked around this in your configuration, you will need to +recheck it. + +From 2.3 to 2.4 +--------------- + +Add the following variables to the /etc/debbugs/config file: + +$gWebHost = "localhost"; # e.g. www.debian.org +$gWebHostBugDir = "Bugs"; # e.g. Bugs +# For now, don't change this one manually! +$gWebDomain = "$gWebHost/$gWebHostBugDir"; +$gCGIDomain = "$gWebDomain/Bugs/cgi"; # e.g. cgi.debian.org +$gPackagePages = "packages.debian.org"; # e.g. packages.debian.org +$gSubscriptionDomain = "packages.something"; # e.g. packages.qa.debian.org +$gMaintainerFileOverride = "$gConfigDir/Maintainers.override"; +$gUnknownMaintainerEmail = "$gMaintainerEmail"; +$gPackageSource = "$gConfigDir/indices/sources"; + +$gWebDomain will probably exist already; change it as shown above. + +$gSubscriptionDomain is optional. + +$gMaintainerFileOverride is the name of a file used to manually override the +Maintainers file (which is often automatically generated). + +$gUnknownMaintainerEmail is the address to mail when a bug report arrives +for a package with no maintainer in $gMaintainerFile or +$gMaintainerFileOverride. + +$gPackageSource is a file containing three tab-separated columns: package +name, component (e.g. main, contrib, non-free), and the corresponding source +package name. + +Add the following variable to the /etc/debbugs/text file: + +############################################################################ +# Description of the tags +############################################################################ +$gHTMLTagDesc = " +
patch
+ wontfix
+ moreinfo
+ unreproducible
+ fixed
+ stable
+