From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Nick Roberts Newsgroups: gmane.emacs.devel Subject: Re: Incompatible change without "warning" Date: Tue, 26 Apr 2005 21:15:52 +1200 Message-ID: <17006.1736.406738.121947@farnswood.snap.net.nz> References: <16997.28602.876638.54728@farnswood.snap.net.nz> <16998.58339.710430.454702@farnswood.snap.net.nz> <17000.13278.865098.49756@farnswood.snap.net.nz> NNTP-Posting-Host: main.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Trace: sea.gmane.org 1114507086 3379 80.91.229.2 (26 Apr 2005 09:18:06 GMT) X-Complaints-To: usenet@sea.gmane.org NNTP-Posting-Date: Tue, 26 Apr 2005 09:18:06 +0000 (UTC) Cc: monnier@iro.umontreal.ca, emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Tue Apr 26 11:18:01 2005 Return-path: Original-Received: from lists.gnu.org ([199.232.76.165]) by ciao.gmane.org with esmtp (Exim 4.43) id 1DQMC4-0006u9-Ii for ged-emacs-devel@m.gmane.org; Tue, 26 Apr 2005 11:17:24 +0200 Original-Received: from localhost ([127.0.0.1] helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DQMHl-0000TU-LF for ged-emacs-devel@m.gmane.org; Tue, 26 Apr 2005 05:23:17 -0400 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1DQMEF-000721-4O for emacs-devel@gnu.org; Tue, 26 Apr 2005 05:19:39 -0400 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1DQME9-0006zL-VG for emacs-devel@gnu.org; Tue, 26 Apr 2005 05:19:35 -0400 Original-Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1DQME9-0006sq-AO for emacs-devel@gnu.org; Tue, 26 Apr 2005 05:19:33 -0400 Original-Received: from [202.37.101.8] (helo=viper.snap.net.nz) by monty-python.gnu.org with esmtp (Exim 4.34) id 1DQMDb-0001lx-HV; Tue, 26 Apr 2005 05:18:59 -0400 Original-Received: from farnswood.snap.net.nz (p203-tnt2.snap.net.nz [202.124.108.203]) by viper.snap.net.nz (Postfix) with ESMTP id 5E5D64AF3B0; Tue, 26 Apr 2005 21:15:04 +1200 (NZST) Original-Received: by farnswood.snap.net.nz (Postfix, from userid 501) id 2949762A99; Tue, 26 Apr 2005 10:15:53 +0100 (BST) Original-To: rms@gnu.org In-Reply-To: X-Mailer: VM 7.19 under Emacs 22.0.50.21 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:36398 X-Report-Spam: http://spam.gmane.org/gmane.emacs.devel:36398 > I see XEmacs has > define-obsolete-function-alias so we could do: > > Compatibility adds an additional reason. > So please add define-obsolete-function-alias. > Please give it arguments compatible with XEmacs. I have added define-obsolete-function-alias to byte-run.el I have not provided documentation because I would like guidance: Me> These two functions are so similar to the two that I've just documented, Me> externally at least, that I wonder if they could be described somewhere Me> centrally in the Lisp manual i.e a link from the nodes 'Defining Me> Variables' and 'Defining Functions'to one called 'Obsoletion'. The current documentation for these related functions uses different argument names which I think is confusing: Manual: - Function: defvaralias alias-var base-var &optional docstring Documentation string: (defvaralias symbol aliased &optional docstring) Shall I change these to Manual: - Function: defvaralias variable new &optional docstring Documentation string: (defvaralias variable new &optional docstring) for consistency with make-obsolete-variable, define-obsolete-variable-alias? The manual says: `string-to-int' is an obsolete alias for this function. (string-to-number) but string-to-int has not been made obsolete. Some variables/functions have been obsolete since 19.15. Is now a good time to purge them? Nick