From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Juanma Barranquero Newsgroups: gmane.emacs.devel Subject: Re: new *Help* argument highlighting Date: Mon, 10 May 2004 02:11:32 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: <20040510020140.F99A.LEKTU@mi.madritel.es> References: <20040510013534.F994.LEKTU@mi.madritel.es> 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 1084148009 29056 80.91.224.253 (10 May 2004 00:13:29 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 10 May 2004 00:13:29 +0000 (UTC) Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Mon May 10 02:13:20 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 1BMyQ4-0001nX-00 for ; Mon, 10 May 2004 02:13:20 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BMyQ4-0000AH-00 for ; Mon, 10 May 2004 02:13:20 +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 1BMyPS-00018S-FP for emacs-devel@quimby.gnus.org; Sun, 09 May 2004 20:12:42 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.33) id 1BMyP0-00016O-40 for emacs-devel@gnu.org; Sun, 09 May 2004 20:12:14 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.33) id 1BMyOP-0000Zb-Fy for emacs-devel@gnu.org; Sun, 09 May 2004 20:12:12 -0400 Original-Received: from [62.81.186.17] (helo=smtp07.retemail.es) by monty-python.gnu.org with esmtp (Exim 4.33) id 1BMyOO-0000YT-B1 for emacs-devel@gnu.org; Sun, 09 May 2004 20:11:37 -0400 Original-Received: from [127.0.0.1] ([213.37.34.31]) by smtp07.retemail.es (InterMail vM.5.01.05.32 201-253-122-126-132-20030307) with ESMTP id <20040510001134.DCTE21438.smtp07.retemail.es@[127.0.0.1]>; Mon, 10 May 2004 02:11:34 +0200 Original-To: Stefan Monnier , emacs-devel@gnu.org In-Reply-To: X-Mailer: Becky! ver. 2.09.01 [en] 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:23004 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:23004 On 09 May 2004 20:00:07 -0400, Stefan Monnier wrote: > I just find it odd to highlight arguments more than, say, the function's > name (i.e. basically the title of the help buffer). I've read that already on the thread, and I find it very surprising. When I read a describe-function *Help* buffer, I'm never interested in the function's name: I already know that, I *typed* it. In 100% of cases, the reason I type C-h f is precisely to find what to pass to the args. In a great many cases, I'm interested in just a few args, because the others I remember from previous uses of the function, so having a way to quickly determine where on the docstring are these args referred seems a big win, performance-wise. I think other people must be using C-h f in very different ways to mine... > Maybe italics will make it less strange, but the current bold I see is just > very surprising because it highlights (in the literal sense) parts of the > docstring as if they were THE-THING-I-VE-BEEN-LOOKING-FOR, even when it > has strictly no indication that it's what I'm interested in. Bold, or italics, just reinforce the convention already stated by using uppercase, I think. > I didn't say fruit salad. I meant a sober presentation like you'd find in > a book (e.g. generated from Texinfo). Yeah, sorry, I didn't intend to imply that. But I get the feeling (I can be wrong) that there are people who simply likes the Help buffers with no highlighting/font-locking at all. That's also a bit surprising to me, given that we use font-locking in a lot of cases, like the recently added `completions-fist-difference' and `completions-common-part' faces. It's not like help-argument-name introduces highlighting on an otherwise very sober Emacs environment... :) > No colors, please. No, not as default. I don't think anyone would like that. /L/e/k/t/u