From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: Stefan Monnier Newsgroups: gmane.emacs.devel Subject: Re: new *Help* argument highlighting Date: 09 May 2004 22:42:01 -0400 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <20040510020140.F99A.LEKTU@mi.madritel.es> <20040510023212.F99D.LEKTU@mi.madritel.es> NNTP-Posting-Host: deer.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: sea.gmane.org 1084157412 20254 80.91.224.253 (10 May 2004 02:50:12 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Mon, 10 May 2004 02:50:12 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Mon May 10 04:50:00 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 1BN0rg-0006HN-00 for ; Mon, 10 May 2004 04:50:00 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BN0rg-0003OL-00 for ; Mon, 10 May 2004 04:50:00 +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 1BN0m5-0006ix-7i for emacs-devel@quimby.gnus.org; Sun, 09 May 2004 22:44:13 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.33) id 1BN0kY-0006Xn-Vj for emacs-devel@gnu.org; Sun, 09 May 2004 22:42:39 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.33) id 1BN0k1-0006On-Qe for emacs-devel@gnu.org; Sun, 09 May 2004 22:42:37 -0400 Original-Received: from [132.204.24.67] (helo=mercure.iro.umontreal.ca) by monty-python.gnu.org with esmtp (Exim 4.33) id 1BN0k0-0006O4-Td for emacs-devel@gnu.org; Sun, 09 May 2004 22:42:05 -0400 Original-Received: from asado.iro.umontreal.ca (asado.iro.umontreal.ca [132.204.24.84]) by mercure.iro.umontreal.ca (Postfix) with ESMTP id F070C21221; Sun, 9 May 2004 22:42:01 -0400 (EDT) Original-Received: by asado.iro.umontreal.ca (Postfix, from userid 20848) id AA0628C6AE; Sun, 9 May 2004 22:42:01 -0400 (EDT) Original-To: Juanma Barranquero In-Reply-To: <20040510023212.F99D.LEKTU@mi.madritel.es> Original-Lines: 36 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3.50 X-DIRO-MailScanner-Information: Please contact the ISP for more information X-DIRO-MailScanner: Found to be clean X-DIRO-MailScanner-SpamCheck: n'est pas un polluriel, SpamAssassin (score=-0.001, requis 5, BAYES_44 -0.00) 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:23015 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:23015 >> I think you're wrong. There's a lot of problems with adding colors. > Sure. But we already have lots of faces, some of which add colors with > not much remorse: I know, but you were saying that there is some resistance against adding highlighting, and I think the resistance is more against colors. The reason why the two are often mixed is because indeed most highlighting adds color (believe me, I don't like that: the fist thing I did when I tried font-lock was to remove all colors (other than grey for comments) and restrict myself to bold/italics. Nowadays I live with colors on various faces for the simple reason that there are too many faces and I don't have the time/energy to customize them all to something else). > (defface smerge-mine-face Funnily, for SMerge, I think colors are the way to go (in my setup at least) because those faces are added to the ones normally added by font-lock, so since my font-lock faces don't use colors, my smerge faces are properly combined with the font-lock ones. >> As said, it's not the fact of highlighting that surprises, it's just the >> fact that args and only args are highlighted as if they were so >> very special. > Aren't? In an elisp function's help, I honestly don't know what else > could be special... Perhaps if we had a more structured style guide for > function docstrings, with sections =C3=A0 la: Well I find the highlighting attracts my eye to the arguments, but not to the text that surrounds it, whereas I don't care so much about the argument as I care about the text. Basically, my reaction is "Hmm... the argument OVERLAY is used three times in the docstring; now, why should I care?". Stefan