[Pkg-samba-maint] Bug#496198: libsmbclient-dev: package description overhaul

[Steve Langasek]

reassign 496198 libsmbclient
forcemerge 496197 496198
thanks

On Sat, Aug 23, 2008 at 01:54:53PM +0100, Justin B Rye wrote:
> 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.

Merging with the libsmbclient report.

Counter-proposal:

 Description: development files for libsmbclient
  This package provides the development files (static library and headers)
  required for building applications against libsmbclient, a library that
  enables client applications to talk to Microsoft Windows and Samba servers
  using the SMB/CIFS protocol.

-- 
Steve Langasek                   Give me a lever long enough and a Free OS
Debian Developer                   to set it on, and I can move the world.
Ubuntu Developer                                    http://www.debian.org/
slangasek at ubuntu.com                                     vorlon at debian.org