Bug#457839: general: Many man pages display shell quotes ` and ' wrong in Unicode environment
Teemu Likonen <tlikonen@iki.fi> writes:
> Russ Allbery kirjoitti:
>> Note that it only does this in verbatim text and in C<> blocks, so
>> people who use 'text' or `text' in general text in POD will still get
>> the Unicode quotes. I think this is the correct behavior, but I'm
>> always open to further suggestions. (I'm upstream for Pod::Man.)
> It's kind of nice to have real English single quotes is general text
> (`these' produce real quotes). They print nicely in PostScript for
> example. But yes, this causes some problems if a man page writer - be it
> a machine or human - is not aware of the difference between English
> quotes and shell quotes. There is logical difference even if they happen
> to appear the same on some systems. It's very easy to write something
> like this to man page's general text: "The string can be enclosed in
> single (') quotes." And now we have English right single quotation mark
> (and apostrophe) in man page, not a shell single quote.
Well, in this case, I'm only talking about the POD translation, in which
case writing that would be an arguable error. In POD, that should be C<'>
(which will do the right thing). POD tries to avoid markup where
possible, but it really can't tell you intended that to be literal text
without some markup.
--
Russ Allbery (rra@debian.org) <http://www.eyrie.org/~eagle/>
Reply to: