From 37592835c4315b34a58017df331a8a2c6c3edcac Mon Sep 17 00:00:00 2001 From: Cayetano Santos Date: Fri, 8 May 2026 20:19:34 +0200 Subject: =?UTF-8?q?doc:=20Add=20agitjo=20under=20the=20=E2=80=99perfect=20?= =?UTF-8?q?setup=E2=80=99=20section.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit This is a complement to the AGit workflow included in "Submitting Patches". * doc/guix.texi: Mention ‘emacs-agitjo’ in the ’Emacs’ subsection. Merges guix/guix!8445 Change-Id: Ia49a0da71e8b08e252ff4dd996c414173920ecac --- doc/contributing.texi | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) (limited to 'doc') diff --git a/doc/contributing.texi b/doc/contributing.texi index 7c5cb4a6dba..1ac88339979 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -618,6 +618,33 @@ enhance @code{scheme-mode} and Geiser. @xref{Introduction,,, emacs-guix, Emacs-Guix Reference Manual}, to make sure you don't miss out! +@unnumberedsubsubsec Submitting Pull Requests Following the AGit Workflow + +@cindex AGit workflow, for pull requests (Emacs). +@url{https://codeberg.org/halvin/agitjo, Agitjo} is a helper to ease +AGit workflow based patch submission (@pxref{Submitting Patches}). +Install it with: + +@example +guix install emacs-agitjo +@end example + +Assuming your local checkout is on the branch containing the changes you +would like to submit for inclusion in the @code{master} branch, use +@command{M-x agitjo-push} then: + +@itemize +@item +Set options like the title @option{-t} and the session identifier +@option{-s}. +@item +Invoke one of the push commands to execute a @command{git push} operation. +@end itemize + +When creating a new pull request, a dedicated buffer will open for +drafting a description. The force-push option @option{-f} is enabled to +push changes to the existing pull request. + @unnumberedsubsubsec Taming Boilerplate with Templates @cindex code snippets -- cgit v1.2.3