[Pkg-samba-maint] Bug#496204: samba-common: package description overhaul

[Justin B Rye]

Package: samba-common
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: Samba common files used by both the server and the client
#  The Samba software suite is a collection of programs that
#  implements the SMB/CIFS protocol for unix systems, allowing you to serve
#  files and printers to Windows, NT, OS/2 and DOS clients. This protocol
#  is sometimes also referred to as the LanManager or NetBIOS protocol.
#  .
#  This package contains the common files that are used by both the server
#  (provided in the samba package) and the client (provided in the smbclient
#  package).

Problems shared with other packages in the set:
* Samba is all about OS interoperability, so keep the OS names
	straight.  It's not just for "unix systems", it's also for
	GNU/Linux!  Likewise, "Windows, NT, OS/2 and DOS clients"...
	NT is also Windows, and Samba works for (smbclient on)
	OpenVMS too!
* the SMB/CIFS protocol is only referred to as "the LanManager or
	NetBIOS protocol" by people copying this text.

There's only one, relatively mild problem unique to this package:
* repetition of the phrase "common files used by both the server
	[...] and the client".

Suggested replacement text:
| Description: Samba common files used by both the server and the client
|  The Samba software suite implements the SMB/CIFS protocol, providing
|  cross-platform support for Windows-style network shares.
|  .
|  This package contains files needed by both the samba and smbclient
|  packages.
-- 
JBR - please CC me (or the debian-l10n-english list) in replies