Your message dated Sun, 21 Jun 2009 17:47:41 +0000
with message-id <[email protected]>
and subject line Bug#508456: fixed in make-dfsg 3.81-6
has caused the Debian Bug report #508456,
regarding make: improving the package description
to be marked as done.

This means that you claim that the problem has been dealt with.
If this is not the case it is now your responsibility to reopen the
Bug report if necessary, and/or fix the problem forthwith.

(NB: If you are a system administrator and have no idea what this
message is talking about, this may indicate a serious mail system
misconfiguration somewhere. Please contact [email protected]
immediately.)


-- 
508456: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=508456
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: make
Version: 3.81-5
Severity: wishlist
Tags: patch

Make's package description could do with some dusting.

# Description: The GNU version of the "make" utility.

Do readers really need to be told that the package "make" provides
something called "make"?  And isn't it pretty much the default
assumption that Debian GNU/Linux is going to use GNU make rather
than BSD make?  I mean, sure, give it a Homepage field and mention
it in the long description, but I would suggest that the short
description of "make" should be a short description of "make":

  Description: standard build automation utility

#  GNU Make is a program that determines which pieces of a large
#  program need to be recompiled and issues the commands to recompile
#  them, when necessary. More information about GNU Make can be found in
#  the `make' Info page. The upstream sources for this package are
#  available at the location ftp://ftp.gnu.org/gnu/make/. The
#  documentation for this package does not meet the Debian Free Software
#  Guidelines, and has been removed from this package.

First point: instead of "there's more information in the info page
[...] (PS: there's no info page)" it would make more sense to say
"there's more information in the (non-free) package make-doc or on
the web at [URL]".

Second: homepage pointers have their own field these days.  The
verbiage about the upstream sources being available could be
replaced by a pointer to http://ftp.gnu.org/gnu/make/ or
http://www.gnu.org/software/make/ (I'd go for the latter).

Third (partly de-fanged if you accept the proposed short description
change): this claim that "make" issues recompilation commands "when
necessary" is untrue - it doesn't run a proactive library transition
monitoring daemon, it just waits for somebody to invoke it!  The
package description takes it for granted that readers already know
the single most fundamental fact it should be telling them: "make"
is a tool that programmers traditionally use to trigger builds.

This conventional role is also worth mentioning to avoid giving the
impression that "make" is _only_ for recompiling large binaries from
sourcecode - on the contrary, it's standard in debian/rules even for
packages that are mere collections of icons or static text files.

I would suggest:

   Make is a tool invoked as part of a standard build process. It can
   determine which pieces of a large program need to be recompiled, and
   issue the appropriate commands to recompile them. More information
   about GNU Make can be found in the (non-free) package "make-doc" or
   on the web at "http://www.gnu.org/software/make/manual/";.
  Homepage: http://www.gnu.org/software/make/

None of these quibbles are higher than wishlist.

-- System Information:
Debian Release: lenny/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: i386 (i686)

Kernel: Linux 2.6.25.custom
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages make depends on:
ii  libc6                         2.7-16     GNU C Library: Shared libraries

make recommends no packages.

Versions of packages make suggests:
pn  make-doc                      <none>     (no description available)

-- no debconf information
-- 
JBR
Ankh kak! (Ancient Egyptian blessing)
--- ../make.old/debian/control	2008-12-09 11:45:56.000000000 +0000
+++ debian/control	2008-12-09 13:59:09.000000000 +0000
@@ -12,12 +12,11 @@
 Priority: standard
 Suggests: make-doc
 Architecture: any
-Description: The GNU version of the "make" utility.
- GNU Make is a program that determines which pieces of a large
- program need to be recompiled and issues the commands to recompile
- them, when necessary. More information about GNU Make can be found in
- the `make' Info page. The upstream sources for this package are
- available at the location ftp://ftp.gnu.org/gnu/make/. The
- documentation for this package does not meet the Debian Free Software
- Guidelines, and has been removed from this package.
+Description: standard build automation utility
+ Make is a tool invoked as part of a standard build process. It can
+ determine which pieces of a large program need to be recompiled, and
+ issue the appropriate commands to recompile them. More information
+ about GNU Make can be found in the (non-free) package "make-doc" or
+ on the web at "http://www.gnu.org/software/make/manual/";.
+Homepage: http://ftp.gnu.org/gnu/make/
 Depends: ${shlibs:Depends}

--- End Message ---
--- Begin Message ---
Source: make-dfsg
Source-Version: 3.81-6

We believe that the bug you reported is fixed in the latest version of
make-dfsg, which is due to be installed in the Debian FTP archive:

make-dfsg_3.81-6.diff.gz
  to pool/main/m/make-dfsg/make-dfsg_3.81-6.diff.gz
make-dfsg_3.81-6.dsc
  to pool/main/m/make-dfsg/make-dfsg_3.81-6.dsc
make_3.81-6_amd64.deb
  to pool/main/m/make-dfsg/make_3.81-6_amd64.deb



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to [email protected],
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Manoj Srivastava <[email protected]> (supplier of updated make-dfsg package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing [email protected])


-----BEGIN PGP SIGNED MESSAGE-----
Hash: RIPEMD160

Format: 1.8
Date: Sun, 21 Jun 2009 11:40:43 -0500
Source: make-dfsg
Binary: make
Architecture: source amd64
Version: 3.81-6
Distribution: unstable
Urgency: low
Maintainer: Manoj Srivastava <[email protected]>
Changed-By: Manoj Srivastava <[email protected]>
Description: 
 make       - An utility for Directing compilation.
Closes: 508456 524378 524378 533681
Changes: 
 make-dfsg (3.81-6) unstable; urgency=low
 .
   * [debian:8ea2843]: [make-dfsg]: Update package description
     Update and trim the package description.
     Bug fix: "improving the package description", thanks to Justin B Rye
                                                        (Closes: #508456).
   * [debian:586087b]: [make-dfsg]: Use autoreconf to refresh the build system.
     Bug fix: "FTBFS: Outdated config.{sub,guess}", thanks to Bradley Smith
                                                         (Closes: #533681).
   * [4ae7fd6]: [topic--override-fix]: Fix override behaviour discrepancies
     target specific override appears to be ignored completely if the
     variable is passed on the command line. Closes: 524378
     Bug fix: "corner cases in &#39;override&#39; logic for variables",
     thanks to Ron                                        (Closes: #524378).
Checksums-Sha1: 
 2d70f61b5efaf41f6b0bafb4a1df8e278802c9e2 1174 make-dfsg_3.81-6.dsc
 5452ac31c3be1c21799f929786163db196dbf94c 341705 make-dfsg_3.81-6.diff.gz
 b6cdeed43c5d78512f8a8a07064e87602e20cb1e 404634 make_3.81-6_amd64.deb
Checksums-Sha256: 
 08740152fa6a88412f42301cfd08aef5264f7ba1fb18c63370fa672d2ef56f13 1174 
make-dfsg_3.81-6.dsc
 598c160293df9a42d48a1e81447203195a501e7b7d37b05b59b6e9049db1453d 341705 
make-dfsg_3.81-6.diff.gz
 31f11811022586e94a1b9cf75593befbc2b0ec7c5dcf02ee8bcd3c32409a0bcd 404634 
make_3.81-6_amd64.deb
Files: 
 b2a398e5f6ba5f33a48c3fbe6fd45a50 1174 devel standard make-dfsg_3.81-6.dsc
 74dabc417c7367248588e6edacd4d436 341705 devel standard make-dfsg_3.81-6.diff.gz
 a956f3c84c32c6e62593833ecf584cbf 404634 devel standard make_3.81-6_amd64.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)

iEYEAREDAAYFAko+br0ACgkQIbrau78kQkyycgCePY2S/p3I7W5r+l0iBYkrDG2Y
57kAoIxZKMhSLTBQTmrcHoP0SCjnNqO+
=pxk+
-----END PGP SIGNATURE-----



--- End Message ---

Reply via email to