UPGRADE

   1
   2                             Debbugs upgrade notes
   3                            +=====================+
   4
   5 From 2.3 to 2.4
   6 ---------------
   7
   8 Add the following variable to the /etc/debbugs/text file:
   9
  10 ############################################################################
  11 # Description of the tags
  12 ############################################################################
  13 $gHTMLTagDesc = "
  14 <dt><code>patch</code>
  15   <dd>A patch or some other easy procedure for fixing the $gBug is included in
  16   the $gBug logs. If there\'s a patch, but it doesn\'t resolve the $gBug
  17   adequately or causes some other problems, this tag should not be used.
  18
  19 <dt><code>wontfix</code>
  20   <dd>This $gBug won\'t be fixed. Possibly because this is a choice between two
  21   arbitrary ways of doing things and the maintainer and submitter prefer
  22   different ways of doing things, possibly because changing the behaviour
  23   will cause other, worse, problems for others, or possibly for other
  24   reasons.
  25
  26 <dt><code>moreinfo</code>
  27   <dd>This $gBug can\'t be addressed until more information is provided by the
  28   submitter. The $gBug will be closed if the submitter doesn\'t provide ore
  29   information in a reasonable (few months) timeframe. This is for $gBugs like
  30   \"It doesn\'t work\". What doesn\'t work?
  31
  32 <dt><code>unreproducible</code>
  33   <dd>This $gBug can\'t be reproduced on the maintainer\'s system.  Assistance
  34   from third parties is needed in diagnosing the cause of the problem.
  35
  36 <dt><code>fixed</code>
  37   <dd>This $gBug is fixed or worked around, but there\'s still an issue that
  38   needs to be resolved. (This will eventually replace the \"fixed\" severity)
  39
  40 <dt><code>stable</code>
  41   <dd>This $gBug affects the stable distribution in particular.  This is only
  42   intended to be used for ease in identifying release critical $gBugs that
  43   affect the stable distribution.  It\'ll be replaced eventually with
  44   something a little more flexible, probably.
  45 ";
  46
  47 From 2.2 to 2.3
  48 ---------------
  49
  50 There are three new scripts that have to be installed in CGI and the front
  51 page (or any other search you have set up) needs to be changed to use these
  52 scripts.  They are:
  53         * bugreport.cgi
  54         * common.pl
  55         * pkgreport.cgi
  56
  57 Add the following variables to the /etc/debbugs/config file:
  58 (the /usr/share/doc/debbugs/examples/config file can be used as a
  59 reference)
  60
  61 $gSummaryList = "summary.list";         #debian-bugs-report@lists
  62 $gSaveOldBugs = 1;
  63
  64 Make sure you do not have a double ,, as shown here if you're using the
  65 default severities.  Also, 'fixed' was added to the default severities:
  66 -                                       'normal',"Normal $gBugs",,
  67 +                                       'normal',"Normal $gBugs",
  68 +                                                       'fixed',"NMU Fixed $gBugs",
  69
  70 These have been added to the /etc/debbugs/text file:
  71 +############################################################################
  72 +#  Here is a blurb to point people to ftp archive of directions.  It is
  73 +#  used by the receive script when bouncing a badly formatted email
  74 +#
  75 +# $gTextInstructions = "$gBadEmailPrefix
  76 +# $gBadEmailPrefix Instructions are available from ftp.debian.org in /debian
  77 +# $gBadEmailPrefix and at all Debian mirror sites, in the files:
  78 +# $gBadEmailPrefix  doc/bug-reporting.txt
  79 +# $gBadEmailPrefix  doc/bug-log-access.txt
  80 +# $gBadEmailPrefix  doc/bug-maint-info.txt
  81 +# $gBadEmailPrefix";
  82 +############################################################################
  83 +$gTextInstructions = "$gBadEmailPrefix";
  84 +
  85 +
  86
  87 $gHTMLStart = "<BODY TEXT=#0F0F0F>";    #this is used by HTML generation to create the "uniform look"
  88
  89 The following code was added to /etc/debbugs/text if you use the new fixed
  90 severity
  91
  92         <DT><CODE>wishlist</CODE>
  93 -       <DD>for any feature request, and also for any $gBugs that are very difficult
  94 -       to fix due to major design considerations.";
  95 +       <DD>for any feature request, and also for any $gBugs that are very
  96 +       difficult to fix due to major design considerations.";
  97 +
  98 +       <DT><CODE>fixed</CODE>
  99 +       <DD>fixed in the current version in the unstable archive but the fix has
 100 +       not been fixed by the person responsible.
 101
 102  In All such entries in /etc/debbugs/text, if you replace <BODY> with
 103  $gHTMLStart, all html pages will have the same look (as specified in
 104  $gHTMLStart):
 105
 106  $gSummaryIndex = "<HTML><HEAD><TITLE>$gProject $gBug report logs - summary index</TITLE>
 107  $gPackageLog = "<HTML><HEAD><TITLE>$gProject $gBug report logs - index by package</TITLE>