Michael Biebl wrote:
> Subject: Re: Bug#707739: Package description outdated
[...]
> The attached patch does not apply against debian/control from the package.
> Please send a clean patch which I can consider for review.
Okay, I attach a choice of two versions:
pkgdesc-a.diff - includes most of the proposed changes
pkgdesc-b.diff - also reorders the paragraphs
(I think Martin was right and it's more natural to explain SCTP before
explaining the role of the package, but it's not essential.)
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package
diff -ru lksctp-tools-1.0.16+dfsg.pristine/debian/control lksctp-tools-1.0.16+dfsg/debian/control
--- lksctp-tools-1.0.16+dfsg.pristine/debian/control 2014-04-13 09:08:19.000000000 +0100
+++ lksctp-tools-1.0.16+dfsg/debian/control 2015-03-15 07:05:27.711992949 +0000
@@ -16,56 +16,45 @@
Pre-Depends: ${misc:Pre-Depends}
Depends: ${shlibs:Depends}, ${misc:Depends}
Recommends: lksctp-tools
-Description: user-space access to Linux Kernel SCTP - shared library
- This library is part of the LKSCTP project for the
- Linux Kernel SCTP reference implementation.
- .
- This package is intended to supplement the Linux Kernel
- SCTP reference implementation now available in the Linux
- kernel source tree in versions 2.5.36 respectively 2.4.24 and following.
+Description: user-space access to Linux kernel SCTP - shared library
+ This library is part of the LKSCTP project, supplementing the Linux
+ kernel SCTP implementation.
.
SCTP (Stream Control Transmission Protocol) is a message oriented,
reliable transport protocol, with congestion control, support for
transparent multi-homing, and multiple ordered streams of messages.
- RFC2960 defines the core protocol.
+ RFC 2960 defines the core protocol.
Package: libsctp-dev
Section: libdevel
Priority: optional
Architecture: linux-any
Depends: libsctp1 (= ${binary:Version}), ${misc:Depends}, libc6-dev | libc-dev
-Description: user-space access to Linux Kernel SCTP - development files
- This package contains all necessary files for developing SCTP aware
- network applications using the Linux Kernel SCTP implementation.
- It is part of the LKSCTP project for the Linux Kernel SCTP
- reference implementation.
- .
- It includes man pages, header files, static libraries, symlinks to
- dynamic libraries and tutorial source code.
+Description: user-space access to Linux kernel SCTP - development files
+ This package is part of the LKSCTP project, providing all necessary
+ files for developing SCTP aware network applications using the Linux
+ kernel SCTP implementation: man pages, header files, static libraries,
+ symlinks to dynamic libraries, and tutorial source code.
.
SCTP (Stream Control Transmission Protocol) is a message oriented,
reliable transport protocol, with congestion control, support for
transparent multi-homing, and multiple ordered streams of messages.
- RFC2960 defines the core protocol.
+ RFC 2960 defines the core protocol.
Package: lksctp-tools
Section: net
Priority: optional
Architecture: linux-any
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: user-space access to Linux Kernel SCTP - commandline tools
- Commandline tools and libraries to test SCTP functionality
- .
- This package is part of the LKSCTP project.
- .
- It includes the following commandline tools:
- * checksctp: Determine if kernel supports SCTP
- * withsctp: Run existing TCP binaries over SCTP
- * sctp_darn: Send and receive messages via SCTP
- * sctp_test: Userspace test application for the SCTP kernel
- reference implementation
+Description: user-space access to Linux kernel SCTP - commandline tools
+ This package is part of the LKSCTP project, and contains libraries and
+ commandline tools to test SCTP functionality:
+ * checksctp: determine if kernel supports SCTP;
+ * withsctp: run existing TCP binaries over SCTP;
+ * sctp_darn: send and receive messages via SCTP;
+ * sctp_test: check SCTP functionality from user-space.
.
SCTP (Stream Control Transmission Protocol) is a message oriented,
reliable transport protocol, with congestion control, support for
transparent multi-homing, and multiple ordered streams of messages.
- RFC2960 defines the core protocol.
+ RFC 2960 defines the core protocol.
diff -ru lksctp-tools-1.0.16+dfsg.pristine/debian/control lksctp-tools-1.0.16+dfsg/debian/control
--- lksctp-tools-1.0.16+dfsg.pristine/debian/control 2014-04-13 09:08:19.000000000 +0100
+++ lksctp-tools-1.0.16+dfsg/debian/control 2015-03-15 07:13:31.833565043 +0000
@@ -16,56 +16,45 @@
Pre-Depends: ${misc:Pre-Depends}
Depends: ${shlibs:Depends}, ${misc:Depends}
Recommends: lksctp-tools
-Description: user-space access to Linux Kernel SCTP - shared library
- This library is part of the LKSCTP project for the
- Linux Kernel SCTP reference implementation.
- .
- This package is intended to supplement the Linux Kernel
- SCTP reference implementation now available in the Linux
- kernel source tree in versions 2.5.36 respectively 2.4.24 and following.
- .
+Description: user-space access to Linux kernel SCTP - shared library
SCTP (Stream Control Transmission Protocol) is a message oriented,
reliable transport protocol, with congestion control, support for
transparent multi-homing, and multiple ordered streams of messages.
- RFC2960 defines the core protocol.
+ RFC 2960 defines the core protocol.
+ .
+ This library is part of the LKSCTP project, supplementing the Linux
+ kernel SCTP implementation.
Package: libsctp-dev
Section: libdevel
Priority: optional
Architecture: linux-any
Depends: libsctp1 (= ${binary:Version}), ${misc:Depends}, libc6-dev | libc-dev
-Description: user-space access to Linux Kernel SCTP - development files
- This package contains all necessary files for developing SCTP aware
- network applications using the Linux Kernel SCTP implementation.
- It is part of the LKSCTP project for the Linux Kernel SCTP
- reference implementation.
- .
- It includes man pages, header files, static libraries, symlinks to
- dynamic libraries and tutorial source code.
- .
+Description: user-space access to Linux kernel SCTP - development files
SCTP (Stream Control Transmission Protocol) is a message oriented,
reliable transport protocol, with congestion control, support for
transparent multi-homing, and multiple ordered streams of messages.
- RFC2960 defines the core protocol.
+ RFC 2960 defines the core protocol.
+ .
+ This package is part of the LKSCTP project, providing all necessary
+ files for developing SCTP aware network applications using the Linux
+ kernel SCTP implementation: man pages, header files, static libraries,
+ symlinks to dynamic libraries, and tutorial source code.
Package: lksctp-tools
Section: net
Priority: optional
Architecture: linux-any
Depends: ${shlibs:Depends}, ${misc:Depends}
-Description: user-space access to Linux Kernel SCTP - commandline tools
- Commandline tools and libraries to test SCTP functionality
- .
- This package is part of the LKSCTP project.
- .
- It includes the following commandline tools:
- * checksctp: Determine if kernel supports SCTP
- * withsctp: Run existing TCP binaries over SCTP
- * sctp_darn: Send and receive messages via SCTP
- * sctp_test: Userspace test application for the SCTP kernel
- reference implementation
- .
+Description: user-space access to Linux kernel SCTP - commandline tools
SCTP (Stream Control Transmission Protocol) is a message oriented,
reliable transport protocol, with congestion control, support for
transparent multi-homing, and multiple ordered streams of messages.
- RFC2960 defines the core protocol.
+ RFC 2960 defines the core protocol.
+ .
+ This package is part of the LKSCTP project, and contains libraries and
+ commandline tools to test SCTP functionality:
+ * checksctp: determine if kernel supports SCTP;
+ * withsctp: run existing TCP binaries over SCTP;
+ * sctp_darn: send and receive messages via SCTP;
+ * sctp_test: check SCTP functionality from user-space.
