Re: inline docs

[rsteinke w-link net]

> From: Owen Taylor <otaylor redhat com>
>
> Havoc Pennington <hp redhat com> writes:
>
> > > 4) Another thing where consistency could be improved is quoting in
> > > externalized messages.
> > >     I've seen `foo', 'foo' and "foo" (there may be more variants). What is
> > > the preferred quoting in
> > >     English text ?
> > 
> > I think "foo" is correct. The single quotes are inspired by /bin/sh,
> > not written English. ;-)
>
> It should be either 'foo' or "foo". Preference between these two
> probably depends on what side of the Atlantic you are on; 
>
> Despite being on the " side of the Atlantic, I prefer the 'foo' form a
> bit because it has less visual clutter and probably because of
> Perl/Shell experience.
>
> `foo' is incorrect, and will display badly with current fonts on X.

As long as we're getting off topic on this, I'll point out that
`foo' was probably inspired by TeX, where that is the correct
way to do single quotes (and ``foo'' for double quotes, due to
playing around with ligatures).

Ron Steinke