Gentoo Archives: gentoo-doc-cvs

From: Josh Saddler <nightmorph@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: gcc-upgrading.xml
Date: Thu, 31 Aug 2006 00:09:18
Message-Id: 20060831000858.3CAE76433A@smtp.gentoo.org
1 nightmorph 06/08/31 00:08:58
2
3 Modified: gcc-upgrading.xml
4 Log:
5 Updated gcc guide for bug 145014, thanks to amne for the updates
6
7 Revision Changes Path
8 1.14 xml/htdocs/doc/en/gcc-upgrading.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gcc-upgrading.xml?rev=1.14&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gcc-upgrading.xml?rev=1.14&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/gcc-upgrading.xml?r1=1.13&r2=1.14
13
14 Index: gcc-upgrading.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gcc-upgrading.xml,v
17 retrieving revision 1.13
18 retrieving revision 1.14
19 diff -u -r1.13 -r1.14
20 --- gcc-upgrading.xml 26 May 2006 20:45:35 -0000 1.13
21 +++ gcc-upgrading.xml 31 Aug 2006 00:08:57 -0000 1.14
22 @@ -1,5 +1,5 @@
23 <?xml version='1.0' encoding="UTF-8"?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gcc-upgrading.xml,v 1.13 2006/05/26 20:45:35 nightmorph Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gcc-upgrading.xml,v 1.14 2006/08/31 00:08:57 nightmorph Exp $ -->
26
27 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
28
29 @@ -25,8 +25,8 @@
30 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
31 <license/>
32
33 -<version>12</version>
34 -<date>2006-05-26</date>
35 +<version>13</version>
36 +<date>2006-08-30</date>
37
38 <chapter id="intro">
39 <title>Introduction</title>
40 @@ -107,18 +107,22 @@
41 <pre caption="Upgrading GCC">
42 # <i>emerge -uav gcc</i>
43
44 -<comment>(Please substitute "i686-pc-linux-gnu-3.4.5" with the GCC
45 +<comment>(Please substitute "i686-pc-linux-gnu-4.1.1" with the GCC
46 version and CHOST settings you've upgraded to:)</comment>
47 -# <i>gcc-config i686-pc-linux-gnu-3.4.5</i>
48 +# <i>gcc-config i686-pc-linux-gnu-4.1.1</i>
49 # <i>source /etc/profile</i>
50
51 +<comment>If you upgraded from gcc 3 to 4 (e.g. from 3.4.6 to 4.1.1 in this
52 +example) you will have to run fix_libtool_files.sh manually</comment>
53 +# <i>fix_libtool_files.sh 3.4.6</i>
54 +
55 <comment>(Rebuilding libtool)</comment>
56 # <i>emerge --oneshot -av libtool</i>
57 </pre>
58
59 <p>
60 -Now let's rebuild toolchain and then world so we will make use of the new
61 -compiler.
62 +To be completely safe that your system is in a sane state, you <e>must</e>
63 +rebuild the toolchain and then world to make use of the new compiler.
64 </p>
65
66 <pre caption="Rebuilding system">
67 @@ -129,11 +133,11 @@
68 <p>
69 It is safe to remove the older GCC version at this time. If you feel the need,
70 please issue the following command (as usual, substitute
71 -<c>=sys-devel/gcc-3.3*</c> with the version you want to uninstall):
72 +<c>=sys-devel/gcc-3.4*</c> with the version you want to uninstall):
73 </p>
74
75 <pre caption="Removing older GCC version">
76 -# <i>emerge -aC =sys-devel/gcc-3.3*</i>
77 +# <i>emerge -aC =sys-devel/gcc-3.4*</i>
78 </pre>
79
80 </body>
81 @@ -159,6 +163,11 @@
82 <body>
83
84 <impo>
85 +If you upgrade from gcc 3.4 to 4.1, please consult the General Update
86 +instructions.
87 +</impo>
88 +
89 +<impo>
90 If you're upgrading on a SPARC machine, you will have to take the way of
91 <uri link="#upgrade-3.3-to-3.4-emerge-e">complete system rebuild</uri> due to
92 some internal <uri link="http://gcc.gnu.org/gcc-3.4/sparc-abi.html">ABI
93 @@ -166,13 +175,16 @@
94 </impo>
95
96 <p>
97 -You have two possibilities on how to upgrade your system. The <uri
98 -link="#upgrade-3.3-to-3.4-revdep-rebuild">first method</uri> is faster and
99 -requires use of the <c>revdep-rebuild</c> tool from package <c>gentoolkit</c>
100 -while the <uri link="#upgrade-3.3-to-3.4-emerge-e">second one</uri> rebuilds the
101 -entire system from scratch so it will make use of new GCC features. It's up to
102 -you to decide which of these two ways you will choose. In most cases, the first
103 -method is sufficient.
104 +If you upgrade from gcc 3.3 to 3.4, you have two possibilities on how to
105 +upgrade your system. The <uri link="#upgrade-3.3-to-3.4-revdep-rebuild">first
106 +method</uri> is faster and requires use of the <c>revdep-rebuild</c> tool from
107 +package <c>gentoolkit</c> while the <uri
108 +link="#upgrade-3.3-to-3.4-emerge-e">second one</uri> rebuilds the entire
109 +system from scratch so it will make use of new GCC features. It's up to you to decide which of these two ways you will choose. In most cases, the first
110 +method is sufficient.</p>
111 +<p>If you upgrade from gcc 3.3 to 4.1, do not use the method based on
112 +revdep-rebuild, but do a <uri link="#upgrade-3.3-to-3.4-emerge-e">complete
113 +system rebuild</uri>.
114 </p>
115
116 </body>
117 @@ -249,6 +261,10 @@
118 # <i>gcc-config i686-pc-linux-gnu-3.4.5</i>
119 # <i>source /etc/profile</i>
120
121 +<comment>If you upgraded from gcc 3 to 4 (e.g. from 3.3.6 to 4.1.1 in this
122 +example) you will have to run fix_libtool_files.sh manually</comment>
123 +# <i>fix_libtool_files.sh 3.3.6</i>
124 +
125 <comment>(Rebuilding libtool)</comment>
126 # <i>emerge --oneshot -av libtool</i>
127 </pre>
128 @@ -428,8 +444,8 @@
129 <p>
130 Always use same GCC version for your kernel and additional kernel modules. Once
131 you rebuild your world with new GCC, external modules (like
132 -<c>app-emulation/qemu-softmmu</c>) will fail to load. Please rebuild your kernel
133 -with new GCC to fix that.
134 +<c>app-emulation/qemu-softmmu</c>) will fail to load. Please rebuild your
135 +kernel with the new GCC to fix that.
136 </p>
137
138 <p>
139 @@ -451,11 +467,11 @@
140 </p>
141
142 <p>
143 -If you see the <e>error: /usr/bin/gcc-config: line 632:
144 +If you see <e>error: /usr/bin/gcc-config: line 632:
145 /etc/env.d/gcc/i686-pc-linux-gnu-3.3.5: No such file or directory</e>, then try
146 deleting <path>/etc/env.d/gcc/config-i686-pc-linux-gnu</path> and running
147 -<c>gcc-config</c> again, followed by <c>source /etc/profile</c>. Only do this if
148 -you do not have any cross-compilers set up, though.
149 +<c>gcc-config</c> again, followed by <c>source /etc/profile</c>. Only do this
150 +if you do not have any cross-compilers set up, though.
151 </p>
152
153 <p>
154
155
156
157 --
158 gentoo-doc-cvs@g.o mailing list