[Pkg-samba-maint] Bug#496202: samba-doc: package description overhaul

[Justin B Rye]

Package: samba-doc
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 documentation
#  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 all the documentation that comes in the original
#  tarball, except in PDF format.

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.

Problems shared with its twin, samba-doc-pdf:
* don't talk about "the original tarball".  Your users aren't coming
	from a Slackware background, they're Windows refugees; for
	them, this is unnecessary programmer jargon.

Problems unique to this package:
* the natural interpretration of that last sentence is that this
	package contains _only_ the PDF versions of the docs!

Suggested replacement text:
| Description: Samba documentation
|  The Samba software suite implements the SMB/CIFS protocol, providing
|  cross-platform support for Windows-style network shares.
|  .
|  This package contains all the non-PDF documentation for the Samba
|  suite. See also samba-doc-pdf.

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