Gentoo Archives: gentoo-commits

From: "Fabian Groffen (grobian)" <grobian@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/en/gentoo-alt/prefix: bootstrap-macos.xml
Date: Thu, 21 Feb 2008 17:13:42
Message-Id: E1JSEzL-0000d8-DQ@stork.gentoo.org
1 grobian 08/02/21 17:13:39
2
3 Modified: bootstrap-macos.xml
4 Log:
5 Capitalise occurrences of Prefix
6
7 Revision Changes Path
8 1.27 xml/htdocs/proj/en/gentoo-alt/prefix/bootstrap-macos.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/gentoo-alt/prefix/bootstrap-macos.xml?rev=1.27&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/gentoo-alt/prefix/bootstrap-macos.xml?rev=1.27&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/proj/en/gentoo-alt/prefix/bootstrap-macos.xml?r1=1.26&r2=1.27
13
14 Index: bootstrap-macos.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/gentoo-alt/prefix/bootstrap-macos.xml,v
17 retrieving revision 1.26
18 retrieving revision 1.27
19 diff -u -r1.26 -r1.27
20 --- bootstrap-macos.xml 21 Feb 2008 16:46:27 -0000 1.26
21 +++ bootstrap-macos.xml 21 Feb 2008 17:13:38 -0000 1.27
22 @@ -1,6 +1,6 @@
23 <?xml version="1.0" encoding="UTF-8"?>
24 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
25 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gentoo-alt/prefix/bootstrap-macos.xml,v 1.26 2008/02/21 16:46:27 grobian Exp $ -->
26 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/gentoo-alt/prefix/bootstrap-macos.xml,v 1.27 2008/02/21 17:13:38 grobian Exp $ -->
27
28 <guide link="/proj/en/gentoo-alt/prefix/bootstrap-macos.xml" lang="en">
29 <title>Gentoo Prefixed Portage Bootstrap Process for Mac OS X</title>
30 @@ -32,7 +32,7 @@
31 Apple Mac OS X was initially supported in the main Gentoo
32 portage tree with the ppc-macos keyword. The approach taken
33 then, however, resulted in too many problems, which was the
34 - drive behind creating prefixed portage.
35 + drive behind creating Prefixed Portage.
36 </p>
37 <p>
38 Bootstrapping on OS X is relatively simple, as the system
39 @@ -57,8 +57,8 @@
40 </p>
41 <p>
42 The first step is to choose a path to install into. We refer
43 - to this path as "prefix path", stored in the variable
44 - <c>EPREFIX</c>. Some suggestions for your prefix path are
45 + to this path as "Prefix path", stored in the variable
46 + <c>EPREFIX</c>. Some suggestions for your Prefix path are
47 <path>$HOME/Gentoo</path> or <path>$HOME/Library/Gentoo</path>.
48 Whatever you chose, make sure you set it in your environment:
49 </p>
50 @@ -70,7 +70,7 @@
51 instead.
52 </note>
53 <p>
54 - Next, add the following paths in your soon to be prefix to
55 + Next, add the following paths in your soon to be Prefix to
56 your <c>PATH</c> environment.
57 <path>$EPREFIX/bin</path>,
58 <path>$EPREFIX/usr/bin</path>,
59 @@ -79,7 +79,7 @@
60 Adding these paths makes sure that they will be available
61 later on in the process.
62 </p>
63 - <pre caption="Add prefix paths to your PATH">
64 + <pre caption="Add Prefix paths to your PATH">
65 $ <i>export PATH="$EPREFIX/usr/bin:$EPREFIX/bin:$EPREFIX/tmp/usr/bin:$EPREFIX/tmp/bin:$PATH"</i>
66 </pre>
67 <p>
68 @@ -141,18 +141,18 @@
69 </pre>
70 <p>
71 Next, we emerge the <c>bash</c> shell Portage heavily relies
72 - on. Since its dependencies cannot be compiled at this stage,
73 - we ignore those for the moment. The same holds for
74 - <c>wget</c> which we emerge at the same time.
75 + on. The same holds for <c>wget</c>, the download manager.
76 + Since its dependencies cannot be compiled at this stage,
77 + we ignore those for the moment.
78 </p>
79 <pre caption="emerge bash and wget">
80 -$ <i>emerge --oneshot --nodeps "&lt;bash-3.2_p33"</i>
81 +$ <i>emerge --oneshot "&lt;bash-3.2_p33"</i>
82 $ <i>emerge --oneshot --nodeps wget</i>
83 </pre>
84 <p>
85 - We continue getting more tools in our prefix. We no longer
86 + We continue getting more tools in our Prefix. We no longer
87 ignore dependencies, so a lot of packages will be emerged at
88 - this stage. Slowly our prefix gets more robust as we progress
89 + this stage. Slowly our Prefix gets more robust as we progress
90 here.
91 </p>
92 <pre caption="emerge several tools">
93 @@ -165,8 +165,10 @@
94 <p>
95 Now we have a good bunch of programs that Portage needs, we
96 can replace the bootstrapped Portage by a properly installed
97 - one, using portage itself. We need to temporarily tell
98 - Portage that the bootstrapped Portage can be overwritten.
99 + one, using portage itself. Also here a few dependencies are
100 + first emerged, such as the language Portage is written in:
101 + <c>python</c>. We need to temporarily tell Portage that the
102 + bootstrapped Portage can be overwritten.
103 </p>
104 <pre caption="emerge portage">
105 $ <i>env FEATURES="-collision-protect" emerge --oneshot portage</i>
106 @@ -191,7 +193,7 @@
107 </pre>
108 <p>
109 Before we do any further merges, we are going to update our
110 - tree. Since snapshots in prefix are actually (anonymous) SVN
111 + tree. Since snapshots in Prefix are actually (anonymous) SVN
112 checkouts of the tree, we need <c>subversion</c> to update it.
113 </p>
114 <pre caption="emerge subversion">
115 @@ -207,15 +209,15 @@
116 $ <i>emerge --sync</i>
117 </pre>
118 <note>
119 - The prefix portage tree assumes a <e>case-sensitive
120 + The Prefix Portage tree assumes a <e>case-sensitive
121 filesystem</e>. Mac OS X doesn't use this by default. If
122 you experience weird errors while updating or checking out
123 - the prefix tree with subversion, check if your filesystem is
124 + the Prefix tree with subversion, check if your filesystem is
125 case-sensitive.
126 </note>
127 <p>
128 Next, we let Portage emerge all packages that complete a
129 - system install that we eventually need to finalise this prefix
130 + system install that we eventually need to finalise this Prefix
131 installation.
132 </p>
133 <pre caption="emerge system">
134 @@ -223,13 +225,13 @@
135 </pre>
136 <p>
137 Now is a good time to set the preferences for our soon to be
138 - prefix. This includes customisations such as general
139 + Prefix. This includes customisations such as general
140 <c>USE</c>-flags, <c>CFLAGS</c> and <c>MAKEOPTS</c> in
141 <path>$EPREFIX/etc/make.conf</path>. Be conservative with
142 <c>CFLAGS</c>! Note that the code below is an example, and is
143 meant for inspiration only.
144 </p>
145 - <pre caption="Customising the prefix installation - example">
146 + <pre caption="Customising the Prefix installation - example">
147 $ <i>echo 'USE="unicode nls"' >> $EPREFIX/etc/make.conf</i>
148 $ <i>echo 'CFLAGS="-O2 -pipe &lt;my-cpu-flags&gt;"' >> $EPREFIX/etc/make.conf</i>
149 $ <i>echo 'CXXFLAGS="${CFLAGS}"' >> $EPREFIX/etc/make.conf</i>
150 @@ -247,9 +249,9 @@
151 <p>
152 Since we have everything in place for a self-catered rebuild,
153 we can unset all hacks we made to help the bootstrap process,
154 - and start the final stage to install the prefix system. This
155 + and start the final stage to install the Prefix system. This
156 final stage recompiles everything in the system, but now all
157 - packages can be compiled with tools from the prefix, instead
158 + packages can be compiled with tools from the Prefix, instead
159 of those from the host system.
160 </p>
161 <pre caption="Unsetting LDFLAGS and CPPFLAGS variables">
162 @@ -262,9 +264,9 @@
163 <c>CPPFLAGS</c>.
164 </note>
165 <p>
166 - After <c>system</c> has emerged successfully, your prefix will
167 + After <c>system</c> has emerged successfully, your Prefix will
168 be set up properly, and you can emerge the whichever tools you
169 - choose from the prefix tree.
170 + choose from the Prefix tree.
171 </p>
172 </body>
173 </section><!-- }}} -->
174 @@ -273,8 +275,8 @@
175 <title>Using the Prefix</title>
176 <body>
177 <p>
178 - To use your bootstrapped prefix environment, you best start a
179 - shell from the prefix, such that your path and other
180 + To use your bootstrapped Prefix environment, you best start a
181 + shell from the Prefix, such that your path and other
182 environment variables are set correctly. To facilitate in
183 this, a small helper script can be created by the bootstrap
184 script.
185 @@ -287,8 +289,8 @@
186 After running this, a script <c>startprefix</c> will be
187 present in <c>$EPREFIX</c>. You can freely move the script to
188 e.g. your homedir for convenience. Running the script will
189 - drop you into a prefix shell, where for example <c>emerge</c>
190 - is directly at your disposal. Enjoy your prefix!
191 + drop you into a Prefix shell, where for example <c>emerge</c>
192 + is directly at your disposal. Enjoy your Prefix!
193 </p>
194 </body>
195 </section>
196
197
198
199 --
200 gentoo-commits@l.g.o mailing list