From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id yMPqENOn3WbQJQAAqHPOHw:P1 (envelope-from ) for ; Sun, 08 Sep 2024 13:34:11 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id yMPqENOn3WbQJQAAqHPOHw (envelope-from ) for ; Sun, 08 Sep 2024 15:34:11 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=U8fUVE56; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20230601 header.b=CLdep2Fz; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1725802451; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:resent-cc:resent-from:resent-sender: resent-message-id:in-reply-to:in-reply-to:references:references: list-id:list-help:list-unsubscribe:list-subscribe:list-post: dkim-signature; bh=5JMrXiC85fulzy5IZQQwWkzPqp1RCVYUc9O15eBsnqg=; b=ejk8nAd89b+spn67j6WKPc6rthbKpKWc9sWWvcKxX/YCKLw/FgRlXt9E4PrUdPWNXIc80r H+ZQdyBAh+tR0X4LQAsrtjRyn83UEV2Gy1+Q7pPWsOaGyq6J7bFhyT8YX5ynFn9K0W/jkN 7WLyT3HGcp7x1HtI2eM4EpTb35AWr1jNJ0IHld9rSpQvNw5BL2d+/HCHapqwTRy2qzQdui 5LGjXPFlZ15giZjtVxodYRPB37GYqMw+W8K3uH++a7GAOg4Pk1lcsEpaHJ0KM8SS7L41xz uNI2wBCGRRxET2nDrm+F4FdlPPOe/xSMARfKTOniXmRqc1+90FPejQwx8Bc0sg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=U8fUVE56; dkim=fail ("headers rsa verify failed") header.d=gmail.com header.s=20230601 header.b=CLdep2Fz; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org"; dmarc=fail reason="SPF not aligned (relaxed), DKIM not aligned (relaxed)" header.from=gmail.com (policy=none) ARC-Seal: i=1; s=key1; d=yhetil.org; t=1725802451; a=rsa-sha256; cv=none; b=i/oAJlIrUr7ygl5jVa858i5QhymZH+KNBUIsVykdYMa4bDwf1ylh6MTZjCP8oSZIT0Rb4B 9jINz7IKkdAU5FgpraP21Hi029R0hFZvoyjP10fkU3bOIzYWO//5ya72B/+KSd9L+X+4va 7YFsARUyUFI+IsBeBWLThJnmnavdtmh/8+Bskni0HNniiZpItxRW3n5ujGS7fNh0/QwSVw 2b8qzjqYxLrcNhUp9w4Ke0ANMHtp8JfyBAERElOoGbmJJnCAmABL1rBZDtqrxk+RTY+Y5Z q/rWqkdEVVhhKPxgsYbXFPsRTtEVRRRpp/hToONbhIOqaDAiWGVdhM1waQCFew== Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id 066FE115BA for ; Sun, 08 Sep 2024 15:34:11 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1snI3H-0004MS-69; Sun, 08 Sep 2024 09:34:03 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1snI3F-0004MK-1e for guix-patches@gnu.org; Sun, 08 Sep 2024 09:34:01 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1snI3E-0002TV-Nf for guix-patches@gnu.org; Sun, 08 Sep 2024 09:34:00 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=5JMrXiC85fulzy5IZQQwWkzPqp1RCVYUc9O15eBsnqg=; b=U8fUVE56r01sP2DFAesaBRLGq0xhneAWWnOpHNr2LyamRubJ1PxKGLKnj8mRsxNaT749zjWUfs73yCTwAPFtQ68FmQAXSVysUjjigablyvGFAlsCA9erYtru2f9Le1fyOlBYG+87vOjg8sNAC8+9y54h0NWb6yh4Z4BPvMbTiIS9lYoMpyYbt4MIxIQK3IJHkgsvSr7g3RhwZQ0iLZzacVErBs4ZVVCxOVu1+Nsy520U+lsmLKOyYH2h5nZ9Eqkvwg32rPMd70Pv4uoIGhMC8sSN4y7gVod3eV1ggRrQMQgPnEmK8BNFQ5nAbB5CQJhZGsga7pGPgsaCEDFsRMjwbQ==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1snI3G-0004yo-G2 for guix-patches@gnu.org; Sun, 08 Sep 2024 09:34:02 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#73055] [PATCH] doc: Explain `git format-patch` revision format Resent-From: Maxim Cournoyer Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Sun, 08 Sep 2024 13:34:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 73055 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ekaitz Zarraga Cc: Ludovic =?UTF-8?Q?Court=C3=A8s?= , 73055@debbugs.gnu.org, Florian Pelz Received: via spool by 73055-submit@debbugs.gnu.org id=B73055.172580239119073 (code B ref 73055); Sun, 08 Sep 2024 13:34:02 +0000 Received: (at 73055) by debbugs.gnu.org; 8 Sep 2024 13:33:11 +0000 Received: from localhost ([127.0.0.1]:58178 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1snI2R-0004xZ-86 for submit@debbugs.gnu.org; Sun, 08 Sep 2024 09:33:11 -0400 Received: from mail-pl1-f176.google.com ([209.85.214.176]:57724) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1snI2O-0004xK-2P for 73055@debbugs.gnu.org; Sun, 08 Sep 2024 09:33:08 -0400 Received: by mail-pl1-f176.google.com with SMTP id d9443c01a7336-206f9b872b2so14113135ad.3 for <73055@debbugs.gnu.org>; Sun, 08 Sep 2024 06:33:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1725802319; x=1726407119; darn=debbugs.gnu.org; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:from:to:cc:subject:date:message-id:reply-to; bh=5JMrXiC85fulzy5IZQQwWkzPqp1RCVYUc9O15eBsnqg=; b=CLdep2Fzw/hITXbTUVqgELVsSXK27JukIaEDjOHTzDBDk65Z9+uPcEe/S3jstV8lML NiN1TEpmGobveb/FFYazCEjN8jWhaeFDJ9am302zLqpegDJJLqY56jHyY0XQ/E4ZvRQr aO7v0xlSdCjfDpzjWj9h7dj2yGL9xa/eObtNGIlPv0n+TmH0ostRtRk9sPoGqzgCs2Kf baD4ou+n8LAsa8YFGg8Nkiw+nczu0zDppZnysr7X8K78W/z1Ukm+99vwk3u7tfn4WNg4 xIoTq9ttm5a+wmd4nGmoHiez/rTL3cIvMbT8r8HlCYkl+u5M2el7j1L+0ZfkPw+QOJ1H qQ6Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1725802319; x=1726407119; h=mime-version:user-agent:message-id:date:references:in-reply-to :subject:cc:to:from:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=5JMrXiC85fulzy5IZQQwWkzPqp1RCVYUc9O15eBsnqg=; b=QTy7xmp+BhqIErXHwiDZDa4MHsPMUbCSSG1DIkkjSpoUYn+t3NflVXGgPQZQiqezBe Cwf76MYF4ARtMJNjkn8U3lqWljNcoZYRMoXj2kJgeUeZtnafO8Xh5BF8St74mOsOrZNU 6412AM+xs0KGgjgR1tYNq5oDie9RSZLOp/gR8K+JlYtXAJW1dkDEfIUw7udydlyMDR/5 KvsPGiIm0tJTdPBL4T8RF3M5U2VT+g9CzrJEqDi1ZbuVKGmavEEA2ARA2gyZfQrPbMI1 Wa0KCIjX0zVZH49q9epGfmiCnqxqa/goIk4OnHi6yznU0rl8+2qLXZ4STTYbtcMuDLiE +u3Q== X-Gm-Message-State: AOJu0YzpnOmbpNnOJwUMvjYtHLBSJaXp/kG8GRo+dywGMUMnaBe7zEQp i6rmBtAMy8S6lChVgUefE8AMetVGo+EBdV+rHu3oYMVMLBL0uQA1 X-Google-Smtp-Source: AGHT+IGq0ify33JktdMFFq/X5lzfddWAm/b2ETqnxr5GMCom3vUtVFVG+at9+hs9zqt6klOwwjjE+g== X-Received: by 2002:a17:902:cf0b:b0:202:3e32:5d3e with SMTP id d9443c01a7336-206f055d122mr80818245ad.36.1725802319055; Sun, 08 Sep 2024 06:31:59 -0700 (PDT) Received: from hurd (vps-6234970c.vps.ovh.ca. [51.222.13.224]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-20710e10419sm20016875ad.28.2024.09.08.06.31.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 08 Sep 2024 06:31:58 -0700 (PDT) From: Maxim Cournoyer In-Reply-To: <7098b72d119941801db2c9f38a8a4f2dde03b540.1725562109.git.ekaitz@elenq.tech> (Ekaitz Zarraga's message of "Thu, 5 Sep 2024 20:48:29 +0200") References: <7098b72d119941801db2c9f38a8a4f2dde03b540.1725562109.git.ekaitz@elenq.tech> Date: Sun, 08 Sep 2024 22:31:51 +0900 Message-ID: <87tteqe0fs.fsf@gmail.com> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: text/plain X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Queue-Id: 066FE115BA X-Migadu-Scanner: mx13.migadu.com X-Migadu-Spam-Score: -10.42 X-Spam-Score: -10.42 X-TUID: 8Ym3vzsSWQAp Hi Ekaitz, Ekaitz Zarraga writes: > * doc/contributing.texi(Sending a Patch Series): Add a note about > `git format-patch` revision format and link to git documentation. > > Change-Id: Ie08f85dc19e3804165fb184664b74e85a804d7c4 > --- > doc/contributing.texi | 12 ++++++++++++ > 1 file changed, 12 insertions(+) > > diff --git a/doc/contributing.texi b/doc/contributing.texi > index 73f7addbef..d5d63ebdbd 100644 > --- a/doc/contributing.texi > +++ b/doc/contributing.texi > @@ -2187,6 +2187,18 @@ Sending a Patch Series > --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 The --base=auto can be dropped since it's part of our default git config, which is automatically installed for all of our contributors (c.f.: etc/git/gitconfig) when they build the Guix source. Otherwise, LGTM, if others think it has enough value to be added. -- Thanks, Maxim