[PATCH v3 0/2] doc: refs: put ref migration warning under the command
- From
- kristofferhaugsbakk@fastmail.com <kristofferhaugsbakk@fastmail.com>
- Date
- Aug 6, 2026, 06:20 UTC
- Message-ID
- <V3_CV_git_ref_migration_warning.b23@msgid.xyz>
- In-Reply-To
- <CV_git_ref_migration_warning.b09@msgid.xyz>
From: Kristoffer Haugsbakk <code@khaugsbakk.name>
Topic name (applied): doc-refs-migrate-limitations
Topic summary: Put ref migration warning as an admonition under the command so that it is visible.
That’s the first patch. The second patch adds a missing `linkgit` since it touches that same warning text.
I have two other patches that are not included here. They are unrelated cleanups that I will post later. Here are the commit subjects and the first paragraph so that you can see what they are about:
• doc: refs: wrap standalone placeholders in underscores
This is a synopsis manpage which means that standalone placeholders[1] are supposed to use underscores (_), not backticks (`).[2] • doc: refs: use inline-verbatim throughout
Use inline-verbatim backticks (`) for literal commands, options, and subcommands listed under the “Commands” section.
§ Cc list
The two people that I have the impression that have worked most on this command.
§ Changes in v3
• Patch 1/2: Add Ack
§ Link to v2
https://lore.kernel.org/git/V2_CV_git_ref_migration_warning.b20@msgid.xyz/
[1/2] doc: refs: put ref migration warning under the command [2/2] doc: refs: linkgit to git-maintenance(1)
Documentation/git-refs.adoc | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-)
Interdiff against v2:
Range-diff against v2:
1: 8a6415e2d9b ! 1: 3ea1680afc8 doc: refs: put ref migration warning under the command
@@ Commit message
description. A one-page man page. But that is not the case anymore
now that the command has nine subcommands to describe.
+ Acked-by: Patrick Steinhardt <ps@pks.im>
Signed-off-by: Kristoffer Haugsbakk <code@khaugsbakk.name>
## Documentation/git-refs.adoc ##
2: 801a3d7f539 = 2: 1d91be5762b doc: refs: linkgit to git-maintenance(1)base-commit: 13c7afec212fc97ce257d15601659314c6673d6c
-- 2.54.0.22.g9e26862b904