GNU bug report logs - #16491
24.3.50; REGRESSION: `defadvice' doc removed from Elisp manual

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Stefan Monnier <monnier <at> iro.umontreal.ca>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#16491: closed (24.3.50; REGRESSION: `defadvice' doc removed
 from Elisp manual)
Date: Sun, 19 Jan 2014 20:41:03 +0000

[Message part 1 (text/plain, inline)]

Your message dated Sun, 19 Jan 2014 15:40:53 -0500
with message-id <jwvha8zd7wg.fsf-monnier+emacsbugs <at> gnu.org>
and subject line Re: bug#16491: 24.3.50; ?REGRESSION: `defadvice' doc removed from Elisp manual
has caused the debbugs.gnu.org bug report #16491,
regarding 24.3.50; REGRESSION: `defadvice' doc removed from Elisp manual
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
16491: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=16491
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 24.3.50; REGRESSION: `defadvice' doc removed from Elisp manual
Date: Sat, 18 Jan 2014 22:45:09 -0800 (PST)

Elisp manual node `Advising Emacs Lisp Functions' has been rewritten to
include the new `add-function' stuff.  It is fine to document that new
feature.

What's not fine is to simply remove all of the doc about the traditional
`defadvice' advice system.  Even if that feature is to be deprecated,
its doc should remain until it is desupported.  If this removal is not
a temporary oversight (mistake) then it is quite misguided.  It hurts
Emacs users.

The Elisp manual should continue to be usable to help users code
`defadvice' advice, in addition to `add-function' advice.  As one use
case, some users will use Emacs 24.4 to write or maintain code for
older or multiple Emacs versions.

Normally there is a reasonably long transition period before a feature,
especially a major feature such as `defadvice', is desupported.  And
until desupport, the deprecated feature remains SUPPORTED - in
particular, by continuing to provide users with its reference doc.


In GNU Emacs 24.3.50.1 (i686-pc-mingw32)
 of 2014-01-17 on ODIEONE
Bzr revision: 116059 michael.albinus <at> gmx.de-20140117182409-gz695p2c951idlee
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --prefix=/c/Devel/emacs/binary --enable-checking=yes,glyphs
 'CFLAGS=-O0 -g3' LDFLAGS=-Lc:/Devel/emacs/lib
 CPPFLAGS=-Ic:/Devel/emacs/include'

[Message part 3 (message/rfc822, inline)]

From: Stefan Monnier <monnier <at> iro.umontreal.ca>
To: Alan Mackenzie <acm <at> muc.de>
Cc: 16491-done <at> debbugs.gnu.org
Subject: Re: bug#16491: 24.3.50;
 ?REGRESSION: `defadvice' doc removed from Elisp manual
Date: Sun, 19 Jan 2014 15:40:53 -0500

>> What's not fine is to simply remove all of the doc about the traditional
>> `defadvice' advice system.

Totally agreed.  Which is why I kept the 60KB of docs in the
Commentary section of advice.el.


        Stefan

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.