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

Re: [PATCH] config: fix commit-graph related config docs

From
Duy Nguyen <pclouds@gmail.com>
Date
Aug 22, 2018, 15:25 UTC
Message-ID
<CACsJy8C6DPTjhLm0tgyK4+RepQmWBkxnwTwoUhVvDYoXC_+m4w@mail.gmail.com>
In-Reply-To
<20180822131547.56899-1-dstolee@microsoft.com>
On Wed, Aug 22, 2018 at 3:18 PM Derrick Stolee <dstolee@microsoft.com> wrote:
Show 31 quoted lines
>
> The core.commitGraph config setting was accidentally removed from
> the config documentation. In that same patch, the config setting
> that writes a commit-graph during garbage collection was incorrectly
> written to the doc as "gc.commitGraph" instead of "gc.writeCommitGraph".
>
> Reported-by: Szeder Gábor <szeder.dev@gmail.com>
> Signed-off-by: Derrick Stolee <dstolee@microsoft.com>
> ---
>
> Szeder reported this in [1] and I forgot until now to come back to it.
>
> [1] https://public-inbox.org/git/20180803093909.2853-1-szeder.dev@gmail.com/
>
>  Documentation/config.txt | 6 +++++-
>  1 file changed, 5 insertions(+), 1 deletion(-)
>
> diff --git a/Documentation/config.txt b/Documentation/config.txt
> index 1c42364988..f846543414 100644
> --- a/Documentation/config.txt
> +++ b/Documentation/config.txt
> @@ -917,7 +917,11 @@ core.notesRef::
>  This setting defaults to "refs/notes/commits", and it can be overridden by
>  the `GIT_NOTES_REF` environment variable.  See linkgit:git-notes[1].
>
> -gc.commitGraph::
> +core.commitGraph::
> +       Enable git commit graph feature. Allows reading from the
> +       commit-graph file.
> +
> +gc.writeCommitGraph::
Do
git grep -i '^[a-z.]*::' Documentation/config.txt

and you will see that we (mostly) group config keys by section. There's already gc group and this gc.writeCommitGraph belongs there, not in the middle of "core" stuff.

Show 8 quoted lines
>         If true, then gc will rewrite the commit-graph file when
>         linkgit:git-gc[1] is run. When using linkgit:git-gc[1]
>         '--auto' the commit-graph will be updated if housekeeping is
>
> base-commit: 7e8bfb0412581daf8f3c89909f1d37844e8610dd
> --
> 2.19.0.rc0
>
-- 
Duy
Previous: Derrick StoleeNext: Johannes Sixt
Message 2 of 5 in “config: fix commit-graph related config docs”
  1. config: fix commit-graph related config docsDerrick Stolee, Aug 22, 2018
  2. Duy NguyenAug 22, 2018
  3. Johannes SixtAug 22, 2018
  4. config: fix commit-graph related config docsDerrick Stolee, Aug 23, 2018
  5. Junio C HamanoAug 23, 2018

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.