[Pkg-samba-maint] Bug#470844: Bug#470844: encoding issue with spaces in nmblookup(1) synopsis

Steve Langasek vorlon at debian.org
Mon Mar 24 04:07:03 UTC 2008


clone 470844 -1
reassign -1 man-db
retitle -1 man: does not handle embedded iso8859-1 nbsp chars
thanks

On Fri, Mar 14, 2008 at 07:29:07AM +0100, Christian Perrier wrote:
> Quoting Filipus Klutiero (chealer at gmail.com):
> > Package: samba-common
> > Version: 3.0.28-4
> > Severity: minor

> > konqueror shows the SYNOPIS section of nmblookup's manpage like this:

> > SYNOPSIS
> > nmblookup [-M] [-R] [-S] [-r] [-A] [-h] [-B�<broadcast�address>] 
> > [-U�<unicast�address>] [-d�<debug�level>] [-s�<smb�config�file>] 
> > [-i�<NetBIOS�scope>] [-T] [-f] {name} 

> > man like this:
> > SYNOPSIS
> >        nmblookup [-M] [-R] [-S] [-r] [-A] [-h] [-B<broadcastaddress>] 
> > [-U<unicastaddress>] [-d<debuglevel>] [-s<smbconfigfile>] [-i<NetBIOSscope>] 
> > [-T] [-f] {name}

> > The characters look like simple spaces in stable.

> Apparently, these are non-breakable spaces....encoded in ISO-8859-1.
> I'm not sure this can be called incorrect. Colin

> I don't see any deep reasons for these spaces to be uncreakable,
> though. I'd rather see them as regular spaces, which would help good
> portability of original manpages.

> Samba's manpages are generated from XML files in upstream's samba-doc
> SVN. They are included in upstream's distribution when releases are
> published.. The fix should probably go there rather than having a
> Debian-cooked patch to the generated manpages

Interestingly, there are no non-break spaces in the original HTML sources
for these documents; so these are entirely an artifact of the translation
tools (db2man.xsl?) used by upstream.

I've prepared a patch that replaces all of the \xA0 chars in the manpages
with the "\ " sequence Colin mentions, and will commit to svn shortly; and
I'm cloning this bug to man-db in case Colin thinks this smashing of 0xA0 is
something that should be fixed there.

Long term, to fix this upstream will require a fix to whatever version of
the db2man toolchain upstream is using.

Cheers,
-- 
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