From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS3215 2.6.0.0/16 X-Spam-Status: No, score=-4.6 required=3.0 tests=AWL,BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE, SPF_PASS shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from out1.vger.email (out1.vger.email [IPv6:2620:137:e000::1:20]) by dcvr.yhbt.net (Postfix) with ESMTP id 51D561F403 for ; Sat, 22 Oct 2022 22:27:02 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S229947AbiJVW0y (ORCPT ); Sat, 22 Oct 2022 18:26:54 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:49666 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229520AbiJVW0x (ORCPT ); Sat, 22 Oct 2022 18:26:53 -0400 Received: from smtp-out-5.talktalk.net (smtp-out-5.talktalk.net [62.24.135.69]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 77CCF963A5 for ; Sat, 22 Oct 2022 15:26:50 -0700 (PDT) Received: from localhost.localdomain ([88.110.102.84]) by smtp.talktalk.net with SMTP id mMw7oFnZllLbymMw8oJF1P; Sat, 22 Oct 2022 23:25:49 +0100 X-Originating-IP: [88.110.102.84] X-Spam: 0 X-OAuthority: v=2.3 cv=OJpZIhSB c=1 sm=1 tr=0 a=f4UhoLCnUTRb1HgAgoWw0g==:117 a=f4UhoLCnUTRb1HgAgoWw0g==:17 a=MKtGQD3n3ToA:10 a=1oJP67jkp3AA:10 a=ldyaYNNxDcoA:10 a=L21Qlja0vAKRWb0B7dUA:9 From: Philip Oakley To: GitList Cc: Self , Junio C Hamano , Derrick Stolee , Abhradeep Chakraborty Subject: [PATCH v2 2/3] glossary: add "commit graph" description Date: Sat, 22 Oct 2022 23:25:38 +0100 Message-Id: <20221022222539.2333-3-philipoakley@iee.email> X-Mailer: git-send-email 2.38.1.windows.1 In-Reply-To: <20221022222539.2333-1-philipoakley@iee.email> References: <20221022222539.2333-1-philipoakley@iee.email> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-CMAE-Envelope: MS4wfCCeDBo/gV7U5qk2kUuww/rJO5Ip7m5x2TfSUI04qacofoI5XuM/hRb5CMo8sL6mhQ2A4sWd4NyVvLgNhw8H4RCLNmuXJCeD+FF83Y1A2Z0SjUbS7KQ/ WwFBP7JJivva8hGP6snHtjkmPg/e8sWvxEBlXcn9HryUGLcr9m8css21U4ZdvJx03wFYtPk2mkP3dWwkW0I9OsEE3ZPJDIkKYMhRmgIV+OMbQiWhul0LbCa4 pkmJZ9I3wOWwr0LVDVhepiSEGEP0ILIWX9vG9OOBAKPEE7/MZs1yEgi1el+WcR8BA1aEYSZCV7wMdbXl2AGUUA== Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Git has an additional "commit graph" capability that supplements the normal commit object's directed acylic graph (DAG). The supplemental commit graph file is designed for speed of access. Describe the commit graph both from the normative DAG view point and from the commit graph file perspective. Also, clarify the link between the branch ref and branch tip by linking to the `ref` glossary entry, matching this commit graph entry. Signed-off-by: Philip Oakley --- Documentation/glossary-content.txt | 17 ++++++++++++++++- 1 file changed, 16 insertions(+), 1 deletion(-) diff --git a/Documentation/glossary-content.txt b/Documentation/glossary-content.txt index 947ac49606..97050826e5 100644 --- a/Documentation/glossary-content.txt +++ b/Documentation/glossary-content.txt @@ -20,7 +20,7 @@ [[def_branch]]branch:: A "branch" is a line of development. The most recent <> on a branch is referred to as the tip of - that branch. The tip of the branch is referenced by a branch + that branch. The tip of the branch is <> by a branch <>, which moves forward as additional development is done on the branch. A single Git <> can track an arbitrary number of @@ -75,6 +75,21 @@ state in the Git history, by creating a new commit representing the current state of the <> and advancing <> to point at the new commit. +[[def_commit_graph_general]]commit graph concept, representations and usage:: + A synonym for the <> structure formed by + the commits in the object database, <> by branch tips, + using their <> of linked commits. + This structure is the definitive commit graph. The + graph can be represented in other ways, e.g. the + <>. + +[[def_commit_graph_file]]commit graph file:: + The commit-graph file is a supplemental representation of + the <> which accelerates + commit graph walks. The "commit-graph" file is stored + either in the .git/objects/info directory or in the info directory + of an alternate object database. + [[def_commit_object]]commit object:: An <> which contains the information about a particular <>, such as <>, committer, -- 2.38.1.windows.1