Package: src:openssl
Version: 1.0.1e-3
Severity: wishlist
X-Debbugs-CC: debian-l10n-engl...@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-de...@lists.alioth.debian.org>
Uploaders: Christoph Martin <christoph.mar...@uni-mainz.de>, Kurt Roeckx 
<k...@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-de...@lists.alioth.debian.org>
Uploaders: Christoph Martin <christoph.mar...@uni-mainz.de>, Kurt Roeckx 
<k...@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 via email to