--- Begin Message ---
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 address@hidden
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'
--- End Message ---
--- Begin Message ---
Subject: |
Re: bug#16491: 24.3.50; ?REGRESSION: `defadvice' doc removed from Elisp manual |
Date: |
Sun, 19 Jan 2014 15:40:53 -0500 |
User-agent: |
Gnus/5.13 (Gnus v5.13) Emacs/24.3.50 (gnu/linux) |
>> 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
--- End Message ---