Re: uppercase var names in docstrings

[Miles Bader <miles@gnu.org>]

On Fri, Oct 22, 2004 at 04:10:53PM -0400, Stefan wrote:
> Of course I can change my own setting easily, but if I'm not the only
> oddball who feels this way, maybe it'd better to change the default so that
> such varnames are only made italics but not lowercase.

I find that the old-style uppercase names actually makes the text hard to
read for the opposite reason -- they stand out way _too_ much, they interrupt
the flow of reading (it's like reading a zippy quote!).

OTOH, I agree that italics-only is sometimes a bit hard to find in the text.
It depends a great deal on the fonts you use though -- at work I don't have
any problem with just italics.

At home, I use: lowercase+underline -- lowercase makes it read naturally like
part of the text, but the underlining makes them hard to miss.  [I realize
that some people may not like this because they look the same as hyperlinks;
I know the the difference between the two, so I don't care, but ...]

So, while maybe a tweak is in order, I think uppercase+(anything) is too much.

-Miles
-- 
(\(\
(^.^)
(")")
*This is the cute bunny virus, please copy this into your sig so it can spread.