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

[PATCH v2] api-argv-array.txt: Remove broken link to string-list API

From
Todd Zullinger <tmz@pobox.com>
Date
Oct 6, 2017, 03:14 UTC
Message-ID
<20171006031456.9632-1-tmz@pobox.com>
In-Reply-To
<xmqq4lrdyp8v.fsf@gitster.mtv.corp.google.com>

In 4f665f2cf3 (string-list.h: move documentation from Documentation/api/ into header, 2017-09-26) the string-list API documentation was moved to string-list.h. The argv-array API documentation may follow a similar course in the future. Until then, prevent the broken link from making it to the end-user documentation.

Signed-off-by: Todd Zullinger <tmz@pobox.com>
---
Junio C Hamano wrote:
> Probably removing the link is the right thing to do.

Excellent. Thank you for detailing the likely progression as well as the preferred solution.

 Documentation/technical/api-argv-array.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/technical/api-argv-array.txt b/Documentation/technical/api-argv-array.txt
index cfc063018c..870c8edbfb 100644
--- a/Documentation/technical/api-argv-array.txt
+++ b/Documentation/technical/api-argv-array.txt
@@ -8,7 +8,7 @@ always NULL-terminated at the element pointed to by `argv[argc]`. This
 makes the result suitable for passing to functions expecting to receive
 argv from main(), or the link:api-run-command.html[run-command API].
 
-The link:api-string-list.html[string-list API] is similar, but cannot be
+The string-list API (documented in string-list.h) is similar, but cannot be
 used for these purposes; instead of storing a straight string pointer,
 it contains an item structure with a `util` field that is not compatible
 with the traditional argv interface.
-- 
2.15.0.rc0
Previous: Junio C HamanoNext: Jonathan Nieder
Message 3 of 5 in “api-argv-array.txt: Update link to string-list API”
  1. api-argv-array.txt: Update link to string-list APITodd Zullinger, Oct 5, 2017
  2. Junio C HamanoOct 6, 2017
  3. api-argv-array.txt: Remove broken link to string-list APITodd Zullinger, Oct 6, 2017
  4. Jonathan NiederOct 6, 2017
  5. Todd ZullingerOct 6, 2017

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.