From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Juri Linkov Newsgroups: gmane.emacs.devel Subject: Re: uppercase var names in docstrings Date: Sat, 23 Oct 2004 02:27:18 +0300 Organization: JURTA Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: <87k6tixrjd.fsf@jurta.org> References: <20041022223615.GB5437@fencepost> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1098488039 28664 80.91.229.6 (22 Oct 2004 23:33:59 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 22 Oct 2004 23:33:59 +0000 (UTC) Cc: Stefan , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Oct 23 01:33:47 2004 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1CL8up-0006co-00 for ; Sat, 23 Oct 2004 01:33:47 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CL92L-0005bM-Lu for ged-emacs-devel@m.gmane.org; Fri, 22 Oct 2004 19:41:33 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CL92D-0005aw-Pf for emacs-devel@gnu.org; Fri, 22 Oct 2004 19:41:25 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CL92C-0005aI-Li for emacs-devel@gnu.org; Fri, 22 Oct 2004 19:41:24 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CL92C-0005aF-Iy for emacs-devel@gnu.org; Fri, 22 Oct 2004 19:41:24 -0400 Original-Received: from [66.33.219.6] (helo=knife.dreamhost.com) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CL8uc-00068y-UJ; Fri, 22 Oct 2004 19:33:36 -0400 Original-Received: from mail.jurta.org (80-235-37-219-dsl.mus.estpak.ee [80.235.37.219]) by knife.dreamhost.com (Postfix) with ESMTP id EEAD5E4127; Fri, 22 Oct 2004 16:33:31 -0700 (PDT) Original-To: Miles Bader In-Reply-To: <20041022223615.GB5437@fencepost> (Miles Bader's message of "Fri, 22 Oct 2004 18:36:15 -0400") User-Agent: Gnus/5.110002 (No Gnus v0.2) Emacs/21.3.50 (gnu/linux) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:28758 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:28758 Miles Bader writes: > 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 ...] Instead of italics (which is unreadable with small font sizes) I highlight lowercase arguments in a dark color (namely, DeepSkyBlue4, but any other dark color will work): it is close to black (which is the default text color; however, in help-argument-name's defface it might depend on dark/light background parameter), so it doesn't attract much attention. OTOH, it still differs from black enough to stand out sufficiently. So, lowercase+colors is another solution to try. -- Juri Linkov http://www.jurta.org/emacs/