From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: "Juanma Barranquero" Newsgroups: gmane.emacs.devel Subject: Re: function arguments downcased in help buffers Date: Tue, 15 Apr 2008 16:48:45 +0200 Message-ID: References: <200804150020.m3F0KBMo012038@sallyv1.ics.uci.edu> <200804150504.m3F53xoY007750@sallyv1.ics.uci.edu> <003901c89f03$472dc7c0$0200a8c0@us.oracle.com> NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Trace: ger.gmane.org 1208272681 4653 80.91.229.12 (15 Apr 2008 15:18:01 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Tue, 15 Apr 2008 15:18:01 +0000 (UTC) Cc: Glenn Morris , Dan Nicolaescu , emacs-devel@gnu.org To: "Drew Adams" Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Apr 15 17:18:34 2008 connect(): Connection refused Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1JlmTX-0007z0-Cs for ged-emacs-devel@m.gmane.org; Tue, 15 Apr 2008 16:49:35 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JlmSs-0007wY-Rg for ged-emacs-devel@m.gmane.org; Tue, 15 Apr 2008 10:48:54 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1JlmSo-0007wJ-Bc for emacs-devel@gnu.org; Tue, 15 Apr 2008 10:48:50 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1JlmSn-0007w3-Ow for emacs-devel@gnu.org; Tue, 15 Apr 2008 10:48:49 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1JlmSn-0007vy-Id for emacs-devel@gnu.org; Tue, 15 Apr 2008 10:48:49 -0400 Original-Received: from wa-out-1112.google.com ([209.85.146.177]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1JlmSm-0006Qd-GW for emacs-devel@gnu.org; Tue, 15 Apr 2008 10:48:48 -0400 Original-Received: by wa-out-1112.google.com with SMTP id k34so2881975wah.10 for ; Tue, 15 Apr 2008 07:48:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:received:received:message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; bh=tAP/gdBbJZeMK1YpclslCDw7xw0yiqLsnjfAQVXn0Is=; b=CimCyWrOwhqSLlkyMU94DYNgf/P3lKJEpT6VYtNt2kdNNf1WXGuwX9yL5xhxzJNfOaKF3hAK2lxMWlgJh9AabB/iBpAPP9HKt32O5p9vv6OwezuamJ47ArDiVS0p5KSmcrCv9OhdiI5Wf7eh5fmZmDYU2pM2Q6NVi4kJxRB4Z8I= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=message-id:date:from:to:subject:cc:in-reply-to:mime-version:content-type:content-transfer-encoding:content-disposition:references; b=FVo+v7DLV88ZY5j+lAPzRn9x5q8y4//S1CGmY1LqdTx07BXiH24bT2rP1XwajBkPbRQ0SXk+zzEM5JFqWEdVor9/apKggAurVpqAvIXHqdV7wL6bKN9WwY1rMjg6sMgXFtuJP32Bdfox5ummuSKFt3DppEzbmZOFgTfssY5lLZA= Original-Received: by 10.114.181.6 with SMTP id d6mr8305117waf.50.1208270925069; Tue, 15 Apr 2008 07:48:45 -0700 (PDT) Original-Received: by 10.114.166.20 with HTTP; Tue, 15 Apr 2008 07:48:45 -0700 (PDT) In-Reply-To: <003901c89f03$472dc7c0$0200a8c0@us.oracle.com> Content-Disposition: inline X-detected-kernel: by monty-python.gnu.org: Linux 2.6 (newer, 2) 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: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:95267 Archived-At: On Tue, Apr 15, 2008 at 4:16 PM, Drew Adams wrote: > Rereading the 2004 archive thread "new *Help* argument highlighting" wasn't too > reassuring. It didn't seem that there was such a complete consensus as you > suggest I didn't say "complete consensus". That does not exist in emacs-devel. But if you've read the thread, most of the initial complains were (as usual) about the choice of face and whether it was too intrusive, or too little ;-) Once someone (not me, I think it was Richard) suggested italics and lowercase (to follow the printed docs) there was pretty much no more complains until now. In fact, there was considerable discussion (and some agreement, I'd say) about ways to *add* more markup to the docstrings, like using @v{VAR} to unequivocally distinguish variable referencies. > Your answer to Stefan's opinion was that then was not the time to question this > feature, presumably since it was late in the 22 release cycle (!), and that it > could always be revisited later: That's a nice selective reading. Stefan is saying that the simple feature I implemented is working, and that he thinks we're wasting time discussing *additional* features, like @var{VAR}. And in my answer, as your quote shows, I agreed with him about that. > FWIW, I don't mind the feature. I do think it's good to have a face for this, so > that users can customize the behavior. But I think the default of italic doesn't > stand out enough, at least in emacs -Q on Windows. IMO, bold italic is better, > and italic uppercase (bold or non-bold) is even better. I don't mind the default, just the feature. But the current default was not chosen by accident. Some people didn't like uppercase italics (I think they're horrible, FWIW), some people liked to get rid of uppercase altogether, etc. I think you're reopening one of *those* discussions, but don't let me stop you from doing it :) > BTW, using Customize to change the face, and then setting it for the current > session, changes the text in an existing *Help* buffer immediately (good), > _except_ when you change to the default face by removing all checkmarks in > Customize. In that case, you need to use the help command again (e.g. C-h f) in > order to get the uppercase. No big deal, but a slight inconsistency. I try to stay as far away from customize as possible, so, no idea. Juanma