diff options
| author | Stefan Monnier <monnier@iro.umontreal.ca> | 2020-12-20 23:13:31 -0500 |
|---|---|---|
| committer | Stefan Monnier <monnier@iro.umontreal.ca> | 2020-12-20 23:32:21 -0500 |
| commit | 2990c6647ffe1c188b84ade4da0314d2d9430437 (patch) | |
| tree | 184930dc53582e229c4ed8297d5c9e3dbe0a2346 | |
| parent | 89714d891aef0e58212cbafd45e2eaada07c95a3 (diff) | |
Improve the `Commentary:`externals/advice-patch
| -rw-r--r-- | advice-patch.el | 13 |
1 files changed, 12 insertions, 1 deletions
diff --git a/advice-patch.el b/advice-patch.el index df0e2f5..cfc7265 100644 --- a/advice-patch.el +++ b/advice-patch.el @@ -1,6 +1,6 @@ ;;; advice-patch.el --- Use patches to advise the inside of functions -*- lexical-binding: t; -*- -;; Copyright (C) 2019 Free Software Foundation, Inc. +;; Copyright (C) 2019-2020 Free Software Foundation, Inc. ;; Author: Stefan Monnier <monnier@iro.umontreal.ca> ;; Package-requires: ((emacs "24.4")) @@ -34,6 +34,17 @@ ;; Beware: this can eat your lunch and can misbehave unexpectedly in many ;; legitimate cases. +;; Use it is as follows: +;; +;; (advice-patch 'foo (my new code) +;; [(some old code) +;; (some (other version) (of the old) code))]) +;; +;; This will fetch the source code of `foo', look for an occurrence +;; of one of the old code chunks listed, replace it with +;; `(my new code)', compile the result, and finally ask `advice-add' to use it +;; to override the original definition. + ;;;; TODO: ;; - Lots of cases to fix and features to add. See FIXMEs in the code. |