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: Lowercase text after full stop on describe-variable Date: Thu, 27 Jun 2002 18:27:14 +0200 Sender: emacs-devel-admin@gnu.org Message-ID: <20020627174057.35D7.LEKTU@terra.es> References: <20020627085430.35CF.LEKTU@terra.es> <200206271424.g5REO1p16162@rum.cs.yale.edu> NNTP-Posting-Host: localhost.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: 7bit X-Trace: main.gmane.org 1025195486 24339 127.0.0.1 (27 Jun 2002 16:31:26 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Thu, 27 Jun 2002 16:31:26 +0000 (UTC) Cc: rms@gnu.org, emacs-devel@gnu.org Return-path: Original-Received: from quimby.gnus.org ([80.91.224.244]) by main.gmane.org with esmtp (Exim 3.33 #1 (Debian)) id 17NcB4-0006KS-00 for ; Thu, 27 Jun 2002 18:31:26 +0200 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 17NcDk-0003yC-00 for ; Thu, 27 Jun 2002 18:34:12 +0200 Original-Received: from localhost ([127.0.0.1] helo=fencepost.gnu.org) by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian)) id 17NcAO-0006h2-00; Thu, 27 Jun 2002 12:30:44 -0400 Original-Received: from [62.22.27.141] (helo=mail.peoplecall.com) by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian)) id 17Nc7H-0006IG-00; Thu, 27 Jun 2002 12:27:31 -0400 Original-Received: from [62.22.27.143] (jbarranquero.ofi.peoplecall.com [62.22.27.143]) by mail.peoplecall.com (8.11.6/8.11.6) with ESMTP id g5RGR8a29621; Thu, 27 Jun 2002 18:27:14 +0200 Original-To: "Stefan Monnier" In-Reply-To: <200206271424.g5REO1p16162@rum.cs.yale.edu> X-Mailer: Becky! ver. 2.05 Errors-To: emacs-devel-admin@gnu.org X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.0.11 Precedence: bulk List-Help: List-Post: List-Subscribe: , List-Id: Emacs development discussions. List-Unsubscribe: , List-Archive: Xref: main.gmane.org gmane.emacs.devel:5234 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:5234 On Thu, 27 Jun 2002 10:24:01 -0400, "Stefan Monnier" wrote: > Why not change the describe-* functions to also use a semi-colon ? Because I'm deeply idiot, that's why. :( I've followed your suggestion, which really simplifies things. I've had to normalize a few obsolescence declarations, and in two or three cases I've taken the liberty of removing redundant obsolescence info from docstrings when the same or equivalent info is already in the `make-obsolete*' declaration; now that the info is also shown it makes no sense to say the same thing twice in a row. Anyway, I'd be grateful if a native English- or Emacs- speaker checks the changes I've done :) I haven't touched the docstring of `font-lock-defaults-alist' because I find it confusing: > font-lock-defaults-alist's value is shown below. > > Documentation: > This variable is obsolete; > use `font-lock-defaults' instead. > Alist of fall-back Font Lock defaults for major modes. > > This variable should not be used any more. > Set the buffer-local `font-lock-keywords' in the major mode instead. > [...] The `make-obsolete-variable' declaration says to use `font-lock-defaults', and the docstring says to use `font-lock-keywords'. Perhaps the docstring should be reworked somehow (and the bit about "should not be used anymore" removed, I suppose). Only vaguely related: with the recent font-lock hoopla `Info-fontify' has been deleted. Wouldn't have been more logical to `make-obsolete-variable' it? /L/e/k/t/u