~ruther/guix-local

7b46b8db9afac3825518dca10b5ff0eab04f5f08 — Ekaitz Zarraga 2 years ago 595fb0a
doc: Explain `git format-patch` revision format

* doc/contributing.texi(Sending a Patch Series): Add a note about
`git format-patch` revision format and link to git documentation.

Change-Id: Ie08f85dc19e3804165fb184664b74e85a804d7c4
1 files changed, 12 insertions(+), 0 deletions(-)

M doc/contributing.texi
M doc/contributing.texi => doc/contributing.texi +12 -0
@@ 2194,6 2194,18 @@ $ git format-patch -@var{NUMBER_COMMITS} -o outgoing \
      --cover-letter --base=auto
@end example

@quotation Note
@code{git format-patch} accepts a wide range of
@uref{https://git-scm.com/docs/gitrevisions, revision range} specifiers.
For example, if you are working in a branch, you could select all commits
in your branch starting at @code{master}.

@example
$ git format-patch master..@var{MY_BRANCH} -o outgoing \
      --cover-letter --base=auto
@end example
@end quotation

We can now send @emph{just} the cover letter to the
@email{guix-patches@@gnu.org} address, which will create an issue
that we can send the rest of the patches to.