[elpa] externals/agitate 757d1cfd88 1/7: Mention vc-prepare-patch command

[ELPA Syncer]

branch: externals/agitate
commit 757d1cfd88aeade42bb47371f42e5ea4ef95b14f
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>

    Mention vc-prepare-patch command
    
    I think that should be the standard going forward, though those other
    commands can still occupy their own niche.
---
 README.org | 7 ++++---
 agitate.el | 8 ++++++--
 2 files changed, 10 insertions(+), 5 deletions(-)

diff --git a/README.org b/README.org
index deb49eb8b7..7bc30b5f45 100644
--- a/README.org
+++ b/README.org
@@ -202,8 +202,8 @@ displays the log-edit buffer.
   commit at point, prompt for =COMMIT= using minibuffer completion.
   Output the patch file to the return value of the function
   ~vc-root-dir~.  The number of revisions in the log is controlled by
-  the user option ~agitate-log-limit~.  Relevant except from the
-  source code:
+  the user option ~agitate-log-limit~.  For Emacs 29, consider using
+  ~vc-prepare-patch~.  Relevant except from the source code:
 
   #+begin_src emacs-lisp
   ;; TODO 2022-09-27: Handle the output directory better.  Though I am
@@ -215,7 +215,8 @@ displays the log-edit buffer.
 #+findex: agitate-vc-git-format-patch-n-from-head
 + Function ~agitate-vc-git-format-patch-n-from-head~ :: Format patches
   covering =NUMBER= of commits from current HEAD.  This is the
-  eqvuivalent of: =git format-patch -NUMBER=.
+  eqvuivalent of: =git format-patch -NUMBER=.  For Emacs 29, consider
+  using ~vc-prepare-patch~.
 
 #+findex: agitate-vc-git-grep
 + Function ~agitate-vc-git-grep~ :: Run =git-grep(1)= for =REGEXP= in
diff --git a/agitate.el b/agitate.el
index c5fea87362..bfada924df 100644
--- a/agitate.el
+++ b/agitate.el
@@ -490,7 +490,9 @@ Output the patch file to the return value of the function
 `vc-root-dir'.
 
 The number of revisions in the log is controlled by the user
-option `agitate-log-limit'."
+option `agitate-log-limit'.
+
+For Emacs 29, consider using `vc-prepare-patch'."
   (interactive (list (agitate--vc-git-format-patch-single-commit)))
   ;; TODO 2022-09-27: Handle the output directory better.  Though I am
   ;; not sure how people work with those.  I normally use the root of
@@ -503,7 +505,9 @@ option `agitate-log-limit'."
 ;;;###autoload
 (defun agitate-vc-git-format-patch-n-from-head (number)
   "Format patches covering NUMBER of commits from current HEAD.
-This is the eqvuivalent of: git format-patch -NUMBER."
+This is the eqvuivalent of: git format-patch -NUMBER.
+
+For Emacs 29, consider using `vc-prepare-patch'."
   (interactive (list (read-number "git format-patch -NUMBER: ")))
   (if (natnump number)
       (vc-git--call nil "format-patch" (format "-%d" number))