From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-dy1-f176.google.com (mail-dy1-f176.google.com [74.125.82.176]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0E7633D4100 for ; Tue, 3 Feb 2026 17:03:47 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=74.125.82.176 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1770138231; cv=none; b=LQYbG6m6l+SaTbc0Pyno83Ahe0qkQgvkMT+cjvRij6+xJcYQPcHpgy60R2Q6oJxso+qgkdsH+H7naPeqgjUUZfxfOynSCna7lOujfDYR2dYG9hIW3kgEVV/BwvRjB6wFZzxp2HegwIMgBNRxBflSxrBsA8dVH4QC+oiwkhTnynI= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1770138231; c=relaxed/simple; bh=sGBZol8zCoTMPYMrI6Fm0nYcV03dj3lQ/AF9+aSKl1g=; h=Message-Id:In-Reply-To:References:From:Date:Subject:MIME-Version: Content-Type:To:Cc; b=kNt/DJOTzdnyibnjhXh6PeG/AVnHb9wdgTfzJo6/TInR1ukB9SISKnmH+LWRgF9g+1bcOCCHncH+m8Cuhkttt+HxX8kTeiatVC4kJz9GR5NxHQugnyvcTFjKwN4bLUVrUrZq9WS2+9qEq7uP8PJiu/2sc/IWhVmopx234obSflU= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=Ygy1VU7j; arc=none smtp.client-ip=74.125.82.176 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="Ygy1VU7j" Received: by mail-dy1-f176.google.com with SMTP id 5a478bee46e88-2b71557299dso5985707eec.1 for ; Tue, 03 Feb 2026 09:03:47 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1770138225; x=1770743025; darn=vger.kernel.org; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:from:to:cc:subject:date :message-id:reply-to; bh=WJaF1xaJK8G9Mu9eDQd4W9pfvGZafh3w705HXTP9ZNg=; b=Ygy1VU7jU9enp9PjGIi7sD2kFxmzT4PTYBJNZMc4wvZBhLe9qQlpGs3SFzNXoDC3Pa az/SB2BjJHESvW+7KhoKhWMoHhAhMDN63L49FPoxTXtDI8tb8TPM1DefwEc8MWajFB6N G2INmA1zSCNKrxURsA4ju0ztcezcmgdWfCi/uypuC3TK7MFHnFD5SjQGSUkV+D0oEJNG VaEwkupUp+DabKtnccWULavHYqsOIqr/LqD8apAcr1ECVjJavrotYUj4FmaFJQkx2F5K U2oeYsSNGemt/Xe4CwGzozcez09oV3CwP3/+r/CFdfW/9K58ivk/YL/q4sZG42YtYu2p rKfQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1770138225; x=1770743025; h=cc:to:fcc:content-transfer-encoding:mime-version:subject:date:from :references:in-reply-to:message-id:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=WJaF1xaJK8G9Mu9eDQd4W9pfvGZafh3w705HXTP9ZNg=; b=GmMWWR3YcgkAKtB/Sj40Ou4+p20XdGoh9A03YCX/blnQJ1cNV04V4jAVTaenqXVv5Z Ql3bVFtXUsAo6NvmOmeYQ5yD1eNAPfUGPEQTPmRzok2cOmwHdXaBw7i+LLWXPO/7EvdK JDpx6T8QBrxjCGhDU4u1HMnOvgJInsF1M52hWgEnoQ/dOEZ8IEeXUHfKVpm5OFEWfbV1 11B96mqxVgszatzVEmORbHYVb9p168i39Fufa1WWEs+BAmIUee0rZIkcBhw8qU+zwTgM kccysTBB/EobA7BzsXO+GisDYbrTmpKNKjErejd+Dbvc9Wrn5Yo/8YBnXUTuv65QEoQy ko+Q== X-Gm-Message-State: AOJu0YyFiT4NkZQGtN+H7R+VD97T3E0I+MP09COunpL8FQNSlKAFiJBD TEZRN1bdPUO5XPe3Qz1Ac/ZilBaPKkNEr9QsjkzpXgtXKCuMCfYQlmW5pjAPITJ+ X-Gm-Gg: AZuq6aLaAt08Vshjmo1jjWGf7hrE5UsU4FSR23jYTEmQMYP/aflF3vPpmDlqd3jwVQV W4yaW6FLiSU5zAPtDnM2x4IB8mvdtyP0cBFv295KuuScXbyt341aMyAfizH8KLdNZtNv1nnWsMj Q2Fgjl8KCyoCmRELNG/DJMXVEdOUc7CsLDylYSTduF2Wdcjff05k31SGRlLJAx7pMJIaxLhgbIy 9VgM+ENIVBHrDMkm/5JsXqLNimduaiP/tCMK82zLAVDuFnjkkE78DlESMdzX2TQdLW4P2h4mtwy u9Z5mZ43WBdeFRyfNf8Z2DT9FLBPGySaOd9rNY5e5gujIy2z5qa7fHvCXYno53JzXLWz5/TxqdT M8gJuYAxEVPbpMPcf6Q6XGrFncQYay0yHOtoeWy83excytp/zeEfPBhKZ7DqzGpXy2FQLMIt5qM 6Ydlv/lK8U3BtN X-Received: by 2002:a05:7300:a499:b0:2b8:273c:9cea with SMTP id 5a478bee46e88-2b8328bc075mr95628eec.18.1770138223409; Tue, 03 Feb 2026 09:03:43 -0800 (PST) Received: from [127.0.0.1] ([20.169.75.197]) by smtp.gmail.com with ESMTPSA id 5a478bee46e88-2b832e4d0b4sm44165eec.9.2026.02.03.09.03.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 03 Feb 2026 09:03:42 -0800 (PST) Message-Id: In-Reply-To: References: From: "=?UTF-8?q?Jean-No=C3=ABl=20Avila?= via GitGitGadget" Date: Tue, 03 Feb 2026 17:03:34 +0000 Subject: [PATCH v3 3/4] doc: fix some style issues in git-clone and for-each-ref-options Precedence: bulk X-Mailing-List: git@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Fcc: Sent To: git@vger.kernel.org Cc: Kristoffer Haugsbakk , =?UTF-8?Q?Jean-No=C3=ABl?= Avila , =?UTF-8?q?Jean-No=C3=ABl=20Avila?= From: =?UTF-8?q?Jean-No=C3=ABl=20Avila?= * 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ël Avila Reviewed-by: Kristoffer Haugsbakk --- Documentation/for-each-ref-options.adoc | 4 +- Documentation/git-clone.adoc | 52 ++++++++++++------------- Documentation/ref-storage-format.adoc | 4 +- 3 files changed, 30 insertions(+), 30 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[=]`:: 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). `--shell`:: `--perl`:: diff --git a/Documentation/git-clone.adoc b/Documentation/git-clone.adoc index 7a0e147384..959ca40733 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 @@ -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=`:: 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. `--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` is specified. This flag forces progress status even if the standard error stream is not directed to a terminal. `--server-option=