From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: "Lennart Borgman" Newsgroups: gmane.emacs.devel Subject: Re: uppercase var names in docstrings Date: Fri, 22 Oct 2004 22:56:03 +0200 Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: <002001c4b87a$2b95e060$0200a8c0@sedrcw11488> References: NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1098478848 7915 80.91.229.6 (22 Oct 2004 21:00:48 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 22 Oct 2004 21:00:48 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 22 23:00:29 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 1CL6WT-0005hT-00 for ; Fri, 22 Oct 2004 23:00:29 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CL6dy-0001Bm-UC for ged-emacs-devel@m.gmane.org; Fri, 22 Oct 2004 17:08:14 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CL6dr-0001B5-GA for emacs-devel@gnu.org; Fri, 22 Oct 2004 17:08:07 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CL6dq-0001Ai-Sm for emacs-devel@gnu.org; Fri, 22 Oct 2004 17:08:07 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CL6dq-0001AU-Hl for emacs-devel@gnu.org; Fri, 22 Oct 2004 17:08:06 -0400 Original-Received: from [81.228.10.116] (helo=av1-1-sn4.m-sp.skanova.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CL6Vy-0002Cy-C6 for emacs-devel@gnu.org; Fri, 22 Oct 2004 16:59:58 -0400 Original-Received: by av1-1-sn4.m-sp.skanova.net (Postfix, from userid 502) id 9837537E71; Fri, 22 Oct 2004 22:59:57 +0200 (CEST) Original-Received: from smtp2-2-sn4.m-sp.skanova.net (smtp2-2-sn4.m-sp.skanova.net [81.228.10.182]) by av1-1-sn4.m-sp.skanova.net (Postfix) with ESMTP id 8981F37E48; Fri, 22 Oct 2004 22:59:57 +0200 (CEST) Original-Received: from sedrcw11488 (t2o58p129.telia.com [62.20.165.129]) by smtp2-2-sn4.m-sp.skanova.net (Postfix) with SMTP id D08A337E44; Fri, 22 Oct 2004 22:59:55 +0200 (CEST) Original-To: "Drew Adams" , "Stefan" , X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 6.00.2800.1409 X-MIMEOLE: Produced By Microsoft MimeOLE V6.00.2800.1409 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:28743 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:28743 I am not very fond of italics on screen. They tend to appear rugged, at least on my screens. Uppercase have been a good alternative for me, but maybe bold italics is less rugged than just italics? - Lennart ----- Original Message ----- From: "Drew Adams" To: "Stefan" ; Sent: Friday, October 22, 2004 10:30 PM Subject: RE: uppercase var names in docstrings : 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.