[project @ 2002-10-12 18:39:01 by cjwatson]

[debbugs.git] / UPGRADE

diff --git a/UPGRADE b/UPGRADE
index 607d698b4cd6190aa3bf06d9cf6832ebf81412ef..f90ea760869680cf7134e559bca825d25fa7b277 100644 (file)
--- a/UPGRADE
+++ b/UPGRADE
@@ -1,3 +1,63 @@
+
+                            Debbugs upgrade notes
+                           +=====================+
+
+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
+
+($gWebDomain will probably exist already, change it as shown above.)
+
+Add the following variable to the /etc/debbugs/text file:
+
+############################################################################
+# Description of the tags
+############################################################################
+$gHTMLTagDesc = "
+<dt><code>patch</code>
+  <dd>A patch or some other easy procedure for fixing the $gBug is included in
+  the $gBug logs. If there\'s a patch, but it doesn\'t resolve the $gBug
+  adequately or causes some other problems, this tag should not be used.
+
+<dt><code>wontfix</code>
+  <dd>This $gBug won\'t be fixed. Possibly because this is a choice between two
+  arbitrary ways of doing things and the maintainer and submitter prefer
+  different ways of doing things, possibly because changing the behaviour
+  will cause other, worse, problems for others, or possibly for other
+  reasons.
+
+<dt><code>moreinfo</code>
+  <dd>This $gBug can\'t be addressed until more information is provided by the
+  submitter. The $gBug will be closed if the submitter doesn\'t provide ore
+  information in a reasonable (few months) timeframe. This is for $gBugs like
+  \"It doesn\'t work\". What doesn\'t work?
+
+<dt><code>unreproducible</code>
+  <dd>This $gBug can\'t be reproduced on the maintainer\'s system.  Assistance
+  from third parties is needed in diagnosing the cause of the problem.
+
+<dt><code>fixed</code>
+  <dd>This $gBug is fixed or worked around, but there\'s still an issue that
+  needs to be resolved. (This will eventually replace the \"fixed\" severity)
+
+<dt><code>stable</code>
+  <dd>This $gBug affects the stable distribution in particular.  This is only
+  intended to be used for ease in identifying release critical $gBugs that
+  affect the stable distribution.  It\'ll be replaced eventually with
+  something a little more flexible, probably.
+";
+
+From 2.2 to 2.3
+---------------
+
 There are three new scripts that have to be installed in CGI and the front
 page (or any other search you have set up) needs to be changed to use these
 scripts.  They are: