[Pkg-samba-maint] Bug#496198: libsmbclient-dev: package description overhaul
Justin B Rye
jbr at edlug.org.uk
Sat Aug 23 12:54:53 UTC 2008
Package: libsmbclient-dev
Version: 2:3.2.1-1
Severity: minor
This is part of a set of related bugreports on the packages in the
Samba suite; I've already reported many of these issues (with some
suggested fixes) as a single bugreport on samba4 (see #486370), but
since that approach is a dud I'm trying the alternative of splitting
them up and targetting individual packages.
Current package description:
# Description: libsmbclient static libraries and headers
# libsmbclient allows to write applications that use the SMB/CIFS protocol.
# This gives applications the ability to talk to Microsoft Windows servers
# and Unix servers running Samba.
# .
# This package contains libraries and headers needed to build applications
# that use SMB/CIFS services.
Problems shared with other packages in the set:
* "allows to write" is a very characteristic non-native-speakerism.
* the words "applications" and "servers" are overused.
* Samba is all about OS interoperability, so keep the OS names
straight. It's not just for "Unix servers", it's also for
GNU/Linux!
* and the wishlist item: WIBNI all the packages in the suite had
consistently styled short descriptions. Likewise, in this
case, consistent what-Samba-is boilerplate.
Suggested replacement text:
| Description: Samba client development libraries
| The Samba software suite implements the SMB/CIFS protocol, providing
| cross-platform support for Windows-style network shares.
| .
| This package contains libraries and headers for building client
| applications that talk to Microsoft Windows (or Samba) servers.
--
JBR - please CC me (or the debian-l10n-english list) in replies
More information about the Pkg-samba-maint
mailing list