[Pkg-samba-maint] Bug#496199: libwbclient0: package description overhaul

[Justin B Rye]

Package: libwbclient0
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: client library for interfacing with winbind service
#  libwbclient is an API for client interactions with the winbind service.
#  This library abstracts the winbind pipe protocol into a stable API that
#  allows the winbind server to be independently upgraded.

Problems shared with other packages in the set:
* this synopsis obeys DevRef's recommendation of dropping an initial
	article, but then overzealously extends the rule to "[a/the]
	winbind service".
* developer-centric documentation: users don't install libwbclient0
	to get an API, they install it to run applications (or just
	because kde depends on it).
* 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 winbind client library
|  The Samba software suite implements the SMB/CIFS protocol, providing
|  cross-platform support for Windows-style network shares.
|  .
|  This package provides a library for client applications that interact
|  via the winbind pipe protocol with a Samba winbind server.

-- 
JBR - please CC me (or the debian-l10n-english list) in replies