git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH] Documentation: replace - use consistent 'replace reference'

From
Yaroslav Halchenko <debian@onerussian.com>
Date
Apr 27, 2022, 19:54 UTC
Message-ID
<20220427195450.366703-1-debian@onerussian.com>

As a new user to 'git replace' I found it a little uncertain about what "'replace' reference" documentation was talking since there was only "replacement" mentioned in the command summary. Decided to make it more consistent as 'replace reference' after checking that in a few spots there is a use of multi word entries within <>.

Signed-off-by: Yaroslav Halchenko <debian@onerussian.com>
---
 Documentation/git-replace.txt | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)
diff --git a/Documentation/git-replace.txt b/Documentation/git-replace.txt
index f271d758c3..71f98edfe3 100644
--- a/Documentation/git-replace.txt
+++ b/Documentation/git-replace.txt
@@ -8,7 +8,7 @@ git-replace - Create, list, delete refs to replace objects
 SYNOPSIS
 --------
 [verse]
-'git replace' [-f] <object> <replacement>
+'git replace' [-f] <object> <replace reference>
 'git replace' [-f] --edit <object>
 'git replace' [-f] --graft <commit> [<parent>...]
 'git replace' [-f] --convert-graft-file
@@ -17,16 +17,16 @@ SYNOPSIS
 
 DESCRIPTION
 -----------
-Adds a 'replace' reference in `refs/replace/` namespace.
+Adds a 'replace reference' in `refs/replace/` namespace.
 
-The name of the 'replace' reference is the SHA-1 of the object that is
-replaced. The content of the 'replace' reference is the SHA-1 of the
+The name of the 'replace reference' is the SHA-1 of the object that is
+replaced. The content of the 'replace reference' is the SHA-1 of the
 replacement object.
 
 The replaced object and the replacement object must be of the same type.
 This restriction can be bypassed using `-f`.
 
-Unless `-f` is given, the 'replace' reference must not yet exist.
+Unless `-f` is given, the 'replace reference' must not yet exist.
 
 There is no other restriction on the replaced and replacement objects.
 Merge commits can be replaced by non-merge commits and vice versa.
-- 
2.35.1
Next: Junio C Hamano
Message 1 of 2 in “Documentation: replace - use consistent 'replace reference'”
  1. Documentation: replace - use consistent 'replace reference'Yaroslav Halchenko, Apr 27, 2022
  2. Junio C HamanoApr 27, 2022

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.