--- Begin Message ---
Package: release.debian.org
Severity: normal
User: release.debian.org@packages.debian.org
Usertags: unblock
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Please unblock package how-can-i-help
Recently, usertag 'gift' [1] was replaced by official 'newcomer' tag [2][3].
Since how-can-i-help relies heavily on this tag, it was necessary to add support
for 'newcomer' while retaining support for 'gift'. While the essential changes
were done on the UDD side, how-can-i-help required some minor changes to avoid
potential confusion (mostly calling 'newcomer' bugs 'gift' bugs). Most of the
implemented changes involved manpage and --help updates. The only functional
change was adding support for 'newcomer' option to 'ignore' and 'show' settings
(it's just an alias of 'gift' option). This hcih version supports both
'newcomer' and 'gift' tags so there won't be any backward compatibility issues.
Adding support for 'newcomer' tag was requested in bug #769640 (version 10
closes that bug).
Implemented changes:
* Added support for 'newcomer' tag. Closes: #769640
- Added support for 'newcomer' option
- Updated manual and help
- Added 'gift' tag depreciation warning
* Fix a few typos in the manpage.
+ Re-generated the manpage from ascii. The generated format changed
slightly, causing a rather huge diff.
Debdiff attached (the size of the diff is mostly a result of the manpage
regeneration mentioned in the changelog).
While this update is not critical, I believe that it would be a good idea to
use the official tag in the upcoming stable release. Especially, since
how-can-i-help is also used by potential new contributors who may be confused
by the difference in tag names.
Thanks!
[1] https://wiki.debian.org/qa.debian.org/GiftTag
[2] https://lists.debian.org/debian-devel-announce/2014/11/msg00015.html
[3] http://www.donarmstrong.com/posts/newcomer_bts_tag/
unblock how-can-i-help/10
- -- System Information:
Debian Release: jessie/sid
APT prefers testing
APT policy: (500, 'testing')
Architecture: amd64 (x86_64)
Kernel: Linux 3.14-2-amd64 (SMP w/4 CPU cores)
Locale: LANG=en_GB.utf8, LC_CTYPE=en_GB.utf8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1
iQIcBAEBAgAGBQJUfRZhAAoJEObHEOLlweSj0bwP/ic9JrWVwmoe7ph4zZPAuQ6U
eZTi4WyERmxIOSHLuq131mz98DrNHs0VGnjA2JKz+5LSjL3hdudz9PKdTc5wdRM4
r2bG9f/ypOBBekiR6hqt0MGgpvC9FP7BwRsgQZw9KoeDIYodK18Qg1suwZtr1Sdn
enC0hRs/ItjzfDu+EsMi+nqBj5lvHTITTpwz3xNC17E8botyG0VzP6RPulq2a+kB
5e+hegx6E/tg43JFzty/q8yk6oQvYNUBWpq9/A/Ro9+UQ7ScCWB/fVMZjEan+Bdr
3WcMgn9fiUpXFQAjCD+BFLFp1r8R7i2M9GmZEM+dk+JuWwOsF6/MoeDG7tVzR/uZ
zkaVvHoe0HxMNFYUiY3i+W1NBHxosY2cAo52IDjG/d/HVKDm9EH2FDTUEurM7Pl+
NGPahffdi+GsQZ53hnC8UGT3B6BCJlXRjE3rZprkU8vy7aECFy3Oz7PiKlmgopBS
LOxXOsUNc0H+Xj8lWb5KFBIxI/5WmgsuycpjgneOaewe7GEmJdhQxQukypYNqZkZ
DzzciTM1EvaplQiG2Ld3LZXF81M6O4YSW8e3M/p35p4ld66tUTGDcSX9u7ds6nNr
PEStWuDZeUEHrUzJyFTXZXMT73YB9bcDiq/bjT/MAqA6u4V00T1GuV/ZXAYvOyTp
0dnzJ3S7vysw5xIxpXbJ
=vv07
-----END PGP SIGNATURE-----
diff -Nru how-can-i-help-9/bin/how-can-i-help how-can-i-help-10/bin/how-can-i-help
--- how-can-i-help-9/bin/how-can-i-help 2014-10-26 18:35:07.000000000 +0100
+++ how-can-i-help-10/bin/how-can-i-help 2014-12-01 09:01:27.000000000 +0100
@@ -62,9 +62,9 @@
opts.on('-h', '--help', 'show help') do
puts opts
puts "\nAllowed types for '--show' option (see manual for more information):"
- puts "\twnpp, gift, no-testing, testing-autorm, rfs, O, RFA, RFH, ITA, pseudo-package"
+ puts "\twnpp, newcomer, no-testing, testing-autorm, rfs, O, RFA, RFH, ITA, pseudo-package"
puts "\nTo see opportunities suitable for newcomers you should run how-can-i-help as:"
- puts "\thow-can-i-help --old --show gift"
+ puts "\thow-can-i-help --old --show newcomer"
puts "\nYou can check manual for a more detailed description:"
puts "\tman how-can--i-help"
exit(0)
@@ -160,6 +160,19 @@
ignored_types += selected_type
end
+# Show a 'gift' tag depreciation warning.
+if ignored_types.include?('gift') || $show.include?('gift')
+ puts "how-can-i-help: 'gift' tag is deprecated - please use 'newcomer' instead."
+end
+
+# Support for 'newcomer' tag as 'gift' UDD flag.
+if ignored_types.include?('newcomer')
+ ignored_types.push('gift')
+end
+if $show.include?('newcomer')
+ $show.push('gift')
+end
+
helpitems_filtered = []
helpitems.each do |hi|
next if (not $old) and seen.include?(hi['hash'])
@@ -235,7 +248,7 @@
end
if gift.length > 0
- puts $old ? 'Bugs suitable for new contributors (tagged \'gift\'):' : 'New bugs suitable for new contributors (tagged \'gift\'):'
+ puts $old ? 'Bugs suitable for new contributors (tagged \'newcomer\'):' : 'New bugs suitable for new contributors (tagged \'newcomer\'):'
gift.sort { |a, b| [a['package'], a['bug'] ] <=> [ b['package'], b['bug'] ] }.each do |r|
puts " - #{r['package']} - https://bugs.debian.org/#{r['bug']} - #{r['title']}"
end
@@ -243,7 +256,7 @@
end
if infra.length > 0
- puts $old ? 'Bugs affecting Debian infrastructure (tagged \'gift\'):' : 'New bugs affecting Debian infrastructure (tagged \'gift\'):'
+ puts $old ? 'Bugs affecting Debian infrastructure (tagged \'newcomer\'):' : 'New bugs affecting Debian infrastructure (tagged \'newcomer\'):'
infra.sort { |a, b| [a['package'], a['bug'] ] <=> [ b['package'], b['bug'] ] }.each do |r|
puts " - #{r['package']} - https://bugs.debian.org/#{r['bug']} - #{r['title']}"
end
diff -Nru how-can-i-help-9/debian/changelog how-can-i-help-10/debian/changelog
--- how-can-i-help-9/debian/changelog 2014-10-26 18:36:16.000000000 +0100
+++ how-can-i-help-10/debian/changelog 2014-12-01 09:21:26.000000000 +0100
@@ -1,3 +1,18 @@
+how-can-i-help (10) unstable; urgency=medium
+
+ [ Tomasz Nitecki ]
+ * Added support for 'newcomer' tag. Closes: #769640
+ - Added support for 'newcomer' option
+ - Updated manual and help
+ - Added 'gift' tag depreciation warning
+
+ [ Lucas Nussbaum ]
+ * Fix a few typos in the manpage.
+ + Re-generated the manpage from ascii. The generated format changed
+ slightly, causing a rather huge diff.
+
+ -- Tomasz Nitecki <tnnn@tnnn.pl> Mon, 01 Dec 2014 08:24:27 +0100
+
how-can-i-help (9) unstable; urgency=medium
[ Lucas Nussbaum ]
diff -Nru how-can-i-help-9/how-can-i-help.1 how-can-i-help-10/how-can-i-help.1
--- how-can-i-help-9/how-can-i-help.1 2014-10-26 18:35:08.000000000 +0100
+++ how-can-i-help-10/how-can-i-help.1 2014-12-01 09:18:53.000000000 +0100
@@ -1,19 +1,19 @@
'\" t
.\" Title: how-can-i-help
-.\" Author: [see the "AUTHOR" section]
+.\" Author: [see the "AUTHORS" section]
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
-.\" Date: 11/25/2013
+.\" Date: 12/01/2014
.\" Manual: \ \&
.\" Source: \ \&
.\" Language: English
.\"
-.TH "HOW\-CAN\-I\-HELP" "1" "11/25/2013" "\ \&" "\ \&"
+.TH "HOW\-CAN\-I\-HELP" "1" "12/01/2014" "\ \&" "\ \&"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" https://bugs.debian.org/507673
-.\" https://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
@@ -31,10 +31,10 @@
how-can-i-help \- show opportunities for contributing to Debian
.SH "SYNOPSIS"
.sp
-\fBhow\-can\-i\-help\fR [\fI\-haoqs\fR] [\fI\-\-help\fR] [\fI\-\-all\fR] [\fI\-\-old\fR] [\fI\-\-quiet\fR] [\fI\-\-show <type>\fR...]
+\fBhow\-can\-i\-help\fR [\fI\-haoqs\fR] [\fI\-\-help\fR] [\fI\-\-all\fR] [\fI\-\-old\fR] [\fI\-\-quiet\fR] [\fI\-\-show <type>\&...\fR]
.SH "DESCRIPTION"
.sp
-\fBhow\-can\-i\-help\fR hooks into APT to list opportunities for contributions to Debian (orphaned packages, bugs tagged \fIgift\fR) for packages installed locally, after each APT invocation\&. It can also be invoked directly, and then lists all opportunities for contribution (not just the new ones)\&.
+\fBhow\-can\-i\-help\fR hooks into APT to list opportunities for contributions to Debian (orphaned packages, bugs tagged \fInewcomer\fR) for packages installed locally, after each APT invocation\&. It can also be invoked directly, and then lists all opportunities for contribution (not just the new ones)\&.
.SH "OPTIONS"
.sp
Options must come before the other command line arguments\&.
@@ -59,9 +59,9 @@
Do not display header and footer\&.
.RE
.PP
-\fB\-s <type>\fR..., \fB\-\-show <type>...\fR
+\fB\-s <type>\&...\fR, \fB\-\-show <type>\&...\fR
.RS 4
-Show only specific types of opportunities. Provided types have to be separated by commas\&.
+Show only specific types of opportunities\&. Provided types have to be separated by commas\&.
.RE
.SH "PROXY SUPPORT"
.sp
@@ -83,123 +83,71 @@
.\}
.SH "SHOW ONLY SPECIFIC TYPES OF OPPORTUNITIES"
.sp
-\fBhow\-can\-i\-help\fR can be configured to show only specific types of opportunities. You only need to run it with \fI\-\-show\fR option followed by a single space and then a list of types. Types have to be separated only by commas.
-.PP
+\fBhow\-can\-i\-help\fR can be configured to show only specific types of opportunities\&. You only need to run it with \-\-show option followed by a single space and then a list of types\&. Types have to be separated only by commas\&.
+.sp
Simple example:
.sp
.if n \{\
.RS 4
.\}
.nf
-how-can-i-help --show gift,RFH
-.RE
-.PP
+how\-can\-i\-help \-\-show newcomer,RFH
.fi
.if n \{\
.RE
.\}
-Example showing gift opportunities (also the ones that were already shown before):
+.sp
+Example showing newcomer opportunities (also the ones that were already shown before):
.sp
.if n \{\
.RS 4
.\}
.nf
-how-can-i-help --old --show gift
+how\-can\-i\-help \-\-old \-\-show newcomer
.fi
.if n \{\
.RE
.\}
-.RE
-.PP
-The following types can be used:
-.RS 4
-wnpp, gift, no-testing, testing-autorm, rfs
-.RE
-.PP
-Specific WNPP types:
-.RS 4
-O, RFA, RFH, ITA
-.RE
-.PP
-And special types:
-.RS 4
-pseudo-package
-.RE
+.sp
+The following types can be used: wnpp, newcomer, no\-testing, testing\-autorm, rfs
+.sp
+Specific WNPP types: O, RFA, RFH, ITA
+.sp
+And special types: pseudo\-package
.SH "IGNORE SELECTED TYPES OF OPPORTUNITIES"
.sp
\fBhow\-can\-i\-help\fR can also ignore selected types of opportunities\&. These are listed in ~/\&.config/how\-can\-i\-help/ignored separated by whitespaces or newlines\&.
-.PP
-Allowed types:
-.RS 4
-wnpp, gift, no-testing, testing-autorm, rfs
-.RE
-.PP
-Allowed WNPP types:
-.RS 4
-O, RFA, RFH, ITA
-.RE
-.PP
-Allowed special types:
-.RS 4
-pseudo-package
-.RE
-.PP
-Running with \fI\-\-show\fR option will override \'ignored types\' configuration\&.
-.RE
+.sp
+Allowed types: wnpp, newcomer, no\-testing, testing\-autorm, rfs
+.sp
+Allowed WNPP types: O, RFA, RFH, ITA
+.sp
+Allowed special types: pseudo\-package
+.sp
+Running with \-\-show option will override \fIignored types\fR configuration\&.
.SH "TYPES OF OPPORTUNITIES"
.sp
The following acronyms are used to describe the supported types:
-.RE
-.PP
-\fBwnpp\fR
-.RS 4
-Work-Needing and Prospective Packages\&.
-.RE
-.PP
-\fBgift\fR
-.RS 4
-Packages tagged with the \'gift\' tag\&.
-.RE
-.PP
-\fBno-testing\fR
-.RS 4
-Packages removed from Debian \'testing\'\&.
-.RE
-.PP
-\fBtesting-autorm\fR
-.RS 4
-Packages going to be removed from Debian \'testing\'\&.
-.RE
-.PP
-\fBrfs\fR
-.RS 4
-Request For Sponsorship\&.
-.RE
-.PP
-\fBO\fR
-.RS 4
-Orphaned\&.
-.RE
-.PP
-\fBRFA\fR
-.RS 4
-Request For Adoption\&.
-.RE
-.PP
-\fBRFH\fR
-.RS 4
-Request For Help\&.
-.RE
-.PP
-\fBITA\fR
-.RS 4
-Intent To Adopt\&.
-.RE
-.PP
-\fBpseudo-package\fR
-.RS 4
-Gift bugs affecting Debian infrastructure\&. They can't be installed and are related to some general Debian service\&.
-.RE
+.sp
+\fBwnpp\fR Work\-Needing and Prospective Packages\&.
+.sp
+\fBnewcomer\fR Bugs tagged with the \fInewcomer\fR tag\&. Those bugs were formerly tagged with the now deprecated \fIgift\fR tag\&.
+.sp
+\fBno\-testing\fR Packages removed from Debian \fItesting\fR\&.
+.sp
+\fBtesting\-autorm\fR Packages going to be removed from Debian \fItesting\fR\&.
+.sp
+\fBrfs\fR Request For Sponsorship\&.
+.sp
+\fBO\fR Orphaned\&.
+.sp
+\fBRFA\fR Request For Adoption\&.
+.sp
+\fBRFH\fR Request For Help\&.
+.sp
+\fBITA\fR Intent To Adopt\&.
+.sp
+\fBpseudo\-package\fR Newcomer bugs affecting Debian infrastructure (general Debian services)\&. Those pseudo\-packages cannot be installed\&.
.SH "ADDITIONAL PACKAGES"
.sp
\fBhow\-can\-i\-help\fR can also monitor packages not installed locally\&. These are listed in ~/\&.config/how\-can\-i\-help/packages separated by whitespaces or newlines\&.
@@ -223,9 +171,11 @@
https://wiki\&.debian\&.org/qa\&.debian\&.org/GiftTag
.sp
https://www\&.debian\&.org/devel/wnpp
-.SH "AUTHOR"
+.SH "AUTHORS"
+.sp
+Tomasz Nitecki (tnnn@tnnn\&.pl)
.sp
Lucas Nussbaum (lucas@debian\&.org)
.SH "DATE"
.sp
-2014\-10\-25
+2014\-12\-01
diff -Nru how-can-i-help-9/how-can-i-help.1.txt how-can-i-help-10/how-can-i-help.1.txt
--- how-can-i-help-9/how-can-i-help.1.txt 2014-10-26 18:35:08.000000000 +0100
+++ how-can-i-help-10/how-can-i-help.1.txt 2014-12-01 09:18:35.000000000 +0100
@@ -13,7 +13,7 @@
DESCRIPTION
-----------
*how-can-i-help* hooks into APT to list opportunities for contributions to
-Debian (orphaned packages, bugs tagged 'gift') for packages installed
+Debian (orphaned packages, bugs tagged 'newcomer') for packages installed
locally, after each APT invocation. It can also be invoked directly, and
then lists all opportunities for contribution (not just the new ones).
@@ -60,18 +60,18 @@
Simple example:
-----
-how-can-i-help --show gift,RFH
+how-can-i-help --show newcomer,RFH
-----
-Example showing gift opportunities (also the ones that were already shown before):
+Example showing newcomer opportunities (also the ones that were already shown before):
-----
-how-can-i-help --old --show gift
+how-can-i-help --old --show newcomer
-----
The following types can be used:
-wnpp, gift, no-testing, testing-autorm, rfs
+wnpp, newcomer, no-testing, testing-autorm, rfs
-Specific specific WNPP types:
+Specific WNPP types:
O, RFA, RFH, ITA
And special types:
@@ -83,7 +83,7 @@
listed in ~/.config/how-can-i-help/ignored separated by whitespaces or newlines.
Allowed types:
-wnpp, gift, no-testing, testing-autorm, rfs
+wnpp, newcomer, no-testing, testing-autorm, rfs
Allowed WNPP types:
O, RFA, RFH, ITA
@@ -100,8 +100,8 @@
*wnpp*
Work-Needing and Prospective Packages.
-*gift*
- Packages tagged with the 'gift' tag.
+*newcomer*
+ Bugs tagged with the 'newcomer' tag. Those bugs were formerly tagged with the now deprecated 'gift' tag.
*no-testing*
Packages removed from Debian 'testing'.
@@ -125,7 +125,7 @@
Intent To Adopt.
*pseudo-package*
- Gift bugs affecting Debian infrastructure. They can't be installed and are related to some general Debian service.
+ Newcomer bugs affecting Debian infrastructure (general Debian services). Those pseudo-packages cannot be installed.
ADDITIONAL PACKAGES
-------------------
@@ -141,15 +141,19 @@
SEE ALSO
--------
https://wiki.debian.org/how-can-i-help
+
https://wiki.debian.org/qa.debian.org/GiftTag
+
https://www.debian.org/devel/wnpp
-AUTHOR
-------
+AUTHORS
+-------
+Tomasz Nitecki (tnnn@tnnn.pl)
+
Lucas Nussbaum (lucas@debian.org)
DATE
----
-2014-10-25
+2014-12-01
// vim: set filetype=asciidoc:
--- End Message ---