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

[PATCH] api docs: link to html version of api-trace2

From
Todd Zullinger <tmz@pobox.com>
Date
Sep 16, 2022, 06:23 UTC
Message-ID
<20220916062303.3736166-2-tmz@pobox.com>
In-Reply-To
<20220916062303.3736166-1-tmz@pobox.com>

In f6d25d7878 (api docs: document that BUG() emits a trace2 error event, 2021-04-13), a link to the plain text version of api-trace2 was added in `technical/api-error-handling.txt`.

All of our other `link:`s point to the html versions.  Do the same here.
Signed-off-by: Todd Zullinger <tmz@pobox.com>
---
This is minor, but I noticed it while working on the previous patch.  The
effect can be see at [1] where we link to [2].

Somewhat related, it also appears that the link to the API docs in the "Further documentation" section on git-scm.com is broken entirely[3]. I didn't try to chase down why that might be, but perhaps someone who knows the site build process can fix it up.

[1] https://mirrors.edge.kernel.org/pub/software/scm/git/docs/technical/api-error-handling.html [2] https://mirrors.edge.kernel.org/pub/software/scm/git/docs/technical/api-trace2.txt [3] https://git-scm.com/docs/git#_further_documentation

 Documentation/technical/api-error-handling.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/Documentation/technical/api-error-handling.txt b/Documentation/technical/api-error-handling.txt
index 70bf1d3e52..665c4960b4 100644
--- a/Documentation/technical/api-error-handling.txt
+++ b/Documentation/technical/api-error-handling.txt
@@ -46,7 +46,7 @@ parse-options.c.
   returns -1 after reporting the situation to the caller.
 
 These reports will be logged via the trace2 facility. See the "error"
-event in link:api-trace2.txt[trace2 API].
+event in link:api-trace2.html[trace2 API].
 
 Customizable error handlers
 ---------------------------
Previous: Todd ZullingerNext: Junio C Hamano
Message 2 of 4 in “docs: fix a few recently broken links”
  1. docs: fix a few recently broken linksTodd Zullinger, Sep 16, 2022
  2. api docs: link to html version of api-trace2Todd Zullinger, Sep 16, 2022
  3. Junio C HamanoSep 16, 2022
  4. Junio C HamanoSep 16, 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.