From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Miles Bader Newsgroups: gmane.emacs.devel Subject: Re: new *Help* argument highlighting Date: Sat, 8 May 2004 19:49:56 -0400 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <20040508234956.GA23847@fencepost> References: <20040507102604.2132.JMBARRANQUERO@wke.es> <87k6zmzhky.fsf@mail.jurta.org> <20040509013011.40E1.LEKTU@mi.madritel.es> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: sea.gmane.org 1084060376 16547 80.91.224.253 (8 May 2004 23:52:56 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Sat, 8 May 2004 23:52:56 +0000 (UTC) Cc: Juri Linkov , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Sun May 09 01:52:50 2004 Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by deer.gmane.org with esmtp (Exim 3.35 #1 (Debian)) id 1BMbcg-0007vs-00 for ; Sun, 09 May 2004 01:52:50 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BMbcg-0000Xd-00 for ; Sun, 09 May 2004 01:52:50 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.33) id 1BMbbO-0000Zp-Nh for emacs-devel@quimby.gnus.org; Sat, 08 May 2004 19:51:30 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.33) id 1BMbaV-0008Hx-Hy for emacs-devel@gnu.org; Sat, 08 May 2004 19:50:35 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.33) id 1BMbZu-0007mg-CP for emacs-devel@gnu.org; Sat, 08 May 2004 19:50:30 -0400 Original-Received: from [199.232.76.164] (helo=fencepost.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.33) id 1BMbZt-0007lU-EK for emacs-devel@gnu.org; Sat, 08 May 2004 19:49:57 -0400 Original-Received: from miles by fencepost.gnu.org with local (Exim 4.33) id 1BMbZs-000737-TN; Sat, 08 May 2004 19:49:56 -0400 Original-To: Juanma Barranquero Content-Disposition: inline In-Reply-To: <20040509013011.40E1.LEKTU@mi.madritel.es> User-Agent: Mutt/1.3.28i Blat: Foop X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.4 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Xref: main.gmane.org gmane.emacs.devel:22953 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:22953 On Sun, May 09, 2004 at 01:32:25AM +0200, Juanma Barranquero wrote: > > So perhaps highlighting a function name will help a bit. > > Hmm. I don't object to changing what it does now, obviously, but I fear > too highlighting would turn the *Help* buffer into a christmas tree. So > let's hear what others have to say about it. I agree[*]. I think that if the highlighted args are too noticeable, we should reduce their highlighting, not start highlighting everything else. Perhaps Juanma's suggestion of changing the arg-highlighting to `bold' instead of `font-lock-...-face' will do that. Personally I wish we had even more subtle methods of highlighting (e.g., an underline with very sparsely-spaced dots instead of a solid line). [*] Note that a *Help* buffer is very different from a source code buffer: a source code buffer is usually very long and full of text, and using colored faces helps you visually organize the mass of text more quickly, but a *Help* buffer is usually short and concise, and already written with easy readability as a goal, so excessive highlighting often just detracts from readability. -Miles -- Fast, small, soon; pick any 2.