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 10:54:56 +0200 Sender: emacs-devel-admin@gnu.org Message-ID: <20020627085430.35CF.LEKTU@terra.es> References: <20020624182600.F148.LEKTU@terra.es> <200206251107.g5PB75a27123@aztec.santafe.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 1025168222 31527 127.0.0.1 (27 Jun 2002 08:57:02 GMT) X-Complaints-To: usenet@main.gmane.org NNTP-Posting-Date: Thu, 27 Jun 2002 08:57:02 +0000 (UTC) Cc: monnier+gnu/emacs@rum.cs.yale.edu, 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 17NV5K-0008CO-00 for ; Thu, 27 Jun 2002 10:57:02 +0200 Original-Received: from fencepost.gnu.org ([199.232.76.164]) by quimby.gnus.org with esmtp (Exim 3.12 #1 (Debian)) id 17NV7q-00021n-00 for ; Thu, 27 Jun 2002 10:59:39 +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 17NV5U-0000T3-00; Thu, 27 Jun 2002 04:57:12 -0400 Original-Received: from [62.22.27.141] (helo=mail.peoplecall.com) by fencepost.gnu.org with esmtp (Exim 3.34 #1 (Debian)) id 17NV3K-0000Iz-00; Thu, 27 Jun 2002 04:54:58 -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 g5R8soY17615; Thu, 27 Jun 2002 10:54:50 +0200 Original-To: rms@gnu.org In-Reply-To: <200206251107.g5PB75a27123@aztec.santafe.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:5230 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:5230 I've commited the patch to `describe-function' (`describe-function-1', really) to show obsolescence information like `describe-variable' does now. Still, any kind of decision is needed about the issue of formatting of the documentation. Currently there's a mismatch between the describe-* functions and `byte-compile-obsolete'. The three of them write an obsolete message and then the NEW info (NEW as in the argument to `make-obsolete' and `make-obsolete-variable', I mean). But the describe-* functions do it after a full stop, while `byte-compile-obsolete' does it after a semicolon. Example output from `describe-variable': > post-command-idle-delay's value is 100000 > > Documentation: > This variable is obsolete since before 19.34. > use timers instead, with `run-with-idle-timer'. > Delay time before running `post-command-idle-hook'. > This is measured in microseconds. Example output from `byte-compile-obsolete': > c:/usr/wrk/pru.el: In toplevel form > c:/usr/wrk/pru.el:1:7: warning: post-command-idle-delay is an obsolete variable since before 19.34; use timers instead, with `run-with-idle-timer'. I think the best answer would be to put all obsolete info non-capitalized and then make the describe-* functions capitalize it on the fly. Opinions? /L/e/k/t/u