From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Drew Adams" Newsgroups: gmane.emacs.devel Subject: RE: uppercase var names in docstrings Date: Fri, 22 Oct 2004 13:30:39 -0700 Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: References: NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1098477082 3269 80.91.229.6 (22 Oct 2004 20:31:22 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 22 Oct 2004 20:31:22 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 22 22:31:10 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 1CL646-0003QX-00 for ; Fri, 22 Oct 2004 22:31:10 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CL6Bc-0000Tl-4J for ged-emacs-devel@m.gmane.org; Fri, 22 Oct 2004 16:38:56 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CL6BS-0000TV-2M for emacs-devel@gnu.org; Fri, 22 Oct 2004 16:38:46 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CL6BR-0000TJ-KX for emacs-devel@gnu.org; Fri, 22 Oct 2004 16:38:45 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CL6BR-0000TG-G2 for emacs-devel@gnu.org; Fri, 22 Oct 2004 16:38:45 -0400 Original-Received: from [141.146.126.229] (helo=agminet02.oracle.com) by monty-python.gnu.org with esmtp (TLSv1:DES-CBC3-SHA:168) (Exim 4.34) id 1CL63u-0006Ku-HE for emacs-devel@gnu.org; Fri, 22 Oct 2004 16:30:58 -0400 Original-Received: from rgmgw3.us.oracle.com (rgmgw3.us.oracle.com [138.1.191.12]) by agminet02.oracle.com (Switch-3.1.4/Switch-3.1.0) with ESMTP id i9MKUl6p025444; Fri, 22 Oct 2004 13:30:47 -0700 Original-Received: from rgmgw3.us.oracle.com (localhost [127.0.0.1]) by rgmgw3.us.oracle.com (Switch-3.1.4/Switch-3.1.0) with ESMTP id i9MKUk19004793; Fri, 22 Oct 2004 14:30:46 -0600 Original-Received: from dradamslap (dhcp-amer-vpn-rmdc-gw2-west-141-144-112-94.vpn.oracle.com [141.144.112.94]) by rgmgw3.us.oracle.com (Switch-3.1.4/Switch-3.1.0) with SMTP id i9MKUgqK004583; Fri, 22 Oct 2004 14:30:46 -0600 Original-To: "Stefan" , X-Priority: 3 (Normal) X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook IMO, Build 9.0.6604 (9.0.2911.0) Importance: Normal In-Reply-To: X-MimeOLE: Produced By Microsoft MimeOLE V6.00.2800.1441 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:28741 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:28741 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.