From: Junio C Hamano <gitster@pobox.com>
Date: Mon, 06 Feb 2023 22:07:17 GMT
Subject: Re: [PATCH] new-command.txt: update reference to builtin docs
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:

> 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.

> 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