From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Stefan Newsgroups: gmane.emacs.devel Subject: uppercase var names in docstrings Date: Fri, 22 Oct 2004 16:10:53 -0400 Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Message-ID: NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1098475881 32429 80.91.229.6 (22 Oct 2004 20:11:21 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 22 Oct 2004 20:11:21 +0000 (UTC) Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Oct 22 22:11:07 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 1CL5kh-0001t2-00 for ; Fri, 22 Oct 2004 22:11:07 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CL5sC-0003zE-U0 for ged-emacs-devel@m.gmane.org; Fri, 22 Oct 2004 16:18:52 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.33) id 1CL5s4-0003z8-Vr for emacs-devel@gnu.org; Fri, 22 Oct 2004 16:18:45 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.33) id 1CL5s4-0003yw-IO for emacs-devel@gnu.org; Fri, 22 Oct 2004 16:18:44 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.33) id 1CL5s4-0003yt-Eq for emacs-devel@gnu.org; Fri, 22 Oct 2004 16:18:44 -0400 Original-Received: from [206.47.199.164] (helo=simmts6-srv.bellnexxia.net) by monty-python.gnu.org with esmtp (Exim 4.34) id 1CL5kU-0003bb-RU for emacs-devel@gnu.org; Fri, 22 Oct 2004 16:10:55 -0400 Original-Received: from empanada.home ([67.71.35.140]) by simmts6-srv.bellnexxia.net (InterMail vM.5.01.06.10 201-253-122-130-110-20040306) with ESMTP id <20041022201054.KOT1635.simmts6-srv.bellnexxia.net@empanada.home>; Fri, 22 Oct 2004 16:10:54 -0400 Original-Received: by empanada.home (Postfix, from userid 502) id 1E7F9328F23; Fri, 22 Oct 2004 16:10:54 -0400 (EDT) Original-To: emacs-devel@gnu.org User-Agent: Gnus/5.11 (Gnus v5.11) Emacs/21.3.50 (darwin) 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:28740 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:28740 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. Stefan