[Pkg-samba-maint] Bug#496197: libsmbclient: package description overhaul

[Steve Langasek]

On Sat, Aug 23, 2008 at 08:54:53PM +0100, Justin B Rye wrote:
> Steve Langasek wrote:
> > > Suggested replacement text:
> > > | Description: Samba client libraries
> > > |  The Samba software suite implements the SMB/CIFS protocol, providing
> > > |  cross-platform support for Windows-style network shares.
> > > |  .
> > > |  This package provides a library for client applications that talk to
> > > |  Microsoft Windows (or Samba) servers.

> > Counter-proposal:

> >  Description: shared library for communication with SMB/CIFS servers
> >   This package provides a shared library that enables client applications
> >   to talk to Microsoft Windows and Samba servers using the SMB/CIFS
> >   protocol.

> > Again, I don't see why we should care about a boilerplate "what is Samba"
> > explanation here.

> As with libpam-smbpass, I'd be happy enough to settle for that, but
> I'd still like to see the suite name somewhere in the name+synopsis:

>    Description: shared library for communication with Samba servers

That's not accurate.  It's a shared library for communicating with *all*
SMB/CIFS servers, of which Samba is one implementation.

There are plenty of inaccuracies in the current descriptions, but if we're
going to the effort of changing them, I want the resulting descriptions to
be accurate. :)

In this case, I don't see that mentioning Samba matters at all; end users
won't need to install it directly, they'll just install a package that
depends on it, and developers will look for it by the library name and not
by the name '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