Bug#719262: [src:openssl] Please review package descriptions
Package: src:openssl
Version: 1.0.1e-3
Severity: wishlist
X-Debbugs-CC: debian-l10n-english@lists.debian.org
Dear Debian OpenSSL Team,
as libssl has a high popcon I suggest a bit of rewording to adhere better to
(1). I would like to see some boilerplate explaining (Open)SSL, unified
short
descriptions and "complete" sentences. For your convenience I prepared a
debian/control with rewritten descriptions, using information from Wikipedia
(2) and the OpenSSL project homepage (3) to be used as a starting point.
Kind regards
Martin
1:
http://www.debian.org/doc/manuals/developers-reference/best-pkging-practices.html#bpp-debian-control
2: http://en.wikipedia.org/wiki/Transport_Layer_Security
Transport Layer Security (TLS) and its predecessor, Secure Sockets Layer
(SSL), are cryptographic protocols that provide communication
security over
the Internet.[1]
3: http://www.openssl.org/
Welcome to the OpenSSL Project
The OpenSSL Project is a collaborative effort to develop a robust,
commercial-grade, full-featured, and Open Source toolkit
implementing the
Secure Sockets Layer (SSL v2/v3) and Transport Layer Security (TLS v1)
protocols as well as a full-strength general purpose cryptography
library.
…
--- control.orig 2013-08-08 00:20:03.000000000 +0200
+++ control 2013-08-08 01:04:17.000000000 +0200
@@ -13,12 +13,16 @@
Architecture: any
Depends: ${shlibs:Depends}, ${perl:Depends}, ${misc:Depends}
Suggests: ca-certificates
-Description: Secure Socket Layer (SSL) binary and related cryptographic tools
- This package contains the openssl binary and related tools.
+OpenSSL's Secure Sockets Layer implementation - xxx
+ This package is part of the OpenSSL project's implementation of the SSL
+ cryptograpfic protocol for communication security over the internet.
+Description: Secure Sockets Layer implementation - binary and related cryptographic tools
+ This package is part of the OpenSSL project's implementation of the SSL
+ cryptograpfic protocol for communication security over the internet.
.
- It is part of the OpenSSL implementation of SSL.
+ It contains the openssl binary and related tools.
.
- You need it to perform certain cryptographic actions like:
+ You need it to perform cryptographic operations such as:
- Creation of RSA, DH and DSA key parameters;
- Creation of X.509 certificates, CSRs and CRLs;
- Calculation of message digests;
@@ -33,11 +37,12 @@
Multi-Arch: same
Pre-Depends: ${misc:Pre-Depends}
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: SSL shared libraries
- libssl and libcrypto shared libraries needed by programs like
- apache-ssl, telnet-ssl and openssh.
+Description: Secure Sockets Layer implementation - shared libraries
+ This package is part of the OpenSSL project's implementation of the SSL
+ cryptograpfic protocol for communication security over the internet.
.
- It is part of the OpenSSL implementation of SSL.
+ The libssl and libcrypto shared libraries are needed by programs like
+ apache-ssl, telnet-ssl and openssh.
Package: libcrypto1.0.0-udeb
XC-Package-Type: udeb
@@ -45,10 +50,12 @@
Priority: optional
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: crypto shared library - udeb
- libcrypto shared library.
+Description: Secure Sockets Layer implementation - libcrypto udeb
+ This package is part of the OpenSSL project's implementation of the SSL
+ cryptograpfic protocol for communication security over the internet.
.
- Do not install it on a normal system.
+ It contains the libcrypto shared library. Do not install it on a normal
+ system.
Package: libssl-dev
Section: libdevel
@@ -57,11 +64,12 @@
Multi-Arch: same
Recommends: libssl-doc
Depends: libssl1.0.0 (= ${binary:Version}), zlib1g-dev, ${misc:Depends}
-Description: SSL development libraries, header files and documentation
- libssl and libcrypto development libraries, header files and manpages.
+Description: Secure Sockets Layer implementation - development files
+ This package is part of the OpenSSL project's implementation of the SSL
+ cryptograpfic protocol for communication security over the internet.
.
- It is part of the OpenSSL implementation of SSL.
-
+ It contains development libraries, header files and manpages for the libssl
+ and libcrypto libraries.
Package: libssl-doc
Section: doc
@@ -70,10 +78,11 @@
Replaces: libssl-dev (<< 1.0.0)
Breaks: libssl-dev (<< 1.0.0)
Depends: ${shlibs:Depends}, ${perl:Depends}, ${misc:Depends}
-Description: SSL development documentation documentation
- libssl and libcrypto manpages and demo files.
+Description: Secure Sockets Layer implementation - documentation
+ This package is part of the OpenSSL project's implementation of the SSL
+ cryptograpfic protocol for communication security over the internet.
.
- It is part of the OpenSSL implementation of SSL.
+ It contains libssl and libcrypto manpages and demo files.
Package: libssl1.0.0-dbg
Section: debug
@@ -81,5 +90,8 @@
Architecture: any
Multi-Arch: same
Depends: libssl1.0.0 (= ${binary:Version}), ${misc:Depends}
-Description: Symbol tables for libssl and libcrypto
- This package is part of the OpenSSL implementation of SSL.
+Description: Secure Sockets Layer implementation - debug information
+ This package is part of the OpenSSL project's implementation of the SSL
+ cryptograpfic protocol for communication security over the internet.
+ .
+ It contains symbol tables for libssl and libcrypto.
Source: openssl
Build-Depends: debhelper (>= 8.1.3), zlib1g-dev, m4, bc, dpkg-dev (>= 1.15.7)
Section: utils
Priority: optional
Maintainer: Debian OpenSSL Team <pkg-openssl-devel@lists.alioth.debian.org>
Uploaders: Christoph Martin <christoph.martin@uni-mainz.de>, Kurt Roeckx <kurt@roeckx.be>
Standards-Version: 3.8.0
Vcs-Browser: http://svn.debian.org/wsvn/pkg-openssl/openssl
Vcs-Svn: svn://svn.debian.org/pkg-openssl/openssl/
Package: openssl
Priority: optional
Architecture: any
Depends: ${shlibs:Depends}, ${perl:Depends}, ${misc:Depends}
Suggests: ca-certificates
Description: Secure Socket Layer (SSL) binary and related cryptographic tools
This package contains the openssl binary and related tools.
.
It is part of the OpenSSL implementation of SSL.
.
You need it to perform certain cryptographic actions like:
- Creation of RSA, DH and DSA key parameters;
- Creation of X.509 certificates, CSRs and CRLs;
- Calculation of message digests;
- Encryption and decryption with ciphers;
- SSL/TLS client and server tests;
- Handling of S/MIME signed or encrypted mail.
Package: libssl1.0.0
Section: libs
Priority: important
Architecture: any
Multi-Arch: same
Pre-Depends: ${misc:Pre-Depends}
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: SSL shared libraries
libssl and libcrypto shared libraries needed by programs like
apache-ssl, telnet-ssl and openssh.
.
It is part of the OpenSSL implementation of SSL.
Package: libcrypto1.0.0-udeb
XC-Package-Type: udeb
Section: debian-installer
Priority: optional
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: crypto shared library - udeb
libcrypto shared library.
.
Do not install it on a normal system.
Package: libssl-dev
Section: libdevel
Priority: optional
Architecture: any
Multi-Arch: same
Recommends: libssl-doc
Depends: libssl1.0.0 (= ${binary:Version}), zlib1g-dev, ${misc:Depends}
Description: SSL development libraries, header files and documentation
libssl and libcrypto development libraries, header files and manpages.
.
It is part of the OpenSSL implementation of SSL.
Package: libssl-doc
Section: doc
Priority: optional
Architecture: all
Replaces: libssl-dev (<< 1.0.0)
Breaks: libssl-dev (<< 1.0.0)
Depends: ${shlibs:Depends}, ${perl:Depends}, ${misc:Depends}
Description: SSL development documentation documentation
libssl and libcrypto manpages and demo files.
.
It is part of the OpenSSL implementation of SSL.
Package: libssl1.0.0-dbg
Section: debug
Priority: extra
Architecture: any
Multi-Arch: same
Depends: libssl1.0.0 (= ${binary:Version}), ${misc:Depends}
Description: Symbol tables for libssl and libcrypto
This package is part of the OpenSSL implementation of SSL.
Source: openssl
Build-Depends: debhelper (>= 8.1.3), zlib1g-dev, m4, bc, dpkg-dev (>= 1.15.7)
Section: utils
Priority: optional
Maintainer: Debian OpenSSL Team <pkg-openssl-devel@lists.alioth.debian.org>
Uploaders: Christoph Martin <christoph.martin@uni-mainz.de>, Kurt Roeckx <kurt@roeckx.be>
Standards-Version: 3.8.0
Vcs-Browser: http://svn.debian.org/wsvn/pkg-openssl/openssl
Vcs-Svn: svn://svn.debian.org/pkg-openssl/openssl/
Package: openssl
Priority: optional
Architecture: any
Depends: ${shlibs:Depends}, ${perl:Depends}, ${misc:Depends}
Suggests: ca-certificates
OpenSSL's Secure Sockets Layer implementation - xxx
This package is part of the OpenSSL project's implementation of the SSL
cryptograpfic protocol for communication security over the internet.
Description: Secure Sockets Layer implementation - binary and related cryptographic tools
This package is part of the OpenSSL project's implementation of the SSL
cryptograpfic protocol for communication security over the internet.
.
It contains the openssl binary and related tools.
.
You need it to perform cryptographic operations such as:
- Creation of RSA, DH and DSA key parameters;
- Creation of X.509 certificates, CSRs and CRLs;
- Calculation of message digests;
- Encryption and decryption with ciphers;
- SSL/TLS client and server tests;
- Handling of S/MIME signed or encrypted mail.
Package: libssl1.0.0
Section: libs
Priority: important
Architecture: any
Multi-Arch: same
Pre-Depends: ${misc:Pre-Depends}
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: Secure Sockets Layer implementation - shared libraries
This package is part of the OpenSSL project's implementation of the SSL
cryptograpfic protocol for communication security over the internet.
.
The libssl and libcrypto shared libraries are needed by programs like
apache-ssl, telnet-ssl and openssh.
Package: libcrypto1.0.0-udeb
XC-Package-Type: udeb
Section: debian-installer
Priority: optional
Architecture: any
Depends: ${shlibs:Depends}, ${misc:Depends}
Description: Secure Sockets Layer implementation - libcrypto udeb
This package is part of the OpenSSL project's implementation of the SSL
cryptograpfic protocol for communication security over the internet.
.
It contains the libcrypto shared library. Do not install it on a normal
system.
Package: libssl-dev
Section: libdevel
Priority: optional
Architecture: any
Multi-Arch: same
Recommends: libssl-doc
Depends: libssl1.0.0 (= ${binary:Version}), zlib1g-dev, ${misc:Depends}
Description: Secure Sockets Layer implementation - development files
This package is part of the OpenSSL project's implementation of the SSL
cryptograpfic protocol for communication security over the internet.
.
It contains development libraries, header files and manpages for the libssl
and libcrypto libraries.
Package: libssl-doc
Section: doc
Priority: optional
Architecture: all
Replaces: libssl-dev (<< 1.0.0)
Breaks: libssl-dev (<< 1.0.0)
Depends: ${shlibs:Depends}, ${perl:Depends}, ${misc:Depends}
Description: Secure Sockets Layer implementation - documentation
This package is part of the OpenSSL project's implementation of the SSL
cryptograpfic protocol for communication security over the internet.
.
It contains libssl and libcrypto manpages and demo files.
Package: libssl1.0.0-dbg
Section: debug
Priority: extra
Architecture: any
Multi-Arch: same
Depends: libssl1.0.0 (= ${binary:Version}), ${misc:Depends}
Description: Secure Sockets Layer implementation - debug information
This package is part of the OpenSSL project's implementation of the SSL
cryptograpfic protocol for communication security over the internet.
.
It contains symbol tables for libssl and libcrypto.
Reply to: