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

[PATCH v2] config/branch: state that <name>.merge is the remote ref

From
Philip Oakley <philipoakley@iee.email>
Date
Oct 18, 2019, 20:59 UTC
Message-ID
<20191018205935.2529-1-philipoakley@iee.email>
In-Reply-To
<c96f4dbd-ebc6-b743-716e-e1e17333c06b@iee.email>

The branch.<name>.merge value typically looks just like a local ref. Tell the reader it is the ref name at the remote, which may be different.

Signed-off-by: Philip Oakley <philipoakley@iee.email>
---
 Documentation/config/branch.txt | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/Documentation/config/branch.txt b/Documentation/config/branch.txt
index a592d522a7..cdc19edaaf 100644
--- a/Documentation/config/branch.txt
+++ b/Documentation/config/branch.txt
@@ -52,8 +52,10 @@ branch.<name>.pushRemote::
 	option to override it for a specific branch.
 
 branch.<name>.merge::
-	Defines, together with branch.<name>.remote, the upstream branch
-	for the given branch. It tells 'git fetch'/'git pull'/'git rebase' which
+	The name of the branch ref at the remote `branch.<name>.remote`
+	that is used as the upstream branch for the given branch <name>.
++
+	It tells 'git fetch'/'git pull'/'git rebase' which
 	branch to merge and can also affect 'git push' (see push.default).
 	When in branch <name>, it tells 'git fetch' the default
 	refspec to be marked for merging in FETCH_HEAD. The value is
-- 
2.23.0.windows.1.21.g947f504ebe8.dirty
Previous: Philip OakleyNext: Junio C Hamano
Message 4 of 6 in “config/branch: state that <name>.merge is the remote ref”
  1. config/branch: state that <name>.merge is the remote refPhilip Oakley, Oct 16, 2019
  2. Junio C HamanoOct 18, 2019
  3. Philip OakleyOct 18, 2019
  4. config/branch: state that <name>.merge is the remote refPhilip Oakley, Oct 18, 2019
  5. Junio C HamanoOct 18, 2019
  6. Philip OakleyOct 19, 2019

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.