[Pkg-samba-maint] Bug#351911: #351911 samba-doc: manpage for nonexistent command smbsh

[Steve Langasek]

On Fri, Jun 22, 2007 at 05:26:49PM +0200, Noèl Köthe wrote:
> the samba-doc package contains:

> /usr/share/doc/samba-doc/htmldocs/manpages/smbsh.1.html
> /usr/share/doc/samba-doc/examples/libsmbclient/smbwrapper/smbsh.c.gz

> The bug is we have the manpage there but not the program. The program
> has to be built by the user.

> I see the following options:

> 1. remove smbsh.1.html
> 2. build and add smbsh to the package 
> 3. tag wontfix because upstream desided not to add this only as example

> What do the other samba package maintainer think about this?

smbsh hasn't been viable on Linux for a long time, because the method used
for implementing smbwrapper stopped working due to glibc changes.  I don't
believe anyone has taken the time to get it working upstream since then.

So 2) is not an option AFAIK.

3) doesn't make sense to me, I don't see why you would want to ship a
manpage in section 1 for a non-existent "example" program.

1) looks correct to me.

On Fri, Jun 22, 2007 at 06:00:23PM +0200, Peter Eisentraut wrote:
> Am Freitag, 22. Juni 2007 17:26 schrieb Noèl Köthe:
> > I see the following options:
> >
> > 1. remove smbsh.1.html
> > 2. build and add smbsh to the package
> > 3. tag wontfix because upstream desided not to add this only as example

> > What do the other samba package maintainer think about this?

> Report to upstream why they have a man page in the main documentation for an 
> example program.

Yep.

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