From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id A522B138247 for ; Sat, 21 Dec 2013 05:00:33 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 7A803E0AE2; Sat, 21 Dec 2013 05:00:29 +0000 (UTC) Received: from qmta12.westchester.pa.mail.comcast.net (qmta12.westchester.pa.mail.comcast.net [76.96.59.227]) by pigeon.gentoo.org (Postfix) with ESMTP id 057D4E0AE2 for ; Sat, 21 Dec 2013 05:00:28 +0000 (UTC) Received: from omta24.westchester.pa.mail.comcast.net ([76.96.62.76]) by qmta12.westchester.pa.mail.comcast.net with comcast id 44tv1n0021ei1Bg5C50UBp; Sat, 21 Dec 2013 05:00:28 +0000 Received: from odin.tremily.us ([24.18.63.50]) by omta24.westchester.pa.mail.comcast.net with comcast id 450T1n00T152l3L3k50UAD; Sat, 21 Dec 2013 05:00:28 +0000 Received: by odin.tremily.us (Postfix, from userid 1000) id 27CC5DA4270; Fri, 20 Dec 2013 21:00:27 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=tremily.us; s=odin; t=1387602027; bh=dUB5t2+V89jpbwORdYUmRI0Y+n3A9M6ouw1+jq0YMak=; h=From:To:Cc:Subject:Date:In-Reply-To:References; b=VQi/57W+pb355TfV2dDwS51Z44Z8K6uaFBMmxONqNYWMlmvohPvUTFddtgabqg/oJ K5+RAqYMCFmgmbJMgszG/9mvXixbo6Wri4lgdOUXbRPyG/xIhaz5xusPrkcKGKm45t zLP5/X1rTwQYeJXsYEgqezi5cty0rwD8GOqkXb54= From: "W. Trevor King" To: Catalyst Cc: "W. Trevor King" Subject: [gentoo-catalyst] [PATCH v5] doc/HOWTO.txt: Fix stage descriptions, and add extra context Date: Fri, 20 Dec 2013 21:00:24 -0800 Message-Id: <912044f862302c1a55275f8cc269a3b3132cf033.1387601926.git.wking@tremily.us> X-Mailer: git-send-email 1.8.3.2 In-Reply-To: <69cf58e88de190d7308dd8f0c5523fd62c127eda.1387600437.git.wking@tremily.us> References: <69cf58e88de190d7308dd8f0c5523fd62c127eda.1387600437.git.wking@tremily.us> Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-catalyst@lists.gentoo.org Reply-to: gentoo-catalyst@lists.gentoo.org MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=comcast.net; s=q20121106; t=1387602028; bh=DlA10MwHVmBPZbEYZwejN0nfLtlLo5RpxWUgDRSaiCk=; h=Received:Received:Received:From:To:Subject:Date:Message-Id: MIME-Version:Content-Type; b=nJqVrttBteehMarP/Bd+lWg5s0LZbmmDdi/UapFXujBcjrQ9L463I947yZKtU3+Dv yN7iv/L2FM57fy1Gofgw3+u4rHbAidoDvUTqkBaAD/Q0iSd9BdctSqNO4LYY2YQAB0 orYTYOdJzSKO+39VSw7vzwT/ZJZfqzBeTh7JRoKUPEYI/t4mtmQw6ISRdXPO8IUvd0 aqCu56a2+qgzCQXze1jpkVf01Nuii9G7OowOw8DQGkIRc8bQwsHu//pxdBc/9hNKRg kp1s7wDlQKRteXW7EUbCsXddA4MecS+G590kXe+HL3bw9LZ1h9gT/nlCZgB2zJwW5S fHTVNOmAERBkA== X-Archives-Salt: 10de3a60-44f0-49bf-9ff8-e83572e3fe08 X-Archives-Hash: b21995bd3e439d9c655b4674f2f3f5bf From: "W. Trevor King" Thanks to Zero_Chaos, dwfreed, and jmbsvicetto for clarification and review on #gentoo-releng. --- Changes since v4: * List glibc in the packages.build excerpt * Mention that stage3 is an `emerge -e`, so stuff from stage2 is getting rebuilt. doc/HOWTO.txt | 34 +++++++++++++++++++++++++++++----- 1 file changed, 29 insertions(+), 5 deletions(-) diff --git a/doc/HOWTO.txt b/doc/HOWTO.txt index 5717f80..1573d59 100644 --- a/doc/HOWTO.txt +++ b/doc/HOWTO.txt @@ -136,11 +136,35 @@ compiled toolchain, which is where Gentoo's stages come in. The “base system” contains the necessary build tools and supporting infrastructure to get things going. The stages are: -1. System must be bootstrapped and the base system must be compiled - (a new toolchain built with external seed tools). -2. Stage1 + bootstrapped (a new toolchain build with stage1 tools). -3. Stage2 + base system compiled (the base system built with stage2 tools). -4. Stage3 + non-base packages. +[options="header",frame="topbot",grid="none"] +|======================================================================================= +| Source | Action | Result +| seed stage3 | Build packages listed in your profile's `packages.build` | stage1 +| stage1 | Rebuild the toolchain with the package tree's `bootstrap.sh` | stage2 +| stage2 | Compile the base `@system` packages | stage3 +| stage3 | Compile additional `@world` packages | stage4 +|======================================================================================= + +For stage1, Catalyst builds the stuff your profile says you need to +get started, using the tools in the seed stage3. It uses Portage's +ability to merge packages into an alternatively-rooted filesystem +(`/tmp/stage1root`, using `ROOT` in `make.conf`). This ensures that +only freshly-built packages end up in stage1. + +A fresh stage1 has newly-compiled versions of everything you need to +build a full system, but all of the stage1 binaries were built with +tools from the seed stage3. For stage2, Catalyst rebuilds a number of +critial packages (GCC, binutils, ...) using the `bootstrap.sh` script +distributed with the package tree. Rebuilding the packages using the +packages themselves (instead of the seed stage3 tools) gives an extra +layer of separation from any crazy output that the seed tooling may +have generated. + +Once we have a stage2, stages3 is a standard `emerge` of the base +system. The `@system` set of packages is defined by `packages` files +in your cascading profile. See +http://dev.gentoo.org/~ulm/pms/5/pms.html#x1-520005.2.6[the Package +Manager Specification] for details. For more details on the differences between the stages, look at the target helper scripts (e.g. `targets/stage1/*.sh`). -- 1.8.4