Your message dated Sun, 04 Sep 2011 00:17:52 +0000
with message-id <[email protected]>
and subject line Bug#535776: fixed in lzma 9.22-1
has caused the Debian Bug report #535776,
regarding lzma: package description review
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.)
--
535776: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=535776
Debian Bug Tracking System
Contact [email protected] with problems
--- Begin Message ---
Package: lzma
Version: 4.43-14
Severity: minor
Tags: patch
As lzma's Priority goes up, its package description becomes more of
an embarrassment. Here's some suggested changes; and once I'm
editing the control file I might as well review all the others in
the same source package, for consistency. Patch attached;
justifications below.
> -Homepage: http://www.7-zip.org/sdk.htm
> +Homepage: http://www.7-zip.org/sdk.html
Typo-fix.
> Package: lzma
[...]
> -Description: Compression method of 7z format in 7-Zip program
> +Description: LZMA compression - command line utility
The original is wobbly English, but more importantly it's useless
as a description of this package (unless users happen to be familiar
with 7-Zip). Replace it with something informative and
DevRef6.2.2-compliant.
> - LZMA is a compression algorithm, based on the famous Lempel Ziv
> - compression method.
> - .
> - The main characteristics of the algorithm are very good compression,
> - fast decompression, use of lot of RAM for compression and low usage of
> - RAM for decompression.
> - .
> - LZMA provides high compression ratio and very fast decompression, so it
> - is very suitable for embedded applications. For example, it can be used
> - for ROM (firmware) compression.
Repetitive and poorly phrased (for a start, "use of lot of RAM" is
ungrammatical). Try:
> + The Lempel-Ziv Markov-chain Algorithm is a compression method based on
> + the famous LZ77 algorithm, and was first introduced by 7-Zip for use in
> + .7z archives.
> + .
> + Its main characteristics are a very high compression ratio, with high RAM
> + usage, and fast decompression, with low RAM usage. These properties make
> + it well suited to embedded uses, such as for ROM (firmware) compression.
(And use this text as boilerplate in other package descriptions.)
> - This package provides a gzip-like interface for the lzma program.
> + This package provides the lzma command line utility, which has a
> + familiar gzip-like interface.
The package does _not_ provide an "interface for" the lzma program -
it provides the lzma binary itself!
> Package: lzma-dev
[...]
> -Description: Compression method of 7z format in 7-Zip program - development
> files
> +Description: LZMA compression - development files
Changing all of the short descriptions to form a consistent set.
Then the same boilerplate changes, ending with:
> - This package contains the headers and libraries of lzma. It is
> - experimental and will be replaced by the library as soon as it is
> - available.
> + This package provides headers and development libraries for lzma.
It's far from obvious what "the library" was supposed to mean, but
whatever it was, this description is misleading - if this package
was "experimental" it shouldn't have been in Sid, never mind Lenny.
Replace it with something accurate.
> Package: lzma-source
[...]
> -Description: Source for the lzma kernel module
> +Description: LZMA compression - Linux kernel module source
Mention that we're talking Linux, not FreeBSD.
[...boilerplate ditto...]
> This package provides the source code for the lzma kernel modules.
> - Kernel source and headers are required to compile these modules.
> + Linux kernel source and headers are required to compile these modules.
This individual package description already has a bugreport
(#466582), but I'm treating mine as independent: even with my patch,
the description for lzma-source could still easily be improved by
input from somebody who understands what purpose it's supposed to
serve (assuming this package still has a reason to exist).
> Package: lzma-alone
[...]
> -Description: Compression method of 7z format in 7-Zip program
> +Description: LZMA compression - legacy utility
The original has a synopsis identical to that of lzma, which is
deeply unhelpful. My suggested replacement is a bit of a stab in
the dark; if you don't like it, please produce something better.
[...boilerplate ditto...]
> - This package provides the SDK based lzma_alone program.
> + This package provides only the old lzma_alone compression utility, which
> + has an interface more like that of zip.
The current description is no help to a user wondering what
lzma_alone is good for - they probably won't even know what SDK it's
referring to. Besides (reading http://tukaani.org/lzma/history),
both versions are "SDK based": lzma_alone was in LZMA-utils, and
then lzma was based on lzma_alone.
--
JBR
Ankh kak! (Ancient Egyptian blessing)
diff -ru lzma-4.43.pristine/debian/control lzma-4.43/debian/control
--- lzma-4.43.pristine/debian/control 2009-07-03 20:14:56.000000000 +0100
+++ lzma-4.43/debian/control 2009-07-04 09:45:25.000000000 +0100
@@ -4,7 +4,7 @@
Maintainer: Mohammed Adnène Trojette <[email protected]>
Uploaders: Arnaud Fontaine <[email protected]>
Build-Depends: debhelper (>= 5.0.0), quilt, zlib1g-dev
-Homepage: http://www.7-zip.org/sdk.htm
+Homepage: http://www.7-zip.org/sdk.html
Vcs-Git: git://git.debian.org/git/collab-maint/lzma.git
Vcs-Browser: http://git.debian.org/?p=collab-maint/lzma.git;a=summary
Standards-Version: 3.8.0
@@ -12,73 +12,60 @@
Package: lzma
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: Compression method of 7z format in 7-Zip program
- LZMA is a compression algorithm, based on the famous Lempel Ziv
- compression method.
- .
- The main characteristics of the algorithm are very good compression,
- fast decompression, use of lot of RAM for compression and low usage of
- RAM for decompression.
- .
- LZMA provides high compression ratio and very fast decompression, so it
- is very suitable for embedded applications. For example, it can be used
- for ROM (firmware) compression.
+Description: LZMA compression - command line utility
+ The Lempel-Ziv Markov-chain Algorithm is a compression method based on
+ the famous LZ77 algorithm, and was first introduced by 7-Zip for use in
+ .7z archives.
+ .
+ Its main characteristics are a very high compression ratio, with high RAM
+ usage, and fast decompression, with low RAM usage. These properties make
+ it well suited to embedded uses, such as for ROM (firmware) compression.
.
- This package provides a gzip-like interface for the lzma program.
+ This package provides the lzma command line utility, which has a
+ familiar gzip-like interface.
Package: lzma-dev
Architecture: any
Depends: zlib1g-dev
-Description: Compression method of 7z format in 7-Zip program - development files
- LZMA is a compression algorithm, based on the famous Lempel Ziv
- compression method.
- .
- The main characteristics of the algorithm are very good compression,
- fast decompression, use of lot of RAM for compression and low usage of
- RAM for decompression.
- .
- LZMA provides high compression ratio and very fast decompression, so it
- is very suitable for embedded applications. For example, it can be used
- for ROM (firmware) compression.
- .
- This package contains the headers and libraries of lzma. It is
- experimental and will be replaced by the library as soon as it is
- available.
-
+Description: LZMA compression - development files
+ The Lempel-Ziv Markov-chain Algorithm is a compression method based on
+ the famous LZ77 algorithm, and was first introduced by 7-Zip for use in
+ .7z archives.
+ .
+ Its main characteristics are a very high compression ratio, with high RAM
+ usage, and fast decompression, with low RAM usage. These properties make
+ it well suited to embedded uses, such as for ROM (firmware) compression.
+ .
+ This package provides headers and development libraries for lzma.
+
Package: lzma-source
Architecture: all
Depends: module-assistant, debhelper (>> 4.0.0), bzip2, make, lzma-dev
-Description: Source for the lzma kernel module
- LZMA is a compression algorithm, based on the famous Lempel Ziv
- compression method.
- .
- The main characteristics of the algorithm are very good compression,
- fast decompression, use of lot of RAM for compression and low usage of
- RAM for decompression.
- .
- LZMA provides high compression ratio and very fast decompression, so it
- is very suitable for embedded applications. For example, it can be used
- for ROM (firmware) compression.
+Description: LZMA compression - Linux kernel module source
+ The Lempel-Ziv Markov-chain Algorithm is a compression method based on
+ the famous LZ77 algorithm, and was first introduced by 7-Zip for use in
+ .7z archives.
+ .
+ Its main characteristics are a very high compression ratio, with high RAM
+ usage, and fast decompression, with low RAM usage. These properties make
+ it well suited to embedded uses, such as for ROM (firmware) compression.
.
This package provides the source code for the lzma kernel modules.
- Kernel source and headers are required to compile these modules.
+ Linux kernel source and headers are required to compile these modules.
Package: lzma-alone
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Conflicts: lzma (<< 4.43-13)
Replaces: lzma (<< 4.43-13)
-Description: Compression method of 7z format in 7-Zip program
- LZMA is a compression algorithm, based on the famous Lempel Ziv
- compression method.
- .
- The main characteristics of the algorithm are very good compression,
- fast decompression, use of lot of RAM for compression and low usage of
- RAM for decompression.
- .
- LZMA provides high compression ratio and very fast decompression, so it
- is very suitable for embedded applications. For example, it can be used
- for ROM (firmware) compression.
+Description: LZMA compression - legacy utility
+ The Lempel-Ziv Markov-chain Algorithm is a compression method based on
+ the famous LZ77 algorithm, and was first introduced by 7-Zip for use in
+ .7z archives.
+ .
+ Its main characteristics are a very high compression ratio, with high RAM
+ usage, and fast decompression, with low RAM usage. These properties make
+ it well suited to embedded uses, such as for ROM (firmware) compression.
.
- This package provides the SDK based lzma_alone program.
-
+ This package provides only the old lzma_alone compression utility, which
+ has an interface more like that of zip.
--- End Message ---
--- Begin Message ---
Source: lzma
Source-Version: 9.22-1
We believe that the bug you reported is fixed in the latest version of
lzma, which is due to be installed in the Debian FTP archive:
lzma-alone_9.22-1_amd64.deb
to main/l/lzma/lzma-alone_9.22-1_amd64.deb
lzma-dev_9.22-1_all.deb
to main/l/lzma/lzma-dev_9.22-1_all.deb
lzma_9.22-1.debian.tar.gz
to main/l/lzma/lzma_9.22-1.debian.tar.gz
lzma_9.22-1.dsc
to main/l/lzma/lzma_9.22-1.dsc
lzma_9.22-1_amd64.deb
to main/l/lzma/lzma_9.22-1_amd64.deb
lzma_9.22.orig.tar.gz
to main/l/lzma/lzma_9.22.orig.tar.gz
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.
Mohammed Adnène Trojette <[email protected]> (supplier of updated lzma 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: SHA1
Format: 1.8
Date: Sat, 03 Sep 2011 23:27:39 +0200
Source: lzma
Binary: lzma lzma-alone lzma-dev
Architecture: source amd64 all
Version: 9.22-1
Distribution: experimental
Urgency: low
Maintainer: Mohammed Adnène Trojette <[email protected]>
Changed-By: Mohammed Adnène Trojette <[email protected]>
Description:
lzma - Compression and decompression in the LZMA format - command line u
lzma-alone - Compression and decompression in the LZMA format - legacy utility
lzma-dev - Compression and decompression in the LZMA format - development fi
Closes: 460501 466582 470893 518365 535776 536275 540469 547802 553707 614417
Changes:
lzma (9.22-1) experimental; urgency=low
.
[ Mohammed Adnène Trojette ]
* New upstream release (Closes: #460501, #518365)
+ LZMA SDK is placed in the public domain since 4.62.
* Update debian/patches/02_lzmp.diff.
* Switch packaging under the terms of the BSD license.
* Switch to dpkg-source 3.0 (quilt) format
+ debian/control: Build-Depends
- drop quilt.
- bump debhelper dependency to 8.0.0.
* Bump Standards-Version to 3.9.2
* Drop lzma-source package. It doesn't work with current kernels and
SquashFS XZ is part of the standard kernel now. Patch courtesy of
Jonathan Nieder. (Closes: #470893, #553707, #466582)
* Update file list in lzma-dev. (Closes: #614417)
* Fix and improve descriptions. (Closes: #535776, #540469)
* Add deb-lzma script to convert a deb package to LZMA format. Script
courtesy of Roger Millan. (Closes: #536275)
* Add Jonathan Nieder as comaintainer.
.
[ Jonathan Nieder ]
* Bump debhelper compatibility to 7.
* Manage lzma, unlzma, and lzcat through the alternatives system.
Conflicts: xz-lzma (<< 5.1.1alpha+20110809-2). (Closes: #547802)
Checksums-Sha1:
6ee89e2e95179ee48d8e72745f35bd807f3bd89f 1239 lzma_9.22-1.dsc
f26b4d422dd5969dad7fba8138f0781d06d13550 642334 lzma_9.22.orig.tar.gz
3edbb26ad6fd551db602be578a720456ea18226e 17655 lzma_9.22-1.debian.tar.gz
c0492d33f06141f07d8a19a9388c92702671b768 55146 lzma_9.22-1_amd64.deb
457806f66bdd45718dec42257f4246a2496834aa 77998 lzma-alone_9.22-1_amd64.deb
b505db9499c64f45e7ac3a240f4aed6c501570ce 49286 lzma-dev_9.22-1_all.deb
Checksums-Sha256:
e876a32317d668de91ced89c844b1e98b301c28ef2d1560752a1bfa7f0ecb8b3 1239
lzma_9.22-1.dsc
0fa2ec459701e403b72662cf920d252466910161fa2077dd0f6d7c078002da19 642334
lzma_9.22.orig.tar.gz
a4ad098d27e9698f49c28ab0072f53c1ef916101d689bb9eeb1f1bd45848d3b7 17655
lzma_9.22-1.debian.tar.gz
687ff549377dd275ad072066c838f6af840d32df3c83101a84c6eb29ad3de919 55146
lzma_9.22-1_amd64.deb
b08c8a38c1aee54fe258c7b819225ab105106264b30ba415f54aa0b8f55e2987 77998
lzma-alone_9.22-1_amd64.deb
da4be589624cdf0c707d96362e0373319240f876dfafd282043b656e66d02887 49286
lzma-dev_9.22-1_all.deb
Files:
257b06c9451f8724249b2738c24470a2 1239 utils optional lzma_9.22-1.dsc
bfdcf75308860aa983f7e4293e93b652 642334 utils optional lzma_9.22.orig.tar.gz
b0b975e5530fdedeb1afe17f376e0ef0 17655 utils optional lzma_9.22-1.debian.tar.gz
1c818904c33d6257837144eb011b399a 55146 utils optional lzma_9.22-1_amd64.deb
28a10dff43ad21186c5d479f1c39f2e0 77998 utils optional
lzma-alone_9.22-1_amd64.deb
97df602aa6bd64ccff4d76b44d3f6afb 49286 utils optional lzma-dev_9.22-1_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
iEYEARECAAYFAk5ipPQACgkQOU3FkQ7XBOp42QCdH4nRe3p3zB/b1gMpVTWAbo8V
NiwAoNV12bH69gciqpuAmBEmzPrE3Gg9
=7PyD
-----END PGP SIGNATURE-----
--- End Message ---
