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

Re: [PATCH 09/34] howto/new-command: update reference to builtin docs

From
Junio C Hamano <gitster@pobox.com>
Date
Mar 3, 2025, 21:59 UTC
Message-ID
<xmqqfrjtvkqp.fsf@gitster.g>
In-Reply-To
<20250303204443.360595-10-tmz@pobox.com>
Todd Zullinger <tmz@pobox.com> writes:
Show 10 quoted lines
> Commit ec14d4ecb5 (builtin.h: take over documentation from
> api-builtin.txt, 2017-08-02) deleted api-builtin.txt and moved the
> contents into builtin.h.  Most of the references were fixed in
> d85e9448dd (new-command.txt: update reference to builtin docs,
> 2023-02-04), but one remained.  Fix it.
>
> Signed-off-by: Todd Zullinger <tmz@pobox.com>
> ---
>  Documentation/howto/new-command.adoc | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)

;-) This is orthogonal to the txt-to-adoc gotcha but is a long overdue fix to even older breakage. Thanks for addressing it.

Show 13 quoted lines
> diff --git a/Documentation/howto/new-command.adoc b/Documentation/howto/new-command.adoc
> index 880c51112b..ac73c98be7 100644
> --- a/Documentation/howto/new-command.adoc
> +++ b/Documentation/howto/new-command.adoc
> @@ -48,7 +48,7 @@ binary); this organization makes it easy for people reading the code
>  to find things.
>  
>  See the CodingGuidelines document for other guidance on what we consider
> -good practice in C and shell, and api-builtin.txt for the support
> +good practice in C and shell, and builtin.h for the support
>  functions available to built-in commands written in C.
>  
>  What every extension command needs
Previous: Todd ZullingerNext: Todd Zullinger
Message 16 of 43 in “misc *.txt -> *.adoc fixes”
  1. 00/34 misc *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  2. 01/34 t0450: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  3. Junio C HamanoMar 3, 2025
  4. Todd ZullingerMar 3, 2025
  5. Junio C HamanoMar 3, 2025
  6. Todd ZullingerMar 4, 2025
  7. 02/34 .gitattributes: more *.txt -> *.adoc updatesTodd Zullinger, Mar 3, 2025
  8. 03/34 doc: remove unneeded .gitattributesTodd Zullinger, Mar 3, 2025
  9. Junio C HamanoMar 3, 2025
  10. 04/34 Makefile: update reference to technical/racy-git.adocTodd Zullinger, Mar 3, 2025
  11. 05/34 README: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  12. 06/34 CodingGuidelines: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  13. 07/34 MyFirstContribution: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  14. 08/34 MyFirstObjectWalk: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  15. 09/34 howto/new-command: update reference to builtin docsTodd Zullinger, Mar 3, 2025
  16. Junio C HamanoMar 3, 2025
  17. 10/34 technical/partial-clone: update reference to rev-list-options.adocTodd Zullinger, Mar 3, 2025
  18. 11/34 doc: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  19. 12/34 advice.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  20. 13/34 apply.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  21. 14/34 builtin.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  22. 15/34 config.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  23. 16/34 contrib/long-running-filter: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  24. 17/34 diff.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  25. 18/34 diffcore.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  26. 19/34 fsck.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  27. 20/34 list-objects-filter-options.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  28. 21/34 object-name.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  29. 22/34 parse-options.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  30. 23/34 pseudo-merge.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  31. 24/34 refs.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  32. 25/34 setup.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  33. 26/34 simple-ipc.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  34. 27/34 t/helper/test-rot13-filter.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  35. 28/34 t6012: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  36. 29/34 t6434: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  37. 30/34 trace2.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  38. 31/34 trace2/tr2_sysenv.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  39. 32/34 transport.h: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  40. 33/34 unpack-trees.c: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  41. 34/34 xdiff: *.txt -> *.adoc fixesTodd Zullinger, Mar 3, 2025
  42. brian m. carlsonMar 3, 2025
  43. Junio C HamanoMar 3, 2025

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.