daemon: Factor out name of virtio serial channel.
[libguestfs.git] / update-bugs.sh
1 #!/bin/bash -
2 # update-bugs.sh
3 # Copyright (C) 2009-2010 Red Hat Inc.
4 #
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 2 of the License, or
8 # (at your option) any later version.
9 #
10 # This program is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 # GNU General Public License for more details.
14 #
15 # You should have received a copy of the GNU General Public License
16 # along with this program; if not, write to the Free Software
17 # Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
18
19 # In 'make dist' this is used to update the top level 'BUGS' file with
20 # the current bug list from Red Hat Bugzilla (bugzilla.redhat.com).
21
22 # First of all fetch the bugs from the database.  This might fail,
23 # eg. if there is no net access or no 'bugzilla' program, but if that
24 # happens just exit and leave the BUGS file alone.
25
26 bugzilla query -c libguestfs --outputformat='%{bug_id} %{bug_status} %{short_desc}' > .bugs.tmp || exit 0
27
28 # Any errors from now on are fatal.
29 set -e
30
31 # Print prologue.
32 echo 'NOTE: This file is automatically generated from "update-bugs.sh".'
33 echo -n 'Last updated: ' ; date +'%Y-%m-%d'
34 echo '
35 This contains a local list of the bugs that are open against
36 libguestfs.  Bugs are tracked in the Red Hat Bugzilla database
37 at https://bugzilla.redhat.com/ and to report a new bug you
38 should follow this link:
39
40 https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools
41
42 When reporting a new bug, please check:
43
44  - That the bug has not been reported already.
45  - That you are testing a recent version.
46  - Describe the bug accurately, and give a way to reproduce it.
47  - Include the version of libguestfs, distro version and any other
48    relevant information.
49  - Attach the complete output of "libguestfs-test-tool".
50 '
51
52 lastclass=X
53 while read bugno status summary; do
54     # Ignore CLOSED bugs in this list.
55     if [ "$status" = "CLOSED" ]; then continue; fi
56
57     # Treat ASSIGNED the same as NEW.
58     # Treat MODIFIED, POST and ON_QA as the same.
59     case "$status" in
60         ASSIGNED) bugclass=NEW ;;
61         POST|ON_QA) bugclass=MODIFIED ;;
62         *) bugclass=$status ;;
63     esac
64
65     # 'bugzilla' command returns the bugs sorted by status, NEW, ASSIGNED,
66     # MODIFIED, ..., CLOSED.  Therefore start a new section when the
67     # status field changes.
68     if [ "$bugclass" != "$lastclass" ]; then
69         echo '--------------------------------------------------'
70         case "$bugclass" in
71             NEW)
72                 echo 'Bugs in NEW or ASSIGNED state are open and waiting for someone to fix.' ;;
73             NEEDINFO)
74                 echo 'Bugs in NEEDINFO state require additional information.' ;;
75             MODIFIED)
76                 echo 'Bugs in MODIFIED, POST or ON_QA state are fixed.'
77                 echo 'You can help by testing the fixes.'
78                 ;;
79             *)
80                 echo "These bugs are in the $status state." ;;
81         esac
82         echo
83     fi
84     lastclass=$bugclass
85
86     # Display the bug.
87     echo "$bugno $status https://bugzilla.redhat.com/show_bug.cgi?id=$bugno"
88     echo "  $summary"
89     echo
90 done < .bugs.tmp
91
92 echo "End of BUGS file."
93
94 # Clean up temporary file.
95 rm .bugs.tmp