From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from fhigh-a2-smtp.messagingengine.com (fhigh-a2-smtp.messagingengine.com [103.168.172.153]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 577052F12AE for ; Sun, 1 Feb 2026 12:11:47 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=103.168.172.153 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1769947908; cv=none; b=JsyHcuXddEDA6LG+Iid0yA80v/u7EYlyXTBLL5CwJN3Pa72XpDhG83yVVdZ/1M2v4fejYfJ3lBBoamS9H1Iks+4TAV3VT+QbfKJRciMHwJkcj9W48tjn3B1v8Vc0hllF/vtDPzzsuAH98dwu/iB4v0JpeqqUuFHRX37FdR5hCbo= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1769947908; c=relaxed/simple; bh=Nz78e43KJil7NXjKbJTpDMe/5JngU+HTc6Drcpw80M4=; h=MIME-Version:Date:From:To:Cc:Message-Id:In-Reply-To:References: Subject:Content-Type; b=CD6ewwiLgPaXMjwzfCKRYorNL4QGm1LXQkuYbYYs3qs9fdSR2uEGZoa7bzq0hlhbRyIRptNVl9rUqZNRmDuck60FzUN5cHlZCr2aDFabZOjpZx3HdgRmgw1XGbDV/j9JOXb8/NqKZVlxt6Rle9ZNt6gKRbQuc7bRLdtqehQ6oiI= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=fastmail.com; spf=pass smtp.mailfrom=fastmail.com; dkim=pass (2048-bit key) header.d=fastmail.com header.i=@fastmail.com header.b=R16BPapp; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b=FM+BVTdH; arc=none smtp.client-ip=103.168.172.153 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=fastmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=fastmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=fastmail.com header.i=@fastmail.com header.b="R16BPapp"; dkim=pass (2048-bit key) header.d=messagingengine.com header.i=@messagingengine.com header.b="FM+BVTdH" Received: from phl-compute-06.internal (phl-compute-06.internal [10.202.2.46]) by mailfhigh.phl.internal (Postfix) with ESMTP id 7F14D140005C; Sun, 1 Feb 2026 07:11:46 -0500 (EST) Received: from phl-imap-07 ([10.202.2.97]) by phl-compute-06.internal (MEProxy); Sun, 01 Feb 2026 07:11:46 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=fastmail.com; h= cc:cc:content-transfer-encoding:content-type:content-type:date :date:from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to; s=fm3; t=1769947906; x=1770034306; bh=ifraLszlMhNp9P6MG0wblyfLJXwblhUyjoWg/k7C1qc=; b= R16BPappWWBuaSozpub/zadk8HhgHCyoSt9WODZqU1BOK1Dr7sfFbdDPGduXGA8W gMprEMmEJC/fceLvpuib/hsG87lHY4SUnlRZdHJNV96DscmGsJBZA1FGOWSS1QKe l7srXqCPHQmKJppY/y4bxJbxm6Mv99aD8oikA7jR/4jtgGr9ilOz3XEUfJP77loI uMp7nevUlgeaLwMq1aXt0hXW7kvCWeJOai4sW1y3nEmTBoo+ByqVKXcdqS4+uRzP eA3wFlkIAgZTBDdgxSRC1ktISpYo+wXBaibQoCeTdpL1NSXV9oAKvWz918WWXSat c+JVbhJd1Q69OYKAMT4sdA== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:content-type:date:date:feedback-id:feedback-id :from:from:in-reply-to:in-reply-to:message-id:mime-version :references:reply-to:subject:subject:to:to:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t=1769947906; x= 1770034306; bh=ifraLszlMhNp9P6MG0wblyfLJXwblhUyjoWg/k7C1qc=; b=F M+BVTdHZevDw/2A2ky8m1WSPOGVVAQRfZPAzqiYrYFr+btXeke38/cRLYEhZMMuV NKFf89uMHNG9o+6zG864BIwD2Jr+G8SCZ3Y4AHJrmC1aVWSX/FbWYexFGKE+c/tc rZ33ktv2PIKBfGmXI1AYwqgEPF3KF4b6MQXNHe02UAUP9N+pUZENafz8G6CwCYxn ZhcbN95U3Q8MpDFAyUNCL4cQwGxaie/4DCMOGyBYvr4Gf16ZSQ687m957qTtNLBT wiuLNPkLPqopPwHau1o5wR3fGTkC+v75/r3VSBmBZ7SjF92KVtr4pfkn/pydpDTO 7m+Qyn19lte6ZFmvdM6Hg== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeefgedrtddtgddujeegjeehucetufdoteggodetrf dotffvucfrrhhofhhilhgvmecuhfgrshhtofgrihhlpdfurfetoffkrfgpnffqhgenuceu rghilhhouhhtmecufedttdenucesvcftvggtihhpihgvnhhtshculddquddttddmnecujf gurhepofggfffhvfevkfgjfhfutgfgsehtqhertdertdejnecuhfhrohhmpedfmfhrihhs thhofhhfvghrucfjrghughhssggrkhhkfdcuoehkrhhishhtohhffhgvrhhhrghughhssg grkhhksehfrghsthhmrghilhdrtghomheqnecuggftrfgrthhtvghrnheptdeigfegjeeg jefhheeuvdegjeekleeguddukeeljeektdevjefgiefgfeekudfgnecuvehluhhsthgvrh fuihiivgeptdenucfrrghrrghmpehmrghilhhfrhhomhepkhhrihhsthhofhhfvghrhhgr uhhgshgsrghkkhesfhgrshhtmhgrihhlrdgtohhmpdhnsggprhgtphhtthhopeefpdhmoh guvgepshhmthhpohhuthdprhgtphhtthhopehjnhdrrghvihhlrgesfhhrvggvrdhfrhdp rhgtphhtthhopehgihhtghhithhgrggughgvthesghhmrghilhdrtghomhdprhgtphhtth hopehgihhtsehvghgvrhdrkhgvrhhnvghlrdhorhhg X-ME-Proxy: Feedback-ID: i8b11424c:Fastmail Received: by mailuser.phl.internal (Postfix, from userid 501) id 512111EA006B; Sun, 1 Feb 2026 07:11:46 -0500 (EST) X-Mailer: MessagingEngine.com Webmail Interface Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-ThreadId: Aw2akiR53KZg Date: Sun, 01 Feb 2026 13:11:26 +0100 From: "Kristoffer Haugsbakk" To: =?UTF-8?Q?Jean-No=C3=ABl_Avila?= , git@vger.kernel.org Cc: =?UTF-8?Q?Jean-No=C3=ABl_AVILA?= Message-Id: <29bd35be-3bc7-40ed-aff5-f37da5c4eaf1@app.fastmail.com> In-Reply-To: References: Subject: Re: [PATCH 3/4] doc: fix some style issues in git-clone and for-each-ref-options Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable On Fri, Jan 23, 2026, at 22:15, Jean-No=C3=ABl Avila via GitGitGadget wr= ote: > From: =3D?UTF-8?q?Jean-No=3DC3=3DABl=3D20Avila?=3D > > * spell out all forms of --[no-]reject-shallow in git-clone > * use imperative mood for the first line of options > * Use asciidoc NOTE macro > * fix markups > > Signed-off-by: Jean-No=C3=ABl Avila > --- > Documentation/for-each-ref-options.adoc | 4 ++-- > Documentation/git-clone.adoc | 30 ++++++++++++------------- > 2 files changed, 17 insertions(+), 17 deletions(-) > > diff --git a/Documentation/for-each-ref-options.adoc > b/Documentation/for-each-ref-options.adoc > index f13efb5f25..54e2fa95c2 100644 > --- a/Documentation/for-each-ref-options.adoc > +++ b/Documentation/for-each-ref-options.adoc > @@ -30,8 +30,8 @@ TAB %(refname)`. > > `--color[=3D]`:: > Respect any colors specified in the `--format` option. The > - _ - `` is absent, behave as if `always` was given). > + __ field must be one of `always`, `never`, or `auto` (if > + __ is absent, behave as if `always` was given). Good. I also checked the placeholders in this doc (by searching for `<`) and couldn=E2=80=99t find any others that need updating. > > `--shell`:: > `--perl`:: > diff --git a/Documentation/git-clone.adoc b/Documentation/git-clone.ad= oc > index 7a0e147384..fceeb43475 100644 > --- a/Documentation/git-clone.adoc > +++ b/Documentation/git-clone.adoc > @@ -84,7 +84,7 @@ __. > with the source repository. The resulting repository > starts out without any object of its own. > + > -*NOTE*: this is a possibly dangerous operation; do *not* use > +NOTE: this is a possibly dangerous operation; do *not* use > it unless you understand what it does. If you clone your > repository using this option and then delete branches (or use any > other Git command that makes any existing commit unreferenced) in the A nice Note block. > @@ -104,7 +104,8 @@ If you want to break the dependency of a repository > cloned with `--shared` on > its source repository, you can simply run `git repack -a` to copy all > objects from the source repository into a pack in the cloned > repository. > > -`--reference[-if-able] `:: > +`--reference `:: > +`--reference-if-able `:: Proper split between the two variants, both spelled out. Good. > If the reference __ is on the local machine, > automatically setup `.git/objects/info/alternates` to > obtain objects from the reference __. Using > @@ -115,7 +116,7 @@ objects from the source repository into a pack in > the cloned repository. > directory is skipped with a warning instead of aborting > the clone. > + > -*NOTE*: see the NOTE for the `--shared` option, and also the > +NOTE: see the NOTE for the `--shared` option, and also the > `--dissociate` option. Good. > > `--dissociate`:: > @@ -140,14 +141,14 @@ objects from the source repository into a pack in > the cloned repository. > to the standard error stream. > > `--progress`:: > - Progress status is reported on the standard error stream > - by default when it is attached to a terminal, unless `--quiet` > + Report progress status on the standard error stream > + by default when attached to a terminal, unless `--quiet` Imperative mood. Good. > is specified. This flag forces progress status even if the > standard error stream is not directed to a terminal. > > `--server-option=3D