[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

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: