GNU bug report logs - #7577
non-ascii char in manpage

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 7577 in the body.
You can then email your comments to 7577 AT debbugs.gnu.org in the normal way.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: tsener <at> bsdmail.com
To: bug-coreutils <at> gnu.org
Subject: non-ascii char in manpage
Date: Tue, 07 Dec 2010 04:30:23 -0500

[Message part 1 (text/plain, inline)]

 

 Hi there,

reading through the man page for date,  I found this two that look like a typo, (â) I guess I could be wrong, but:
 %x    localeâs date representation (e.g., 12/31/99)
 %X     localeâs time representation (e.g., 23:13:48)


Regards,
tsener

[Message part 2 (text/html, inline)]

Message #8 received at 7577 <at> debbugs.gnu.org (full text, mbox):

From: Eric Blake <eblake <at> redhat.com>
To: tsener <at> bsdmail.com
Cc: 7577 <at> debbugs.gnu.org
Subject: Re: bug#7577: non-ascii char in manpage
Date: Tue, 07 Dec 2010 08:15:22 -0700

[Message part 1 (text/plain, inline)]

On 12/07/2010 02:30 AM, tsener <at> bsdmail.com wrote:
>  Hi there,
> 
> reading through the man page for date,  I found this two that look like a typo, (â) I guess I could be wrong, but:
>  %x    localeâs date representation (e.g., 12/31/99)
>  %X     localeâs time representation (e.g., 23:13:48)

Thanks for the report.  This is not a bug in coreutils, per se.  Rather,
it is probably an issue that help2man (which is how we generate man
pages automatically from 'date --help' output) is outputting a raw ASCII
' (rather than using roff markup for an apostrophe that renders better
according to locale, or even the roff markup for an explicit \x27 byte
regardless of locale).  Then, you couple that with some versions of man
that try to display unescaped ' in man sources as a nicer
charset-specific ’ (here's hoping your email program renders that
decently), but in such a manner that it used a different charset
encoding than what your current terminal supports, resulting in the
wrong glyph being displayed.

I don't know if there's anything coreutils could do to address this.
You might want to raise a bug report with help2man to see if that
program can do a better job of converting ` and ' into appropriate roff
escapes (whether for literal ASCII bytes, or for stylized
locale-specific angled single quotes - it may require some hefty
heuristics to get right, when translating from simple --help output).
Or, you might file a bug report against your distro's version of man for
being "too" smart and transliterating raw apostrophes into the wrong
charset rather than passing them through unchanged.

-- 
Eric Blake   eblake <at> redhat.com    +1-801-349-2682
Libvirt virtualization library http://libvirt.org

[signature.asc (application/pgp-signature, attachment)]

Message #13 received at 7577-done <at> debbugs.gnu.org (full text, mbox):

From: Jim Meyering <jim <at> meyering.net>
To: tsener <at> bsdmail.com
Cc: 7577-done <at> debbugs.gnu.org
Subject: Re: bug#7577: non-ascii char in manpage
Date: Sun, 03 Jul 2011 16:46:01 +0200

tsener <at> bsdmail.com wrote:
> reading through the man page for date, I found this two that look like
> a typo, (â) I guess I could be wrong, but:
>  %x    localeâs date representation (e.g., 12/31/99)
>  %X     localeâs time representation (e.g., 23:13:48)

Thanks for the report.
I'm marking this as closed, since the generated man.1 file seems to be ok.
Feel free to reopen if you find it's still a problem:

    $ grep 'locale.*date.rep' man/date.1
    locale's date representation (e.g., 12/31/99)

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.