Attachment 13178 Details for Bug 22711 – Diff of old/new guides

[patch] Diff of old/new guides

stage.diff (text/plain), 7.00 KB, created by Jon Portnoy (RETIRED) on 2003-06-12 17:58:31 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Jon Portnoy (RETIRED)

Created: 2003-06-12 17:58:31 UTC

Size: 7.00 KB

patch

obsolete

>--- /home/avenj/gentoo/build/gentoo/xml/htdocs/doc/en/stage-building-guide.xml	2003-03-05 11:18:51.000000000 -0500
>+++ stage-building-guide.xml	2003-06-12 20:54:07.000000000 -0400
>@@ -2,30 +2,24 @@
> <?xml-stylesheet href="/xsl/guide.xsl" type="text/xsl"?>
> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
> 
>-<guide link="/doc/en/grp-build.xml">
>+<guide link="/doc/en/stage-building-guide.xml">
> 
>-<author title = "Author">
>-<mail link = "zhen@gentoo.org">John P. Davis</mail></author>
>+<author title = "Author"><mail link = "zhen@gentoo.org">John P. Davis</mail></author>
>+<author title = "Author"><mail link = "avenj@gentoo.org">Jon Portnoy</mail></author>
> 
>-<version>1.0</version>
>-<date>18 Feb 2003</date>
>+<version>1.1</version>
>+<date>12 Jun 2003</date>
> 
>-<abstract>This guide is an explanation on how to build GRP stages for
>-Gentoo Linux releases.</abstract>
>+<abstract>This guide is an explanation on how to build stages for
>+Gentoo Linux.</abstract>
> 
> <chapter>
> 	<title>Preliminaries</title>
> 	<section>
> 		<title>Introduction</title>
> 		<body>
>-		This guide is an explanation on how to build release-ready
>-		GRP stages for Gentoo Linux. This guide assumes a couple of
>-		things: 
>-
>-		<ul>
>-		<li>You are a Gentoo Linux Developer.</li>
>-		<li>You have access to the gentoo-src module of CVS.</li>
>-		</ul>
>+		This guide is an explanation on how to build fresh
>+		stages for Gentoo Linux using stager, our stage-building application.
> 
> 	</body>
> 	</section>
>@@ -35,9 +29,11 @@
> 		Before building anything, it is necessary to get the required source, tools, etc.
> 		First of all, make sure that you have the gentoo-src module checked out of CVS
> 		and that it is up to date. The build scripts change frequently, so make sure that you stay current.
>+		If you do not have access to the gentoo-src module, a snapshot of stager can be found at
>+		<uri>http://cvs.gentoo.org/~avenj/stager/</uri>.
> 		Additionally, the most recent experimental stage1 tarball is 
>-		required. This can
>-		usually be found at <uri>http://www.ibiblio.org/gentoo/experimental/x86/stages</uri>. The tarball that you will be looking for is stage1-x86-1.4_preDATE.tar.bz2, where DATE is the most current date possible. 
>+		required. This can usually be found at <path>experimental/x86/stages</path> on any Gentoo mirror. The tarball that you will be looking for is 
>+		stage1-x86-1.4_preDATE.tar.bz2, where DATE is the most recent date available. 
> 		
> 		
> 		</body>
>@@ -49,63 +45,55 @@
> 	<section>
> 		<title>First Steps</title>
> 		<body>
>-		First, create a directory on a nice big partition to hold all of the build stuffs. I created mine
>-		in <path>/usr/src/grp</path>, but of course, yours can be different. Next, copy the <path>stager</path>
>+		First, create a directory on a nice big partition to hold all of the build files. Next, copy the <path>stager</path>
> 		directory from gentoo-src into this new
>-		directory. Finially, create a directory inside of the <path>grp/stager</path> drive called stages
>+		directory (which will be referred to as <path>/usr/src/build</path> in this document). Alternatively, extract the tarball of the snapshot into this directory. 
>+		Finially, create a directory inside <path>/usr/src/build</path> called stages
> 		and put the experimental stage1 tarball in there.
> 		
> 
> 		<pre caption="Getting Ready">
>-# <c>mkdir /usr/src/grp </c>
>-<codenote>You can change the above drive to whatever you want, but I will
>-reference it as what I have written.
>-</codenote>
>-
>-# <c>cp -R /<comment>path-to-gentoo-src</comment>/stager/ /usr/src/grp </c>
>-# <c>cd /usr/src/grp/stager; mkdir stages </c>
>-# <c>mv stage1-x86-1.4_pre20030214.tar.bz2 /usr/src/grp/stager/stages </c>
>+# <c>mkdir /usr/src/build </c>
>+<codenote>You can change the above path to whatever you want.</codenote>
>+
>+# <c>cp -R /gentoo-src/stager/ /usr/src/build</c>
>+# <c>cd /usr/src/build/stager ; mkdir stages</c>
>+# <c>mv stage1-x86-1.4_preDATE.tar.bz2 /usr/src/build/stager/stages</c>
> 
> 		</pre>
> 
> 		</body>
> 	</section>
> 
>+
> 	<section>
>-		<title>Pre-Build Configuration</title>
>+		<title>Building</title>
> 		<body>
>-		Once everything is in the correct place, modify the <c>dostage.sh</c> script to fit your application.
>+		First, we need to build a stage2 tarball that uses generic optimizations. This tarball
>+		will be used to build any new fresh stages, including a fresh stage1.
> 		
> 
>-		<pre caption="Modifying the dostage.sh script">
>-<codenote>change SOURCE to stage1-x86-1.4_preFOO</codenote>
>-SOURCE=stage1-x86-1.4_pre20030214.tar.bz2
>-<codenote>You can change DEST to whatever you desire, but for testing, it is easier to keep it
>-the same as SOURCE</codenote>
>-DEST=stage1-x86-1.4_pre20030214.tar.bz2
>+		<pre caption="Building stage2">
>+# <c>./stager x86 2 orig dest</c>
>+<codenote>Above, orig refers to the date in the name of the experimental tarball. Dest refers to the date of the new tarball. Replace these accordingly.</codenote>		
> 		</pre>
> 
>-		After that is complete, make sure to change the m/arch in the for loop to match your architecture.
>+		Once this build finishes, you should now have a fresh stage2 tarball alongside your original stage1 tarball in the <path>stages</path>
>+		directory. Now you can build a new stage1 from your stage2 using basically the same method:
> 		
> 
>-		</body>
>-	</section>
>-
>-	<section>
>-		<title>Build!</title>
>-		<body>
>+		<pre caption="Building new stage1">
>+# <c>./stager x86 1 dest dest</c>
>+		</pre>
> 
>-		Make sure that you are root, and run <c>dostage.sh</c>. The script will take care of creating
>-		the chroot environment, and it will build all of the stages for you.
>-		
>+		Tada - you've built a fresh stage1 alongside your original stage1 and new stage2. Now you can build non-generic tarballs that are
>+		optimized for specific CPU sub-types. Be warned that these optimized tarballs cannot be used to build other stages. Only
>+		generic tarballs should be used to build other stages. Building for other sub-types is the same - merely replace x86 with the specific sub-type.
>+		For a list of subtypes, execute stager without any arguments.
> 
>-		After the build completes, remove the <path>packages</path> and <path>build</path> directories
>-		from under the stages directory so that you don't get any precompiled packages for a
>-		different arch in your next build.
>-		
>-		
> 		</body>
> 	</section>
>+
> </chapter>
> 
> <chapter>
>@@ -120,16 +108,20 @@
> 			<th>Function</th>
> 		</tr>
> 		<tr>
>-			<ti><mail link="bcowan@gentoo.org">Brad Cowan</mail></ti>
>+			<ti><mail link="avenj@gentoo.org">Jon Portnoy</mail></ti>
> 			<ti>Gentoo Linux Release Manager</ti>
> 		</tr>
> 		<tr>
> 			<ti><mail link="jhhudso@gentoo.org">Jared Hudson</mail></ti>
>-			<ti>Stage Builds</ti>
>+			<ti>Release quality assurance</ti>
> 		</tr>
> 		<tr>
> 			<ti><mail link="zhen@gentoo.org">John Davis</mail></ti>
>-			<ti>Documentation Coordinator/ Author</ti>
>+			<ti>Author</ti>
>+		</tr>
>+		<tr>
>+			<ti><mail link="avenj@gentoo.org">Jon Portnoy</mail></ti>
>+			<ti>Author</ti>
> 		</tr>
> 		</table>
>

Actions: View | Diff

Attachments on bug 22711: 13177 | 13178