[Dctrl-tools-devel] Bug#557964: Bug#557964: dctrl-tools: Man page examples use quotes instead of apostrophes and backticks

Ferenc Wagner wferi at niif.hu
Mon Dec 7 18:32:47 UTC 2009


Antti-Juhani Kaijanaho <antti-juhani at kaijanaho.fi> writes:

> On Sat, Dec 05, 2009 at 06:02:05PM +0100, Ferenc Wagner wrote:
>
>> Here they are, with version 2.13.1:
>> 
>> $ LANG= man grep-dctrl | fgrep "apt|dpkg" | od -c
>> 0000000                               %       g   r   e   p   -   s   t
>> 0000020   a   t   u   s       -   P       -   e       '   a   p   t   |
>> 0000040   d   p   k   g   '  \n
>> 0000046
>> $ LANG=en_US.UTF8 man grep-dctrl | fgrep "apt|dpkg" | od -c
>> 0000000                               %       g   r   e   p   -   s   t
>> 0000020   a   t   u   s       -   P       -   e     342 200 231   a   p
>> 0000040   t   |   d   p   k   g 342 200 231  \n
>> 0000052
>
> I agree that this is a problem - but I still cannot reproduce this, and it
> means I won't be able to confirm any fix:
>
> ajk at kukkaseppele:~$ LANG=en_US.UTF8 man grep-dctrl | fgrep "apt|dpkg" | od -c
> 0000000                               %       g   r   e   p   -   s   t
> 0000020   a   t   u   s       -   P       -   e       '   a   p   t   |
> 0000040   d   p   k   g   '  \n
> 0000046
>
> Perhaps there's some groff (or man) configuration matter involved?

I don't know.  Have you got the en_US.UTF8 locale available at all?

$ locale -a
C
en_US
en_US.iso88591
en_US.utf8
hu_HU
hu_HU.iso88592
hu_HU.utf8
hungarian
POSIX

Or isn't the LANG variable overridden by LC_* in your environment?

>> The output of the second command should exactly match that of the
>> first.  The translated finnish manpage may be more correct than the
>> english original, if it exists.
>
> There is no translated man page.

Anyway, as #457839 explains:

  So, the Ascii grave accent (`) and Ascii apostrophe (') must never be
  used to describe shell syntax in groff code.

However, grep-dctrl.1 contains

  % grep\-status \-P \-e 'apt|dpkg'

If I change it to

  % grep\-status \-P \-e \(aqapt|dpkg\(aq

the problem disappears.  I don't know why the problem does not manifest
for you, but in my opinion the man page is incorrect and needs fixing.
-- 
Thanks,
Feri.





More information about the Dctrl-tools-devel mailing list