Martin Eberhard Schauer wrote:
> the package description of libsctp1 (1) is partly outdated:
> "… now available in the Linux kernel source tree in versions 2.5.36
> respectively 2.4.24 and following". Squeeze already has 2.6.32 and
> upstream (2) states:
>
> The Linux kernel has built-in support for the SCTP protocol since the
> 2.6 kernel series.
>
> Furthermore I would like SCTP to be explained in the first paragraph.
[...]
> Package: libsctp1
[...]
> 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.
> RFC 2960 defines the core protocol.
> .
> This library is part of the LKSCTP project for the Linux Kernel SCTP
> implementation and intended to supplement the Linux Kernel.
Thankyou for getting rid of that agonising Deutschlish use of
"respectively". But I would prefer "Kernel" to be uncapitalised
throughout; it's nearly justifiable where it's spelling out part
of LKSCTP, but certainly not in "the Linux kernel". And just how many
repeats of LK do we need, anyway? Could we trim the last paragraph
to:
This library is part of the LKSCTP project, supplementing the Linux
kernel SCTP implementation.
> Package: libsctp-dev
[...]
> 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.
> RFC 2960 defines the core protocol.
> .
> 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 implementation.
> .
> It includes man pages, header files, static libraries, symlinks to
> dynamic libraries and tutorial source code.
^
Since the new boilerplate has "Harvard comma" I would also recommend
adding one here. These paragraphs also seem repetitive. How about:
This package is part of the LKSCTP project, and contains all necessary
files for developing SCTP aware network applications using the Linux
kernel SCTP implementation: man pages, header files, [...]
> Package: lksctp-tools
[...]
> 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.
> RFC 2960 defines the core protocol.
> .
> This package is part of the LKSCTP project for the Linux Kernel SCTP
> implementation. It contains contains commandline tools and libraries to
> test SCTP functionality.
Oops: "contains contains".
> .
> 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.
The first three of these are verb phrases while the last is a noun
phrase, unnecessarily longwinded, and inconsistent in its spelling
of "userspace". While I'm changing that I'll impose the d-l-e
"house style":
.
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.
--
JBR with qualifications in linguistics, experience as a Debian
sysadmin, and probably no clue about this particular package--- control.old 2013-05-10 22:23:19.229131529 +0100
+++ control.new 2013-05-10 23:22:32.726320109 +0100
@@ -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: 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, and contains 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: 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.
