[devscripts] 01/01: scripts/bts: add tag list to manpage

[Antoine Beaupré]

This is an automated email from the git hooks/post-receive script.

anarcat pushed a commit to branch master
in repository devscripts.

commit 84e1f37b6c85d7ee871d7ba5bc9b5212452e555d
Author: Antoine Beaupré <anarcat at debian.org>
Date:   Tue Nov 28 11:45:54 2017 -0500

    scripts/bts: add tag list to manpage
    
    I keep on having to go back to the online BTS documentation, which
    doesn't work when I'm offline. That reference is also hard to find, so
    I add reference to the website.
    
    We just keep a flat list of the latest tags, without explanation, to
    avoid too much duplication.
    
    This duplicates the @gtag variable, but there is no way to interpolate
    variables in POD strings. We *could* do the opposite (extract the
    variable from a POD string) but that would be a mess because the list
    would be at the top of the file...
---
 debian/changelog |  2 ++
 scripts/bts.pl   | 17 ++++++++++++++++-
 2 files changed, 18 insertions(+), 1 deletion(-)

diff --git a/debian/changelog b/debian/changelog
index e0eecf8..bd77667 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -20,6 +20,8 @@ devscripts (2.17.12) UNRELEASED; urgency=medium
     + Refactor and unify version information.
     + Add support for uploads to Debian LTS with the new --lts flag.
       Closes: #762715
+  * bts:
+    + Add list of tags to documentation.
 
   [ James McCoy ]
   * grep-excuses:
diff --git a/scripts/bts.pl b/scripts/bts.pl
index d25ffdf..6ff2293 100755
--- a/scripts/bts.pl
+++ b/scripts/bts.pl
@@ -155,6 +155,9 @@ my $new_cache_format_version = '2.9.6';
 # The official list is mirrored
 # bugs-mirror.debian.org:/srv/bugs.debian.org/etc/config
 # in the variable @gTags; we copy it verbatim here.
+#
+# Note that it is also in the POD documentation in the bts_tag
+# function below, look for "potato".
 our (@gTags, @valid_tags, %valid_tags);
 @gTags = ( "patch", "wontfix", "moreinfo", "unreproducible", "fixed",
            "potato", "woody", "sid", "help", "security", "upstream",
@@ -1562,8 +1565,20 @@ will remove all tags from the specified I<bug>.
 Adding/removing the B<security> tag will add "team\@security.debian.org"
 to the Cc list of the control email.
 
-=cut
+The list of valid tags and their significance is available at
+L<https://www.debian.org/Bugs/Developer#tags>. The current valid tags
+are:
 
+patch, wontfix, moreinfo, unreproducible, help, newcomer, pending,
+security, upstream, confirmed, fixed, fixed-upstream,
+fixed-in-experimental, d-i, ipv6, lfs, l10n, a11y
+
+There is also a tag for each release of Debian since "potato". Note
+that this list may be out of date, see the website for the most up to
+date source.
+=cut
+# note that the tag list is also in the @gtag variable, look for
+# "potato" above.
 sub bts_tags {
     my $bug=checkbug(shift) or die "bts tags: tag what bug?\n";
     if (! @_) {

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/collab-maint/devscripts.git