[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/el-search 817c902 123/332: Document change-revision tra
From: |
Stefan Monnier |
Subject: |
[elpa] externals/el-search 817c902 123/332: Document change-revision transformer function; make a defcustom |
Date: |
Tue, 1 Dec 2020 15:48:26 -0500 (EST) |
branch: externals/el-search
commit 817c90291bafa59a1d565467d260211c40c3c99c
Author: Michael Heerdegen <michael_heerdegen@web.de>
Commit: Michael Heerdegen <michael_heerdegen@web.de>
Document change-revision transformer function; make a defcustom
---
el-search-x.el | 20 ++++++++++++++++----
1 file changed, 16 insertions(+), 4 deletions(-)
diff --git a/el-search-x.el b/el-search-x.el
index 96baeee..d41261d 100644
--- a/el-search-x.el
+++ b/el-search-x.el
@@ -156,7 +156,15 @@ could use this pattern:
(defvar-local el-search--cached-changes nil)
-(defvar el-search-change-revision-transformer-function #'identity)
+(defcustom el-search-change-revision-transformer-function nil
+ "Transformer function for the REVISION argument of `change' and `changed'.
+
+When specified, this function is called on the REVISION argument
+of `change' and `changed' before passing it to git. The default
+value is nil."
+ :group 'el-search
+ :type '(choice (const :tag "No transformer" nil)
+ (function :tag "User specified function")))
(defun el-search--changes-from-diff-hl (revision)
"Return a list of changed regions (as conses of positions) since REVISION.
@@ -174,7 +182,7 @@ Use variable `el-search--cached-changes' for caching."
(widen)
(save-excursion
(let ((diff-hl-reference-revision
- (funcall el-search-change-revision-transformer-function
revision))
+ (funcall (or el-search-change-revision-transformer-function
#'identity) revision))
(current-line-nbr 1) change-beg)
(goto-char 1)
(cdr (setq el-search--cached-changes
@@ -224,14 +232,18 @@ Use variable `el-search--cached-changes' for caching."
"Matches the object if its text is part of a file change.
Requires library \"diff-hl\". REVISION defaults to the file's
-repository's HEAD commit."
+repository's HEAD commit and is a git revision string. Customize
+`el-search-change-revision-transformer-function' to modify how
+REVISION is interpreted."
`(guard (el-search--change-p (point) ,(or revision "HEAD"))))
(el-search-defpattern changed (&optional revision)
"Matches the object if its text contains a file change.
Requires library \"diff-hl\". REVISION defaults to the file's
-repository's HEAD commit."
+repository's HEAD commit and is a git revision string. Customize
+`el-search-change-revision-transformer-function' to modify how
+REVISION is interpreted."
`(guard (el-search--changed-p (point) ,(or revision "HEAD"))))
- [elpa] externals/el-search 24d0638 099/332: Rewrite the `change' and `changed' patterns, (continued)
- [elpa] externals/el-search 24d0638 099/332: Rewrite the `change' and `changed' patterns, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search da31900 146/332: Update some copyrights, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 94b79e5 149/332: Add new pattern type `de-morgan', Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 3b73e0e 154/332: Extend heuristic matching to top-level sexps, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 0cff5d2 153/332: Recompile search pattern when resuming searches, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 51a539a 158/332: Implement multi-buffer query-replace, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 56d9f20 165/332: Add some useful commands for *El Occur* buffers, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 40217c0 174/332: Fix replacing matches with nil, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 1bfe7c0 110/332: Simplify `el-search--transform-nontrivial-lpat', Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 6ff7aa4 116/332: Work around Emacs bug#24542, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 817c902 123/332: Document change-revision transformer function; make a defcustom,
Stefan Monnier <=
- [elpa] externals/el-search 2d6aad6 132/332: Explicitly `error' when trying to jump to invalid search head, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 8875d2a 137/332: Avoid infinite recursion in circular programs, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search f02e86f 142/332: New command `el-search-from-beginning', Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 4b6a363 138/332: Improve handling of reader errors in el-search-atom-list, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 806bfc4 157/332: Add new command `el-search-this-sexp', Stefan Monnier, 2020/12/01
- [elpa] externals/el-search c66d1da 160/332: Make the el-search-object struct contain an alist of properties, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 4a6c3e2 162/332: Some details, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search d412688 199/332: Update copyrights of some packages, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search cf465e0 203/332: * el-search/el-search.el: Add two more autoload cookies, Stefan Monnier, 2020/12/01
- [elpa] externals/el-search 42c776a 207/332: * el-search/el-search.el: Tweak el-search-jump-to-search-head, Stefan Monnier, 2020/12/01