[Top][All Lists]

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

Re: uppercase var names in docstrings

From: Miles Bader
Subject: Re: uppercase var names in docstrings
Date: Fri, 22 Oct 2004 18:36:15 -0400
User-agent: Mutt/1.3.28i

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.

*This is the cute bunny virus, please copy this into your sig so it can spread.

reply via email to

[Prev in Thread] Current Thread [Next in Thread]