Subject: Re: [PATCH v7 06/10] docs: move commit-graph format docs to man section 5

From: Junio C Hamano <[email-masked]>
Date: Wed, 03 Aug 2022 08:48:11 -0700

Ævar Arnfjörð Bjarmason  <[email-masked]> writes:

> Continue the move of existing Documentation/technical/* protocol and
> file-format documentation into our main documentation space.
>
> By moving the documentation for the commit-graph format into man
> section 5 and the new "developerinterfaces" category. This change is
> split from subsequent commits due to the relatively large amount of
> ASCIIDOC formatting changes that are required.
>
> Signed-off-by: Ævar Arnfjörð Bjarmason <[email-masked]>
> ---
>  Documentation/Makefile                        |  1 +
>  Documentation/git-commit-graph.txt            |  5 ++
>  ...-format.txt => gitformat-commit-graph.txt} | 47 +++++++++++++------
>  Documentation/technical/chunk-format.txt      |  4 +-
>  command-list.txt                              |  2 +
>  5 files changed, 42 insertions(+), 17 deletions(-)

OK.  Rename of a single document with a bit of mark-up updates, plus
adjusting the links that refer to the original location to its new
location.  Nothing unexpected, other than a single curious bit.

> diff --git a/command-list.txt b/command-list.txt
> index 1950c4ccd9c..44e244a76f6 100644
> --- a/command-list.txt
> +++ b/command-list.txt
> @@ -210,6 +210,8 @@ gitdiffcore                             guide
>  giteveryday                             guide
>  gitfaq                                  guide
>  gitformat-bundle                        developerinterfaces
> +gitformat-bundle                        developerinterfaces
> +gitformat-commit-graph                  developerinterfaces
>  gitglossary                             guide
>  githooks                                userinterfaces
>  gitignore                               userinterfaces

I do not think we want or need duplicate entries for "bundle",
and it has nothing to do with the "commit-graph" doc.