[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:22 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