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

Steve Langasek vorlon at debian.org
Mon Aug 25 05:20:55 UTC 2008


reassign 496201 samba
forcemerge 496200 496201
thanks

Merging the samba-dbg and samba reports, since the descriptions for the two
should be very similar.

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

Actually, it covers the samba, smbclient, samba-common, and winbind
packages.  It doesn't cover samba-tools, swat, smbfs, libpam-smbpass,
libsmbclient, or libwbclient0.

So I'm not sure whether it's worthwhile to enumerate the covered packages in
the description, or if it's better to say that it's debugging information
for "the software in the Samba suite"?

> 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. 

Reconciling with the updated description for samba:

 Description: Samba debugging symbols
  Samba is an implementation of the SMB/CIFS protocol for Unix systems,
  providing support for cross-platform file and printer sharing with
  Microsoft Windows, OS X, and other Unix systems.
  .
  This package provides debugging information for the software in the
  Samba suite. Install it to get a better backtrace in the event of a
  crash.

Alternatively, it might be appropriate to flip the paragraphs to give the
explanation of samba-dbg before the general description of samba?

-- 
Steve Langasek                   Give me a lever long enough and a Free OS
Debian Developer                   to set it on, and I can move the world.
Ubuntu Developer                                    http://www.debian.org/
slangasek at ubuntu.com                                     vorlon at debian.org





More information about the Pkg-samba-maint mailing list