From patchwork Wed Jan 22 15:42:26 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Richard Earnshaw \(lists\)" X-Patchwork-Id: 182921 Delivered-To: patch@linaro.org Received: by 2002:a92:1f12:0:0:0:0:0 with SMTP id i18csp5229354ile; Wed, 22 Jan 2020 07:42:43 -0800 (PST) X-Google-Smtp-Source: APXvYqwaO9BTr6gFNwAvRvMqAGQ4BwDb0fR71oUM7X/XrE4mL4FA2HIMNveiuA79h8fp7Ul5oAv4 X-Received: by 2002:a9d:53c2:: with SMTP id i2mr7265102oth.43.1579707762984; Wed, 22 Jan 2020 07:42:42 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1579707762; cv=none; d=google.com; s=arc-20160816; b=0h2mg5m+uHgqu5c5EQ/8v53Bx1w0yYT6xbZ3PS62GDHCcqmR/pK4895pLTa6PHk7aM EZD5PH6vCVqtE7lUkNKx+a3HLH57TRk/dxf722+dd3/ij+Lr6UVYTlNBjjPPhrwBHlwA GPd+ddoPeHJM52eQc2rzrlqS5uw6/nY2qyIKu1UrD9tOsSiOa9sNRljI6LzCTnmdwaDM 31BPJ2P7/IVbA50dcSKYLqvcN4bvO6FsH0sXGUJ/KjFeEq84Uk5XypzKn+6owRKWC1Y8 d8P3n8gi3npe3fouVAT8yG/lSvP5MpeGs/ah+uGucohOutH7OuYLO4ymJnjIO+AdCi5l nVDQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:user-agent:date:message-id:subject:from:cc:to :delivered-to:sender:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:mailing-list:dkim-signature :domainkey-signature; bh=kvZfHqwBzNXSN8EbjIu4/RK5Wp7CrLWLrVmb+HEn8ss=; b=knCifv7uuIjcKNVNMXqYHdfB6ZtU1b1dCoJtiNzmGsWvzytEwZfHJhE1iUdrifN4SL wL+Q9KUR9NcphM6peSAcln30eKCu2PZbjAAnrqCXjgKbEjyMaoYsgYHLhEWzpgofet4N kk7jZq0TQlveA2TVeMrFn9AsxzSTxN5/7ygcdMGyyqiyAB1R51ZuqTfqGzlOPgdEBgmU KSZPyVJccTG2Yt9EoYDI6q7x1vrTgEU1GBkKwu0+w+gzXlhVJktwlMieePfStIsxK6CX zkOQ8Dg5joyBVmuCow6lK4Cjq06zefa0RX0Ryu3grs84xeuWJstteqVokcOsBMo9fUsV JmTQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gcc.gnu.org header.s=default header.b=LCa1cUww; spf=pass (google.com: domain of gcc-patches-return-518033-patch=linaro.org@gcc.gnu.org designates 209.132.180.131 as permitted sender) smtp.mailfrom="gcc-patches-return-518033-patch=linaro.org@gcc.gnu.org" Return-Path: Received: from sourceware.org (server1.sourceware.org. [209.132.180.131]) by mx.google.com with ESMTPS id t1si24697271otq.322.2020.01.22.07.42.42 for (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 22 Jan 2020 07:42:42 -0800 (PST) Received-SPF: pass (google.com: domain of gcc-patches-return-518033-patch=linaro.org@gcc.gnu.org designates 209.132.180.131 as permitted sender) client-ip=209.132.180.131; Authentication-Results: mx.google.com; dkim=pass header.i=@gcc.gnu.org header.s=default header.b=LCa1cUww; spf=pass (google.com: domain of gcc-patches-return-518033-patch=linaro.org@gcc.gnu.org designates 209.132.180.131 as permitted sender) smtp.mailfrom="gcc-patches-return-518033-patch=linaro.org@gcc.gnu.org" DomainKey-Signature: a=rsa-sha1; c=nofws; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:to:cc :from:subject:message-id:date:mime-version:content-type; q=dns; s=default; b=L/rUML/vshCrv04m+6gV94lX0LcTpZ0Xt1AQiEU+JGS7qm8jto OJxShqI+ZZgq6P9HermBeRWOqjLxT24VpE7fUsmSjKJXpnZrzd7Rocb4sKAnwGvz aBtuc+v0YAuyuf3edF6KUxlr2jbdpAbeWC1lXAf+9UIVJTSQ5+K1PiLzc= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:to:cc :from:subject:message-id:date:mime-version:content-type; s= default; bh=EHXX0Vg4OTvW4ghd+ZNuwtRAkas=; b=LCa1cUwwIH6jheEzuOvA uWyt7ZKetXHtIKHSvIEaL9xyryGYA93YJRJ0f0Gx9q6WZHOh9Zk0/SKpvo2g8Gmm DUu8ZoQKKloBJ+z3KPvsmZL3gkB2o/2CxgOiz9dXdzCnn0HKDCw8+LO2W+lEb3SB YWyySUfWJLo6FftT2PxjKcM= Received: (qmail 114051 invoked by alias); 22 Jan 2020 15:42:31 -0000 Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Delivered-To: mailing list gcc-patches@gcc.gnu.org Received: (qmail 114026 invoked by uid 89); 22 Jan 2020 15:42:31 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-18.8 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, RCVD_IN_DNSWL_LOW, SPF_PASS autolearn=ham version=3.3.1 spammy=sk:non-fas, sk:nonfas, personal X-HELO: foss.arm.com Received: from foss.arm.com (HELO foss.arm.com) (217.140.110.172) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Wed, 22 Jan 2020 15:42:29 +0000 Received: from usa-sjc-imap-foss1.foss.arm.com (unknown [10.121.207.14]) by usa-sjc-mx-foss1.foss.arm.com (Postfix) with ESMTP id 060BD106F; Wed, 22 Jan 2020 07:42:28 -0800 (PST) Received: from e120077-lin.cambridge.arm.com (e120077-lin.cambridge.arm.com [10.2.78.81]) by usa-sjc-imap-foss1.foss.arm.com (Postfix) with ESMTPSA id 4B46B3F68E; Wed, 22 Jan 2020 07:42:27 -0800 (PST) To: "gcc-patches@gcc.gnu.org" Cc: jakub@redhat.com, Gerald Pfeifer , Joseph Myers From: "Richard Earnshaw (lists)" Subject: wwwdocs: Document the gcc git repository layout Message-ID: Date: Wed, 22 Jan 2020 15:42:26 +0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:60.0) Gecko/20100101 Thunderbird/60.9.0 MIME-Version: 1.0 The GCC git repository makes use of some non-standard refs so that by default only the most active and useful branches and tags are fetched by a git clone. This patch documents the additional branch and tag spaces that exist on the server. Joseph, have I got all of these right? R. diff --git a/htdocs/git.html b/htdocs/git.html index 6100146e..6d3778af 100644 --- a/htdocs/git.html +++ b/htdocs/git.html @@ -197,6 +197,61 @@ To create a worktree for a new project branch based on master, do git worktree add -b project ../project master +

Repository Layout

+ +

By default, a git clone operation will only fetch the +main development, release branches and their associated tags from the +server. This will be sufficient for most users, but a number of +additional branches can also be fetched if necessary.

+ +

The following areas exist on the server:

+
    +
  • refs/heads/master - The active development version of the + compiler.
    • +
  • refs/heads/releases/* - Release branches.
    • +
  • refs/heads/devel/* - topic-specific development branches + - see Active Development Branches. + Branches and tags in this space may be moved to refs/dead once active + development is completed or abandoned.
    • +
  • refs/tags/* - tags for all of the above branches.
    • +
  • refs/vendors/*/{heads,tags}/* - vendor-specific branches and + tags. These are owned and maintained by the respective + vendor, but made available publicly. Non-fast-forward pushes + are permitted on these branches.
    • +
  • refs/users/*/{heads,tags}/* - personal developer branches and + tags. These are owned and maintained by the individual developer. + Non-fast-forward pushes are permitted on these branches.
    • +
  • refs/dead/heads/* - completed or abandoned development + branches.
    • +
  • refs/meta - local configuration data for the commit hooks + on the server.
    • +
  • refs/deleted/*/{heads,tags}/* - old branches and tags + from the SVN repository that were deleted before the conversion to + git.
    • +
  • refs/git-svn-old/* - various branches and tags from the + git-svn pre-conversion git mirror.
    • +
  • refs/git-old/* - various branches and tags from the + git-svn pre-conversion git mirror that were local to that git + repository.
    • +
+ +

You can download any of the additional branches by adding a suitable +fetch specification to your local copy of the git repostiory. For +example, if your remote is called 'origin' (the default with git +clone) you can add the 'dead' development branches by running:

+ +
+    git config --add remote.origin.fetch "+refs/dead/heads/*:refs/remotes/origin/dead/*"
+    git config --add remote.origin.fetch "+refs/dead/tags/*:refs/tags/dead/*"
+    git fetch origin
+
+ +

which will place the dead branches in remotes/origin/dead + and the tags in tags/dead.

+ +

You can use git ls-remote to get a complete list of +refs that the server holds.

+

Active Development Branches