unofficial mirror of emacs-devel@gnu.org 
 help / color / mirror / code / Atom feed
From: "Drew Adams" <drew.adams@oracle.com>
Subject: RE: uppercase var names in docstrings
Date: Fri, 22 Oct 2004 13:30:39 -0700	[thread overview]
Message-ID: <FDELKNEBLPKKDCEBEJCBGEKICIAA.drew.adams@oracle.com> (raw)
In-Reply-To: <m1is92plin.fsf-monnier+emacs@gnu.org>

FWIW, my impression is the same as Stefan's.

I think it might be good to try bold italic (and lowercase); I believe that
would stand out sufficiently. If bold italic is not supported by a given
face, then bold would be a good second choice, plain uppercase being a third
choice. - Drew


-----Original Message-----From: Stefan
A few months ago, the help code was changed so that C-h f now looks for the
uppercase variable names and makes them lowercase&italics (if the terminal
supports it).

I waited to see how I'd like it and I must say that I'm actually annoyed by
the lowercasing: it makes it much harder for me to find the spot in
a docstring where the use of a particular argument is described.

Basically the problem is that varnames don't stand out as much as before,
since the only thing that distinguishes them from normal text is
the italics.

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.

  reply	other threads:[~2004-10-22 20:30 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2004-10-22 20:10 uppercase var names in docstrings Stefan
2004-10-22 20:30 ` Drew Adams [this message]
2004-10-22 20:56   ` Lennart Borgman
2004-10-22 22:26     ` Miles Bader
2004-10-22 22:28       ` David Kastrup
2004-10-22 22:33       ` Lennart Borgman
2004-10-22 22:44         ` Miles Bader
2004-10-22 21:52 ` Nick Roberts
2004-10-22 22:36 ` Miles Bader
2004-10-22 23:27   ` Juri Linkov
2004-10-23 13:54   ` Richard Stallman
2004-10-23  0:42 ` Kenichi Handa

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: https://www.gnu.org/software/emacs/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=FDELKNEBLPKKDCEBEJCBGEKICIAA.drew.adams@oracle.com \
    --to=drew.adams@oracle.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).