Re: [PATCH] new-command.txt: update reference to builtin docs

From: Junio C Hamano <gitster@pobox.com>
Date: Feb 6, 2023, 22:07 UTC
Message-ID: <xmqqo7q64fe2.fsf@gitster.g>
In-Reply-To: <pull.1451.git.git.1675477659972.gitgitgadget@gmail.com>

"Wes Lord via GitGitGadget" <gitgitgadget@gmail.com> writes:

Show 10 quoted lines

> From: Wes Lord <weslord@gmail.com>
>
> 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, but new-command.txt still references the old
> file.
>
> Signed-off-by: Wes Lord <weslord@gmail.com>
> ---
>     new-command.txt: update reference to builtin docs

I was sort of hoping that this document has outlived its usefulness and been taken over by more recently written guies, but it does not appear to be the case. A more recently written MyFirstContribution references this, so keeping its contents fresh does have value.

Thanks, will queue.

Show 22 quoted lines

> diff --git a/Documentation/howto/new-command.txt b/Documentation/howto/new-command.txt
> index 15a4c8031f1..880c51112ba 100644
> --- a/Documentation/howto/new-command.txt
> +++ b/Documentation/howto/new-command.txt
> @@ -1,13 +1,13 @@
>  From: Eric S. Raymond <esr@thyrsus.com>
>  Abstract: This is how-to documentation for people who want to add extension
> - commands to Git.  It should be read alongside api-builtin.txt.
> + commands to Git.  It should be read alongside builtin.h.
>  Content-type: text/asciidoc
>  
>  How to integrate new subcommands
>  ================================
>  
>  This is how-to documentation for people who want to add extension
> -commands to Git.  It should be read alongside api-builtin.txt.
> +commands to Git.  It should be read alongside builtin.h.
>  
>  Runtime environment
>  -------------------
>
> base-commit: 2fc9e9ca3c7505bc60069f11e7ef09b1aeeee473