[Pkg-samba-maint] Bug#496201: samba-dbg: package description overhaul

[Justin B Rye]

Package: samba-dbg
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 debugging symbols
#  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 debugging symbols for the programs included in
#  the samba and smbclient packages.

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.
* developer-centric documentation: include some material for the
	sake of users who think "symbols" means Wingdings™.

And one problem unique to this package:
* documentation bitrot already?  samba-dbg covers the whole suite,
	not just "the samba and smbclient packages".

Suggested replacement text:
| Description: Samba debugging symbols
|  The Samba software suite implements the SMB/CIFS protocol, providing
|  cross-platform support for Windows-style network shares.
|  .
|  This package provides debugging information for all the software in
|  the Samba suite. Install it to get a better backtrace in the event
|  of a crash. 

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