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
--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
