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

Justin B Rye jbr at edlug.org.uk
Sat Aug 23 12:56:08 UTC 2008


Package: samba-doc-pdf
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 (PDF format)
#  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 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:
* 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.

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

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





More information about the Pkg-samba-maint mailing list