Wilfred / helpful

A better Emacs *help* buffer
1.1k stars 62 forks source link

Add interactivity to the Advice section #297

Open kisaragi-hiu opened 2 years ago

kisaragi-hiu commented 2 years ago

This lists every new style advice (nadvice.el) of a callable in the Advice section instead of simply saying that it is advised. Further, a button is provided for each advice to remove it.

Another button is provided to remove all advices from the callable. This also removes old style advices.

Mentions of all advices in the docstring (the "This function has :around advice:" line) are removed, regardless of whether they come before the docstring or after (Emacs 28 change), or whether they come from advice.el or nadvice.el.


This is similar in spirit to #265. The differences are:

20220530T091713+0900 20220530T091833+0900

Alexander-Shukaev commented 2 years ago

Been looking forward to functionality of interactive advice toggling for quite a while. To sweet not to merge!

seagle0128 commented 2 years ago

Great! It would be better if it supports hooks as well 😁

CeleritasCelery commented 1 week ago

@kisaragi-hiu I tried this patch on Emacs 29, and it failed because advice--where has been replaced by advice--how. advice--where is still around as a deprecated function, but advice--where-alist is gone. I guess that is the risk of relying on internal APIs.