From f697fc267c317e98e4bba8009452b9d64e76b30a Mon Sep 17 00:00:00 2001 From: Leo Famulari Date: Thu, 2 Dec 2021 14:27:14 -0500 Subject: [PATCH] doc: Give more details about generating patches with base commit information. * doc/contributing.texi (Submitting Patches): Talk more about '--base'. --- doc/contributing.texi | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/doc/contributing.texi b/doc/contributing.texi index aa6bfc2e65..db1c4c6921 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -1017,8 +1017,11 @@ please run through this check list: @cindex @code{git format-patch} @cindex @code{git-format-patch} @item -We recommend to use the command @code{git format-patch --base} to -include the commit where your patch applies. +When generating your patches with @code{git format-patch} or @code{git +send-email}, we recommend using the option @code{--base=}, perhaps with +the value @code{auto}. This option adds a note to the patch stating +which commit the patch is based on. This helps reviewers understand how +to apply and review your patches. @item If the authors of the packaged software provide a cryptographic