From mboxrd@z Thu Jan 1 00:00:00 1970 Path: main.gmane.org!not-for-mail From: storm@cua.dk (Kim F. Storm) Newsgroups: gmane.emacs.devel Subject: Re: Improved help from minibuffer prompts Date: 30 Apr 2004 12:08:47 +0200 Sender: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Message-ID: References: <20040430014041.F09B.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 1083314276 31579 80.91.224.253 (30 Apr 2004 08:37:56 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Fri, 30 Apr 2004 08:37:56 +0000 (UTC) Cc: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+emacs-devel=quimby.gnus.org@gnu.org Fri Apr 30 10:37:44 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 1BJTWh-0005CD-00 for ; Fri, 30 Apr 2004 10:37:43 +0200 Original-Received: from monty-python.gnu.org ([199.232.76.173]) by quimby.gnus.org with esmtp (Exim 3.35 #1 (Debian)) id 1BJTWh-0007SB-00 for ; Fri, 30 Apr 2004 10:37:43 +0200 Original-Received: from localhost ([127.0.0.1] helo=monty-python.gnu.org) by monty-python.gnu.org with esmtp (Exim 4.30) id 1BJTTs-0004dm-6g for emacs-devel@quimby.gnus.org; Fri, 30 Apr 2004 04:34:48 -0400 Original-Received: from list by monty-python.gnu.org with tmda-scanned (Exim 4.30) id 1BJTTd-0004bF-2S for emacs-devel@gnu.org; Fri, 30 Apr 2004 04:34:33 -0400 Original-Received: from mail by monty-python.gnu.org with spam-scanned (Exim 4.30) id 1BJTPb-0003fK-EH for emacs-devel@gnu.org; Fri, 30 Apr 2004 04:30:54 -0400 Original-Received: from [212.88.64.25] (helo=mail-relay.sonofon.dk) by monty-python.gnu.org with smtp (Exim 4.30) id 1BJTBS-0000QF-AZ for emacs-devel@gnu.org; Fri, 30 Apr 2004 04:15:46 -0400 Original-Received: (qmail 69599 invoked from network); 30 Apr 2004 08:09:03 -0000 Original-Received: from unknown (HELO kfs-l.imdomain.dk.cua.dk) (213.83.150.2) by 0 with SMTP; 30 Apr 2004 08:09:03 -0000 Original-To: Juanma Barranquero In-Reply-To: <20040430014041.F09B.LEKTU@mi.madritel.es> Original-Lines: 31 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3.50 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:22414 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:22414 Juanma Barranquero writes: > On 19 Apr 2004 13:50:58 +0200, storm@cua.dk (Kim F. Storm) wrote: > > > Here is another idea, enhancing on Richard's idea: > > > > Show the full doc string, but highlight occurrences of the upper case > > PARAM name in the doc string -- then the user will be able to quickly > > locate the relevant information and focus on that... > > Related to that, here's a (proof-of-concept) patch that sets the face > `font-lock-variable-name-face' for all uses of the arguments of a > function in a `describe-function' *Help* buffer. > > I say proof-of-concept because I've not provided a way to make it > optional, I've hard-coded the face used, etc. Still, it works > beautifully. > > The auxiliary function help-highlight-arguments is designed in such a > way that it can be pased a nil WORDS argument (and then it highlights > all arguments of the function), or a list of desired arguments to > highlight, so it can be of help if highlighting info for an argument is > desired (which was discused in this thread). > > Opinions? I have applied your patch locally; I'll use it for a while before I'll make a judgement. But initially, I like it. -- Kim F. Storm http://www.cua.dk