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

[PATCH 6/6] Remove 'for-push' from ref list attributes list, link to subsections

From
Max Horn <max@quendi.de>
Date
Nov 27, 2012, 17:44 UTC
Message-ID
<1354038279-76475-7-git-send-email-max@quendi.de>
In-Reply-To
<1354038279-76475-1-git-send-email-max@quendi.de>

The documentation was misleading in that it gave the impression that 'for-push' could be used as a ref attribute in the output of the 'list' command. That is wrong.

Signed-off-by: Max Horn <max@quendi.de>
---
 Documentation/git-remote-helpers.txt | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)
diff --git a/Documentation/git-remote-helpers.txt b/Documentation/git-remote-helpers.txt
index 023dcca..081cb06 100644
--- a/Documentation/git-remote-helpers.txt
+++ b/Documentation/git-remote-helpers.txt
@@ -227,6 +227,8 @@ Support for this command is mandatory.
 	the name; unrecognized attributes are ignored. The list ends
 	with a blank line.
 +
+See REF LIST ATTRIBUTES for a list of currently defined options.
++
 Supported if the helper has the "fetch" or "import" capability.
 
 'list for-push'::
@@ -248,6 +250,8 @@ Supported if the helper has the "push" or "export" capability.
 	for it).  Options should be set before other commands,
 	and may influence the behavior of those commands.
 +
+See OPTIONS for a list of currently defined options.
++
 Supported if the helper has the "option" capability.
 
 'fetch' <sha1> <name>::
@@ -256,7 +260,7 @@ Supported if the helper has the "option" capability.
 	per line, terminated with a blank line.
 	Outputs a single blank line when all fetch commands in the
 	same batch are complete. Only objects which were reported
-	in the ref list with a sha1 may be fetched this way.
+	in the output of 'list' with a sha1 may be fetched this way.
 +
 Optionally may output a 'lock <file>' line indicating a file under
 GIT_DIR/objects/pack which is keeping a pack until refs can be
@@ -360,10 +364,9 @@ capabilities reported by the helper.
 REF LIST ATTRIBUTES
 -------------------
 
-'for-push'::
-	The caller wants to use the ref list to prepare push
-	commands.  A helper might chose to acquire the ref list by
-	opening a different type of connection to the destination.
+The 'list' command produces a list of refs in which each ref
+may be followed by a list of attributes. The following ref list
+attributes are defined.
 
 'unchanged'::
 	This ref is unchanged since the last import or fetch, although
-- 
1.8.0.393.gcc9701d
Previous: Max HornNext: Junio C Hamano
Message 10 of 16 in “Improve remote helper documentation”
  1. 0/6 Improve remote helper documentationMax Horn, Nov 27, 2012
  2. 1/6 Document invocation first, then input formatMax Horn, Nov 27, 2012
  3. 2/6 Document missing remote helper capabilitiesMax Horn, Nov 27, 2012
  4. 3/6 Fix grammarMax Horn, Nov 27, 2012
  5. Junio C HamanoNov 27, 2012
  6. Max HornNov 27, 2012
  7. Junio C HamanoNov 27, 2012
  8. 4/6 Rearrange the description of remote helper capabilitiesMax Horn, Nov 27, 2012
  9. 5/6 Make clearer which commands must be supported for which capabilitiesMax Horn, Nov 27, 2012
  10. 6/6 Remove 'for-push' from ref list attributes list, link to subsectionsMax Horn, Nov 27, 2012
  11. Junio C HamanoDec 7, 2012
  12. Sverre RabbelierDec 7, 2012
  13. Max HornDec 7, 2012
  14. Junio C HamanoDec 7, 2012
  15. Max HornDec 7, 2012
  16. Felipe ContrerasDec 12, 2012

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.