Gentoo Archives: gentoo-commits

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-commits@l.g.o
Subject: [gentoo-commits] gentoo commit in xml/htdocs/proj/en/base/embedded/handbook: boards-arm-efikamx.xml boards-arm-nailboard.xml boards-arm-netusg20.xml boards-arm-netwinder.xml boards-arm-nslu2.xml boards-arm-sheevaplug.xml boards-sh-lantank.xml bootloaders-das-u-boot.xml bootloaders-nettrom.xml bootloaders-redboot.xml bootloaders-sh-lilo.xml communication.xml contributing.xml cross-compiler.xml cross-compiling-kernel.xml cross-qemu.xml emu-armulator.xml emu-hercules.xml emu-qemu.xml emu-skyeye.xml emu-softgun.xml faq.xml intro.xml the-more-you-know.xml tuples.xml vendors.xml
Date: Mon, 30 Aug 2010 03:59:20
Message-Id: 20100830035907.580052004C@flycatcher.gentoo.org
1 nightmorph 10/08/30 03:59:07
2
3 Modified: boards-arm-efikamx.xml boards-arm-nailboard.xml
4 boards-arm-netusg20.xml boards-arm-netwinder.xml
5 boards-arm-nslu2.xml boards-arm-sheevaplug.xml
6 boards-sh-lantank.xml bootloaders-das-u-boot.xml
7 bootloaders-nettrom.xml bootloaders-redboot.xml
8 bootloaders-sh-lilo.xml communication.xml
9 contributing.xml cross-compiler.xml
10 cross-compiling-kernel.xml cross-qemu.xml
11 emu-armulator.xml emu-hercules.xml emu-qemu.xml
12 emu-skyeye.xml emu-softgun.xml faq.xml intro.xml
13 the-more-you-know.xml tuples.xml vendors.xml
14 Log:
15 massive cleanup: fix required licenses, fix guideXML code
16
17 Revision Changes Path
18 1.2 xml/htdocs/proj/en/base/embedded/handbook/boards-arm-efikamx.xml
19
20 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-efikamx.xml?rev=1.2&view=markup
21 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-efikamx.xml?rev=1.2&content-type=text/plain
22 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-efikamx.xml?r1=1.1&r2=1.2
23
24 Index: boards-arm-efikamx.xml
25 ===================================================================
26 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-efikamx.xml,v
27 retrieving revision 1.1
28 retrieving revision 1.2
29 diff -u -r1.1 -r1.2
30 --- boards-arm-efikamx.xml 10 Dec 2009 16:41:08 -0000 1.1
31 +++ boards-arm-efikamx.xml 30 Aug 2010 03:59:06 -0000 1.2
32 @@ -1,7 +1,10 @@
33 <?xml version='1.0' encoding='UTF-8'?>
34 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
35
36 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-efikamx.xml,v 1.1 2009/12/10 16:41:08 armin76 Exp $ -->
37 +<!-- The content of this document is licensed under the CC-BY-SA license -->
38 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
39 +
40 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-efikamx.xml,v 1.2 2010/08/30 03:59:06 nightmorph Exp $ -->
41
42 <sections>
43
44
45
46
47 1.10 xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nailboard.xml
48
49 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nailboard.xml?rev=1.10&view=markup
50 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nailboard.xml?rev=1.10&content-type=text/plain
51 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nailboard.xml?r1=1.9&r2=1.10
52
53 Index: boards-arm-nailboard.xml
54 ===================================================================
55 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nailboard.xml,v
56 retrieving revision 1.9
57 retrieving revision 1.10
58 diff -u -r1.9 -r1.10
59 --- boards-arm-nailboard.xml 4 Mar 2010 19:53:53 -0000 1.9
60 +++ boards-arm-nailboard.xml 30 Aug 2010 03:59:06 -0000 1.10
61 @@ -1,7 +1,10 @@
62 <?xml version='1.0' encoding='UTF-8'?>
63 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
64
65 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nailboard.xml,v 1.9 2010/03/04 19:53:53 solar Exp $ -->
66 +<!-- The content of this document is licensed under the CC-BY-SA license -->
67 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
68 +
69 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nailboard.xml,v 1.10 2010/08/30 03:59:06 nightmorph Exp $ -->
70
71 <sections>
72
73
74
75
76 1.2 xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netusg20.xml
77
78 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netusg20.xml?rev=1.2&view=markup
79 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netusg20.xml?rev=1.2&content-type=text/plain
80 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netusg20.xml?r1=1.1&r2=1.2
81
82 Index: boards-arm-netusg20.xml
83 ===================================================================
84 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netusg20.xml,v
85 retrieving revision 1.1
86 retrieving revision 1.2
87 diff -u -r1.1 -r1.2
88 --- boards-arm-netusg20.xml 1 Nov 2009 22:13:16 -0000 1.1
89 +++ boards-arm-netusg20.xml 30 Aug 2010 03:59:06 -0000 1.2
90 @@ -1,7 +1,10 @@
91 <?xml version='1.0' encoding='UTF-8'?>
92 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
93
94 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netusg20.xml,v 1.1 2009/11/01 22:13:16 miknix Exp $ -->
95 +<!-- The content of this document is licensed under the CC-BY-SA license -->
96 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
97 +
98 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netusg20.xml,v 1.2 2010/08/30 03:59:06 nightmorph Exp $ -->
99 <!-- Based on boards-arm-sheevaplug.xml -->
100
101 <sections>
102 @@ -16,6 +19,7 @@
103 <section>
104 <title>Gentoo documentation</title>
105 <body>
106 +
107 <p>
108 The <uri link="http://netus.acmesystems.it/doku.php">Netus G20</uri> is
109 a 4x4cm Linux ready core engine based on the Atmel(TM) AT91SAM9G20 (ARMv5TE)
110 @@ -24,12 +28,14 @@
111 <uri link="http://netus.kdev.it">Davide Cantaluppi</uri> who maintains it.
112 In fact, Gentoo is the default OS shipped with this device.
113 </p>
114 +
115 </body>
116 </section>
117
118 <section>
119 <title>ACME SYSTEMS Netus G20 specifications</title>
120 <body>
121 +
122 <pre caption="Board Specifications">
123 # CPU <uri link="http://www.atmel.com/dyn/products/product_card.asp?part_id=4337">Atmel AT91SAM9G20</uri> based on ARM926EJ-S with clock speed of 400MHz.
124 # 64MBytes of SDRAM with 32bit access.
125 @@ -59,12 +65,14 @@
126 # Real-time clock (optional external battery backup).
127 # Very Slow Clock Operating Mode.
128 </pre>
129 +
130 </body>
131 </section>
132
133 <section>
134 <title>/proc/cpuinfo</title>
135 <body>
136 +
137 <pre caption="CPU Info">
138 netusg20 / # cat /proc/cpuinfo
139 Processor : ARM926EJ-S rev 5 (v5l)
140 @@ -80,12 +88,14 @@
141 Revision : 0000
142 Serial : 0000000000000000
143 </pre>
144 +
145 </body>
146 </section>
147
148 <section>
149 <title>dmesg</title>
150 <body>
151 +
152 <pre caption="Kernel messages">
153 Linux version 2.6.31-gentooGentooNETUSembedded (root@localhost) (gcc version
154 4.3.3 (Gentoo 4.3.3 p1.0, pie-10.1.5) ) #29 Fri Oct 16 12:00:28 CEST 2009
155 @@ -230,17 +240,21 @@
156 eth0: link up (100/Full)
157 eth0: no IPv6 routers present
158 </pre>
159 +
160 </body>
161 </section>
162
163 <section>
164 <title>References:</title>
165 <body>
166 +
167 <ul>
168 -<li>
169 -<uri link="http://netus.acmesystems.it/doku.php">ACME SYSTEMS Netus G20</uri>
170 -</li>
171 + <li>
172 + <uri link="http://netus.acmesystems.it/doku.php">ACME SYSTEMS Netus
173 + G20</uri>
174 + </li>
175 </ul>
176 +
177 </body>
178 </section>
179
180
181
182
183 1.4 xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netwinder.xml
184
185 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netwinder.xml?rev=1.4&view=markup
186 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netwinder.xml?rev=1.4&content-type=text/plain
187 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netwinder.xml?r1=1.3&r2=1.4
188
189 Index: boards-arm-netwinder.xml
190 ===================================================================
191 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netwinder.xml,v
192 retrieving revision 1.3
193 retrieving revision 1.4
194 diff -u -r1.3 -r1.4
195 --- boards-arm-netwinder.xml 27 Sep 2009 10:17:46 -0000 1.3
196 +++ boards-arm-netwinder.xml 30 Aug 2010 03:59:06 -0000 1.4
197 @@ -1,7 +1,10 @@
198 <?xml version='1.0' encoding='UTF-8'?>
199 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
200
201 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netwinder.xml,v 1.3 2009/09/27 10:17:46 armin76 Exp $ -->
202 +<!-- The content of this document is licensed under the CC-BY-SA license -->
203 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
204 +
205 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-netwinder.xml,v 1.4 2010/08/30 03:59:06 nightmorph Exp $ -->
206
207 <sections>
208
209 @@ -15,6 +18,7 @@
210 <section>
211 <title>Rebel NetWinder</title>
212 <body>
213 +
214 <pre caption="Board Specifications">
215 # DEC/Intel StrongARM 110 processor, ~233MHz
216 # DEC/Intel 21285 FootBridge chipset
217 @@ -26,12 +30,14 @@
218 # 1x WinBond 940 10BaseT Ethernet controller
219 # 1x Digital 21143(Tulip) 10/100BaseT Ethernet controller
220 </pre>
221 +
222 </body>
223 </section>
224
225 <section>
226 <title>/proc/cpuinfo</title>
227 <body>
228 +
229 <pre caption="CPU Info">
230 Processor : StrongARM-110 rev 4 (v4l)
231 BogoMIPS : 185.54
232 @@ -46,6 +52,7 @@
233 Revision : 59ff
234 Serial : 0000000000000000
235 </pre>
236 +
237 </body>
238 </section>
239
240 @@ -53,9 +60,10 @@
241 <section>
242 <title>Cross Compile Preparation</title>
243 <body>
244 +
245 <pre caption="Setup">
246 -emerge crossdev
247 -crossdev armv4l-unknown-linux-gnu
248 +# <i>emerge crossdev</i>
249 +# <i>crossdev armv4l-unknown-linux-gnu</i>
250 </pre>
251
252 <pre caption="Emerge Wrapper (netwinder-merge)">
253 @@ -100,7 +108,6 @@
254 </pre>
255
256 <pre caption="/usr/armv4l-unknown-linux-gnu/etc/make.conf">
257 -#
258 CHOST=armv4l-unknown-linux-gnu
259 CBUILD=x86_64-pc-linux-gnu
260 ARCH="arm"
261 @@ -141,9 +148,11 @@
262 <section>
263 <title>References:</title>
264 <body>
265 +
266 <ul>
267 - <li><uri link="http://www.netwinder.org">NetWinder.org</uri></li>
268 + <li><uri link="http://www.netwinder.org">NetWinder.org</uri></li>
269 </ul>
270 +
271 </body>
272 </section>
273
274
275
276
277 1.2 xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nslu2.xml
278
279 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nslu2.xml?rev=1.2&view=markup
280 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nslu2.xml?rev=1.2&content-type=text/plain
281 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nslu2.xml?r1=1.1&r2=1.2
282
283 Index: boards-arm-nslu2.xml
284 ===================================================================
285 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nslu2.xml,v
286 retrieving revision 1.1
287 retrieving revision 1.2
288 diff -u -r1.1 -r1.2
289 --- boards-arm-nslu2.xml 26 Aug 2007 13:16:26 -0000 1.1
290 +++ boards-arm-nslu2.xml 30 Aug 2010 03:59:06 -0000 1.2
291 @@ -1,7 +1,10 @@
292 <?xml version='1.0' encoding='UTF-8'?>
293 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
294
295 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nslu2.xml,v 1.1 2007/08/26 13:16:26 vapier Exp $ -->
296 +<!-- The content of this document is licensed under the CC-BY-SA license -->
297 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
298 +
299 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-nslu2.xml,v 1.2 2010/08/30 03:59:06 nightmorph Exp $ -->
300
301 <sections>
302
303 @@ -15,8 +18,11 @@
304 <section>
305 <title>Usage</title>
306 <body>
307 +
308 <p>
309 +TODO
310 </p>
311 +
312 </body>
313 </section>
314
315
316
317
318 1.3 xml/htdocs/proj/en/base/embedded/handbook/boards-arm-sheevaplug.xml
319
320 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-sheevaplug.xml?rev=1.3&view=markup
321 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-sheevaplug.xml?rev=1.3&content-type=text/plain
322 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-sheevaplug.xml?r1=1.2&r2=1.3
323
324 Index: boards-arm-sheevaplug.xml
325 ===================================================================
326 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-sheevaplug.xml,v
327 retrieving revision 1.2
328 retrieving revision 1.3
329 diff -u -r1.2 -r1.3
330 --- boards-arm-sheevaplug.xml 10 Dec 2009 16:41:08 -0000 1.2
331 +++ boards-arm-sheevaplug.xml 30 Aug 2010 03:59:06 -0000 1.3
332 @@ -1,7 +1,10 @@
333 <?xml version='1.0' encoding='UTF-8'?>
334 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
335
336 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-sheevaplug.xml,v 1.2 2009/12/10 16:41:08 armin76 Exp $ -->
337 +<!-- The content of this document is licensed under the CC-BY-SA license -->
338 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
339 +
340 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-arm-sheevaplug.xml,v 1.3 2010/08/30 03:59:06 nightmorph Exp $ -->
341
342 <sections>
343
344 @@ -15,20 +18,28 @@
345 <section>
346 <title>Gentoo documentation</title>
347 <body>
348 +
349 <p>
350 -Currently, the Marvell Sheevaplug is supported on Gentoo thanks to
351 -<uri link="http://www.marvell.com">Marvell</uri> who provided us with hardware to create and document the
352 -installation process.
353 +Currently, the Marvell Sheevaplug is supported on Gentoo thanks to <uri
354 +link="http://www.marvell.com">Marvell</uri> who provided us with hardware to
355 +create and document the installation process.
356 </p>
357 +
358 <ul>
359 - <li><uri link="http://dev.gentoo.org/~armin76/arm/sheevaplug/install.xml">Documentation about installing Gentoo on the Marvell Sheevaplug</uri></li>
360 + <li>
361 + <uri
362 + link="http://dev.gentoo.org/~armin76/arm/sheevaplug/install.xml">Documentation
363 + about installing Gentoo on the Marvell Sheevaplug</uri>
364 + </li>
365 </ul>
366 +
367 </body>
368 </section>
369
370 <section>
371 <title>Marvell Sheevaplug specifications</title>
372 <body>
373 +
374 <pre caption="Board Specifications">
375 # Marvell Kirkwood SoC 88F6281
376 # Marvell Feroceon ARMv5TE 1200MHz processor
377 @@ -40,12 +51,14 @@
378 # 1x mini-USB 2.0 port (for integrated JTAG and serial access)
379 # Reset button
380 </pre>
381 +
382 </body>
383 </section>
384
385 <section>
386 <title>/proc/cpuinfo</title>
387 <body>
388 +
389 <pre caption="CPU Info">
390 Processor : Feroceon 88FR131 rev 1 (v5l)
391 BogoMIPS : 1192.75
392 @@ -60,15 +73,21 @@
393 Revision : 0000
394 Serial : 0000000000000000
395 </pre>
396 +
397 </body>
398 </section>
399 +
400 <section>
401 <title>References:</title>
402 <body>
403 +
404 <ul>
405 - <li><uri link="http://www.marvell.com">Marvell</uri></li>
406 - <li><uri link="http://www.openplug.org">Marvell's Sheevaplug community</uri></li>
407 + <li><uri link="http://www.marvell.com">Marvell</uri></li>
408 + <li>
409 + <uri link="http://www.openplug.org">Marvell's Sheevaplug community</uri>
410 + </li>
411 </ul>
412 +
413 </body>
414 </section>
415
416
417
418
419 1.3 xml/htdocs/proj/en/base/embedded/handbook/boards-sh-lantank.xml
420
421 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-sh-lantank.xml?rev=1.3&view=markup
422 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-sh-lantank.xml?rev=1.3&content-type=text/plain
423 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-sh-lantank.xml?r1=1.2&r2=1.3
424
425 Index: boards-sh-lantank.xml
426 ===================================================================
427 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-sh-lantank.xml,v
428 retrieving revision 1.2
429 retrieving revision 1.3
430 diff -u -r1.2 -r1.3
431 --- boards-sh-lantank.xml 6 Jan 2009 12:05:23 -0000 1.2
432 +++ boards-sh-lantank.xml 30 Aug 2010 03:59:06 -0000 1.3
433 @@ -1,7 +1,10 @@
434 <?xml version='1.0' encoding='UTF-8'?>
435 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
436
437 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-sh-lantank.xml,v 1.2 2009/01/06 12:05:23 armin76 Exp $ -->
438 +<!-- The content of this document is licensed under the CC-BY-SA license -->
439 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
440 +
441 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/boards-sh-lantank.xml,v 1.3 2010/08/30 03:59:06 nightmorph Exp $ -->
442
443 <sections>
444
445 @@ -15,6 +18,7 @@
446 <section>
447 <title>IO-Data LANTANK Specifications:</title>
448 <body>
449 +
450 <pre caption="Board Specifications">
451 # SH4 SH7751 processor, ~266MHz
452 # 64MB RAM
453 @@ -22,11 +26,14 @@
454 # 10/100Mbit Realtek 8139C+ Ethernet controller
455 # 2x NEC USB 2.0
456 </pre>
457 +
458 </body>
459 </section>
460 +
461 <section>
462 <title>/proc/cpuinfo</title>
463 <body>
464 +
465 <pre caption="CPU Info">
466 machine : LANDISK
467 processor : 0
468 @@ -43,16 +50,17 @@
469 cpu_clk : 266.66MHz
470 tmu0_clk : 8.33MHz
471 </pre>
472 +
473 </body>
474 </section>
475
476 -
477 <section>
478 <title>Cross Compile Preparation</title>
479 <body>
480 +
481 <pre caption="Setup">
482 -emerge crossdev
483 -crossdev sh4-unknown-linux-gnu
484 +# <i>emerge crossdev</i>
485 +# <i>crossdev sh4-unknown-linux-gnu</i>
486 </pre>
487
488 <pre caption="Emerge Wrapper (lantank-merge)">
489 @@ -97,7 +105,6 @@
490 </pre>
491
492 <pre caption="/usr/sh4-unknown-linux-gnu/etc/make.conf">
493 -#
494 CHOST=sh4-unknown-linux-gnu
495 CBUILD=x86_64-pc-linux-gnu
496 ARCH="sh"
497 @@ -138,9 +145,14 @@
498 <section>
499 <title>References:</title>
500 <body>
501 +
502 <ul>
503 - <li><uri link="http://dev.gentoo.org/~vapier/superh/lantank/">Mike Frysinger's page about the LANTANK</uri></li>
504 + <li>
505 + <uri link="http://dev.gentoo.org/~vapier/superh/lantank/">Mike Frysinger's
506 + page about the LANTANK</uri>
507 + </li>
508 </ul>
509 +
510 </body>
511 </section>
512
513
514
515
516 1.4 xml/htdocs/proj/en/base/embedded/handbook/bootloaders-das-u-boot.xml
517
518 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-das-u-boot.xml?rev=1.4&view=markup
519 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-das-u-boot.xml?rev=1.4&content-type=text/plain
520 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-das-u-boot.xml?r1=1.3&r2=1.4
521
522 Index: bootloaders-das-u-boot.xml
523 ===================================================================
524 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-das-u-boot.xml,v
525 retrieving revision 1.3
526 retrieving revision 1.4
527 diff -u -r1.3 -r1.4
528 --- bootloaders-das-u-boot.xml 5 May 2008 06:56:36 -0000 1.3
529 +++ bootloaders-das-u-boot.xml 30 Aug 2010 03:59:06 -0000 1.4
530 @@ -1,7 +1,10 @@
531 <?xml version='1.0' encoding='UTF-8'?>
532 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
533
534 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-das-u-boot.xml,v 1.3 2008/05/05 06:56:36 vapier Exp $ -->
535 +<!-- The content of this document is licensed under the CC-BY-SA license -->
536 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
537 +
538 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-das-u-boot.xml,v 1.4 2010/08/30 03:59:06 nightmorph Exp $ -->
539
540 <sections>
541
542 @@ -15,11 +18,13 @@
543 <section>
544 <title>Usage</title>
545 <body>
546 +
547 <p>
548 Rather than duplicate existing information, please consult the upstream
549 <uri link="http://www.denx.de/wiki/UBoot/Documentation">documentation</uri>
550 and their main <uri link="http://www.denx.de/wiki/view/DULG/UBoot">wiki</uri>.
551 </p>
552 +
553 </body>
554 </section>
555
556
557
558
559 1.2 xml/htdocs/proj/en/base/embedded/handbook/bootloaders-nettrom.xml
560
561 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-nettrom.xml?rev=1.2&view=markup
562 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-nettrom.xml?rev=1.2&content-type=text/plain
563 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-nettrom.xml?r1=1.1&r2=1.2
564
565 Index: bootloaders-nettrom.xml
566 ===================================================================
567 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-nettrom.xml,v
568 retrieving revision 1.1
569 retrieving revision 1.2
570 diff -u -r1.1 -r1.2
571 --- bootloaders-nettrom.xml 26 Aug 2007 13:16:26 -0000 1.1
572 +++ bootloaders-nettrom.xml 30 Aug 2010 03:59:06 -0000 1.2
573 @@ -1,7 +1,10 @@
574 <?xml version='1.0' encoding='UTF-8'?>
575 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
576
577 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-nettrom.xml,v 1.1 2007/08/26 13:16:26 vapier Exp $ -->
578 +<!-- The content of this document is licensed under the CC-BY-SA license -->
579 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
580 +
581 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-nettrom.xml,v 1.2 2010/08/30 03:59:06 nightmorph Exp $ -->
582
583 <sections>
584
585 @@ -15,8 +18,11 @@
586 <section>
587 <title>Usage</title>
588 <body>
589 +
590 <p>
591 +TODO
592 </p>
593 +
594 </body>
595 </section>
596
597
598
599
600 1.2 xml/htdocs/proj/en/base/embedded/handbook/bootloaders-redboot.xml
601
602 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-redboot.xml?rev=1.2&view=markup
603 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-redboot.xml?rev=1.2&content-type=text/plain
604 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-redboot.xml?r1=1.1&r2=1.2
605
606 Index: bootloaders-redboot.xml
607 ===================================================================
608 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-redboot.xml,v
609 retrieving revision 1.1
610 retrieving revision 1.2
611 diff -u -r1.1 -r1.2
612 --- bootloaders-redboot.xml 26 Aug 2007 13:16:26 -0000 1.1
613 +++ bootloaders-redboot.xml 30 Aug 2010 03:59:06 -0000 1.2
614 @@ -1,12 +1,16 @@
615 <?xml version='1.0' encoding='UTF-8'?>
616 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
617
618 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-redboot.xml,v 1.1 2007/08/26 13:16:26 vapier Exp $ -->
619 +<!-- The content of this document is licensed under the CC-BY-SA license -->
620 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
621 +
622 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-redboot.xml,v 1.2 2010/08/30 03:59:06 nightmorph Exp $ -->
623
624 <sections>
625
626 <abstract>
627 -Small bootloader based on eCos which supports every embedded architecture out there.
628 +Small bootloader based on eCos which supports every embedded architecture out
629 +there.
630 </abstract>
631
632 <version>0.1</version>
633 @@ -15,8 +19,11 @@
634 <section>
635 <title>Usage</title>
636 <body>
637 +
638 <p>
639 +TODO
640 </p>
641 +
642 </body>
643 </section>
644
645
646
647
648 1.2 xml/htdocs/proj/en/base/embedded/handbook/bootloaders-sh-lilo.xml
649
650 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-sh-lilo.xml?rev=1.2&view=markup
651 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-sh-lilo.xml?rev=1.2&content-type=text/plain
652 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-sh-lilo.xml?r1=1.1&r2=1.2
653
654 Index: bootloaders-sh-lilo.xml
655 ===================================================================
656 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-sh-lilo.xml,v
657 retrieving revision 1.1
658 retrieving revision 1.2
659 diff -u -r1.1 -r1.2
660 --- bootloaders-sh-lilo.xml 26 Aug 2007 13:16:26 -0000 1.1
661 +++ bootloaders-sh-lilo.xml 30 Aug 2010 03:59:06 -0000 1.2
662 @@ -1,7 +1,10 @@
663 <?xml version='1.0' encoding='UTF-8'?>
664 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
665
666 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-sh-lilo.xml,v 1.1 2007/08/26 13:16:26 vapier Exp $ -->
667 +<!-- The content of this document is licensed under the CC-BY-SA license -->
668 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
669 +
670 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/bootloaders-sh-lilo.xml,v 1.2 2010/08/30 03:59:06 nightmorph Exp $ -->
671
672 <sections>
673
674 @@ -15,8 +18,11 @@
675 <section>
676 <title>Usage</title>
677 <body>
678 +
679 <p>
680 +TODO
681 </p>
682 +
683 </body>
684 </section>
685
686
687
688
689 1.3 xml/htdocs/proj/en/base/embedded/handbook/communication.xml
690
691 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/communication.xml?rev=1.3&view=markup
692 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/communication.xml?rev=1.3&content-type=text/plain
693 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/communication.xml?r1=1.2&r2=1.3
694
695 Index: communication.xml
696 ===================================================================
697 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/communication.xml,v
698 retrieving revision 1.2
699 retrieving revision 1.3
700 diff -u -r1.2 -r1.3
701 --- communication.xml 13 Aug 2007 15:05:09 -0000 1.2
702 +++ communication.xml 30 Aug 2010 03:59:06 -0000 1.3
703 @@ -1,7 +1,10 @@
704 <?xml version='1.0' encoding='UTF-8'?>
705 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
706
707 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/communication.xml,v 1.2 2007/08/13 15:05:09 vapier Exp $ -->
708 +<!-- The content of this document is licensed under the CC-BY-SA license -->
709 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
710 +
711 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/communication.xml,v 1.3 2010/08/30 03:59:06 nightmorph Exp $ -->
712
713 <sections>
714
715 @@ -14,45 +17,56 @@
716
717 <section>
718 <title>Mailing Lists</title>
719 -
720 <body>
721 +
722 <p>
723 To participate in the Embedded Gentoo project first join the mailing list at
724 -<mail link="gentoo-embedded@g.o">gentoo-embedded@g.o</mail>.
725 -Then ask if there are plans to support something that you are interested in,
726 -propose a new subproject that you are interested in or choose one of the
727 -planned subprojects to work on.
728 +<mail link="gentoo-embedded@g.o">gentoo-embedded@g.o</mail>. Then
729 +ask if there are plans to support something that you are interested in, propose
730 +a new subproject that you are interested in or choose one of the planned
731 +subprojects to work on.
732 </p>
733 +
734 <p>
735 -For more information, see the <uri link="/main/en/lists.xml">common mailing list page</uri>.
736 +For more information, see the <uri link="/main/en/lists.xml">common mailing list
737 +page</uri>.
738 </p>
739 +
740 </body>
741 </section>
742
743 <section>
744 <title>IRC</title>
745 <body>
746 +
747 <p>
748 You may talk to the developers and users in the IRC channel
749 -<c>#gentoo-embedded</c> on <c>irc.freenode.net</c> for more information or
750 -just to chat about the project or any subprojects.
751 +<c>#gentoo-embedded</c> on <c>irc.freenode.net</c> for more information or just
752 +to chat about the project or any subprojects.
753 </p>
754 +
755 <p>
756 -For more information, see the <uri link="/main/en/irc.xml">common IRC page</uri>.
757 +For more information, see the <uri link="/main/en/irc.xml">common IRC
758 +page</uri>.
759 </p>
760 +
761 </body>
762 </section>
763
764 <section>
765 <title>Bugzilla</title>
766 <body>
767 +
768 <p>
769 -We use the <uri link="http://bugs.gentoo.org/">Gentoo Bugzilla</uri> to
770 -handle all of our tracking. All bug reports should generally go here.
771 +We use the <uri link="http://bugs.gentoo.org/">Gentoo Bugzilla</uri> to handle
772 +all of our tracking. All bug reports should generally go here.
773 </p>
774 +
775 <p>
776 -For more information, see the <uri link="/doc/en/bugzilla-howto.xml">Gentoo bug reporting guide</uri>.
777 +For more information, see the <uri link="/doc/en/bugzilla-howto.xml">Gentoo bug
778 +reporting guide</uri>.
779 </p>
780 +
781 </body>
782 </section>
783
784
785
786
787 1.3 xml/htdocs/proj/en/base/embedded/handbook/contributing.xml
788
789 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/contributing.xml?rev=1.3&view=markup
790 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/contributing.xml?rev=1.3&content-type=text/plain
791 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/contributing.xml?r1=1.2&r2=1.3
792
793 Index: contributing.xml
794 ===================================================================
795 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/contributing.xml,v
796 retrieving revision 1.2
797 retrieving revision 1.3
798 diff -u -r1.2 -r1.3
799 --- contributing.xml 26 Aug 2007 13:21:49 -0000 1.2
800 +++ contributing.xml 30 Aug 2010 03:59:06 -0000 1.3
801 @@ -1,12 +1,16 @@
802 <?xml version='1.0' encoding='UTF-8'?>
803 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
804
805 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/contributing.xml,v 1.2 2007/08/26 13:21:49 vapier Exp $ -->
806 +<!-- The content of this document is licensed under the CC-BY-SA license -->
807 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
808 +
809 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/contributing.xml,v 1.3 2010/08/30 03:59:06 nightmorph Exp $ -->
810
811 <sections>
812
813 <abstract>
814 -Gentoo Embedded and you: the answer to the ever prevalent "What can I do?" question.
815 +Gentoo Embedded and you: the answer to the ever prevalent "What can I do?"
816 +question.
817 </abstract>
818
819 <version>0.1</version>
820 @@ -15,9 +19,10 @@
821 <section>
822 <title>Where To Contribute</title>
823 <body>
824 +
825 <p>
826 First off, please review the <uri link="communication.xml">Gentoo Embedded
827 -communication channels</uri> and join as needed. Please do not start with
828 +communication channels</uri> and join as needed. Please do not start with
829 e-mailing specific developers.
830 </p>
831
832 @@ -25,43 +30,49 @@
833 Below we outline the many different aspects which could use your help.
834 Contribute whatever and whenever you can!
835 </p>
836 +
837 </body>
838 </section>
839
840 <section>
841 <title>Arch Testers</title>
842 <body>
843 +
844 <p>
845 Often times considered a mighty boring job, it is unfortunately quite critical
846 to the smooth running of a port. It involves testing new packages for
847 stabilization or new packages that have not yet been tested on the particular
848 -architecture. Simply select your favorite embedded architecture
849 -(arm, m68k, mips, ppc, sh) and start watching the alias on the Gentoo Bugzilla.
850 -When a bug opens requesting stabilization or arch testing, test the package in
851 -question on your setup and report back to the bug on how things go. If you
852 -want to contribute more, sign up to be a developer yourself for the
853 -architecture in question and just start committing fixes yourself! :) See
854 -our <uri link="/proj/en/devrel/">Gentoo Developer Relations page</uri> for
855 -more information.
856 +architecture. Simply select your favorite embedded architecture (arm, m68k,
857 +mips, ppc, sh) and start watching the alias on the Gentoo Bugzilla. When a bug
858 +opens requesting stabilization or arch testing, test the package in question on
859 +your setup and report back to the bug on how things go. If you want to
860 +contribute more, sign up to be a developer yourself for the architecture in
861 +question and just start committing fixes yourself! :) See our <uri
862 +link="/proj/en/devrel/">Gentoo Developer Relations page</uri> for more
863 +information.
864 </p>
865 +
866 </body>
867 </section>
868
869 <section>
870 <title>Release Engineers</title>
871 <body>
872 +
873 <p>
874 Every release of Gentoo should see updated stages for people to use as a base
875 when creating a new native install. Each architecture (arm, m68k, sh) needs a
876 dedicated person to go through the process of building these stages and
877 tracking down/fixing failures as they come up.
878 </p>
879 +
880 </body>
881 </section>
882
883 <section>
884 <title>Board Developers</title>
885 <body>
886 +
887 <p>
888 Got a crazy new embedded device and you want to put Gentoo on it? Then do it!
889 Once you've gone through the steps, put together a little bit of information on
890 @@ -69,29 +80,34 @@
891 making little firmware images for others to drop into their system so they can
892 get a head start on the process.
893 </p>
894 +
895 </body>
896 </section>
897
898 <section>
899 <title>Answer Questions</title>
900 <body>
901 +
902 <p>
903 Have general knowledge and like to help people? Great! We get questions every
904 day in our mailing lists/irc channels/etc... which require people to simply
905 watch and answer as they can. Maybe you'll learn a thing or two yourself!
906 </p>
907 +
908 </body>
909 </section>
910
911 <section>
912 <title>Documentation Writers</title>
913 <body>
914 +
915 <p>
916 -One of Gentoo's strong points is its documentation. However, this stuff
917 -doesn't write itself, so we need people familiar with Gentoo's simple
918 -<uri link="/doc/en/xml-guide.xml">GuideXML documentation format</uri> to help
919 +One of Gentoo's strong points is its documentation. However, this stuff doesn't
920 +write itself, so we need people familiar with Gentoo's simple <uri
921 +link="/doc/en/xml-guide.xml">GuideXML documentation format</uri> to help
922 maintain and expand the Gentoo Embedded documentation.
923 </p>
924 +
925 </body>
926 </section>
927
928
929
930
931 1.11 xml/htdocs/proj/en/base/embedded/handbook/cross-compiler.xml
932
933 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiler.xml?rev=1.11&view=markup
934 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiler.xml?rev=1.11&content-type=text/plain
935 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiler.xml?r1=1.10&r2=1.11
936
937 Index: cross-compiler.xml
938 ===================================================================
939 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiler.xml,v
940 retrieving revision 1.10
941 retrieving revision 1.11
942 diff -u -r1.10 -r1.11
943 --- cross-compiler.xml 13 Apr 2010 18:45:31 -0000 1.10
944 +++ cross-compiler.xml 30 Aug 2010 03:59:06 -0000 1.11
945 @@ -1,7 +1,10 @@
946 <?xml version='1.0' encoding='UTF-8'?>
947 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
948
949 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiler.xml,v 1.10 2010/04/13 18:45:31 nightmorph Exp $ -->
950 +<!-- The content of this document is licensed under the CC-BY-SA license -->
951 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
952 +
953 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiler.xml,v 1.11 2010/08/30 03:59:06 nightmorph Exp $ -->
954
955 <sections>
956
957 @@ -48,7 +51,6 @@
958
959 <section>
960 <title>crossdev</title>
961 -
962 <subsection>
963 <title>Intro</title>
964 <body>
965 @@ -234,77 +236,80 @@
966 </subsection>
967
968 <subsection>
969 - <title>Overview</title>
970 - <body>
971 - <p>
972 - There are generally two ways to build up your cross-compiler. The
973 - "accepted" way, and the cheater's shortcut.
974 - </p>
975 -
976 - <p>
977 - The current "accepted" way is:
978 - </p>
979 - <ol>
980 - <li>binutils</li>
981 - <li>kernel headers</li>
982 - <li>libc headers</li>
983 - <li>gcc stage1 (c-only)</li>
984 - <li>libc</li>
985 - <li>gcc stage2 (c/c++/etc...)</li>
986 - </ol>
987 -
988 - <p>
989 - The cheater's shortcut is:
990 - </p>
991 - <ol>
992 - <li>binutils</li>
993 - <li>kernel headers</li>
994 - <li>gcc stage1 (c-only)</li>
995 - <li>libc</li>
996 - <li>gcc stage2 (c/c++/etc...)</li>
997 - </ol>
998 -
999 - <p>
1000 - The reason people are keen on the shortcut is that the libc headers step
1001 - tends to take quite a while, especially on slower machines. It can also be
1002 - kind of a pain to setup kernel/libc headers without a usuable cross
1003 - compiler. Note though that if you seek help with cross-compilers, upstream
1004 - projects will not want to help you if you took the shortcut.
1005 - </p>
1006 -
1007 - <p>
1008 - Also note that the shortcut requires the gcc stage1 to be "crippled". Since
1009 - you're building without headers, you cannot enable the sysroot option nor
1010 - can you build up proper gcc libs. This is OK if the only thing you use the
1011 - stage1 is building the C library and a kernel, but beyond that you need a
1012 - nice sysroot based compiler.
1013 - </p>
1014 -
1015 - <p>
1016 - Below I will describe the "accepted" way as the steps are pretty much the
1017 - same. You just need some extra patches for gcc in order to take the
1018 - shortcut.
1019 - </p>
1020 - </body>
1021 -</subsection>
1022 -
1023 -<subsection>
1024 - <title>Sysroot</title>
1025 - <body>
1026 - <p>
1027 - We will be cross-compiling using the sysroot method. But wtf is sysroot ?
1028 - </p>
1029 -
1030 - <p>
1031 - From the gcc docs:<br/>
1032 - Tells GCC to consider dir as the root of a tree that contains a (subset of)
1033 - the root filesystem of the target operating system. Target system headers,
1034 - libraries and run-time object files will be searched in there.
1035 - </p>
1036 -
1037 - <p>
1038 - The top level dir is commonly rooted in /usr/$CTARGET
1039 - </p>
1040 +<title>Overview</title>
1041 +<body>
1042 +
1043 +<p>
1044 +There are generally two ways to build up your cross-compiler. The "accepted"
1045 +way, and the cheater's shortcut.
1046 +</p>
1047 +
1048 +<p>
1049 +The current "accepted" way is:
1050 +</p>
1051 +
1052 +<ol>
1053 + <li>binutils</li>
1054 + <li>kernel headers</li>
1055 + <li>libc headers</li>
1056 + <li>gcc stage1 (c-only)</li>
1057 + <li>libc</li>
1058 + <li>gcc stage2 (c/c++/etc...)</li>
1059 +</ol>
1060 +
1061 +<p>
1062 +The cheater's shortcut is:
1063 +</p>
1064 +
1065 +<ol>
1066 + <li>binutils</li>
1067 + <li>kernel headers</li>
1068 + <li>gcc stage1 (c-only)</li>
1069 + <li>libc</li>
1070 + <li>gcc stage2 (c/c++/etc...)</li>
1071 +</ol>
1072 +
1073 +<p>
1074 +The reason people are keen on the shortcut is that the libc headers step tends
1075 +to take quite a while, especially on slower machines. It can also be kind of a
1076 +pain to setup kernel/libc headers without a usuable cross compiler. Note though
1077 +that if you seek help with cross-compilers, upstream projects will not want to
1078 +help you if you took the shortcut.
1079 +</p>
1080 +
1081 +<p>
1082 +Also note that the shortcut requires the gcc stage1 to be "crippled". Since
1083 +you're building without headers, you cannot enable the sysroot option nor can
1084 +you build up proper gcc libs. This is OK if the only thing you use the stage1 is
1085 +building the C library and a kernel, but beyond that you need a nice sysroot
1086 +based compiler.
1087 +</p>
1088 +
1089 +<p>
1090 +Below I will describe the "accepted" way as the steps are pretty much the
1091 +same. You just need some extra patches for gcc in order to take the
1092 +shortcut.
1093 +</p>
1094 +
1095 +</body>
1096 +</subsection>
1097 +<subsection>
1098 +<title>Sysroot</title>
1099 +<body>
1100 +
1101 +<p>
1102 +We will be cross-compiling using the sysroot method. But does the sysroot do?
1103 +</p>
1104 +
1105 +<p>
1106 +The sysroot tells GCC to consider dir as the root of a tree that contains a
1107 +(subset of) the root filesystem of the target operating system. Target system
1108 +headers, libraries and run-time object files will be searched in there.
1109 +</p>
1110 +
1111 +<p>
1112 +The top level dir is commonly rooted in /usr/$CTARGET
1113 +</p>
1114
1115 <pre caption="typical sysroot layout">
1116 /usr/$CTARGET/
1117 @@ -317,36 +322,38 @@
1118 `-- lib/ non critical runtime libs / development libs
1119 </pre>
1120
1121 - <p>
1122 - As you can see, it's just like the directory setup / but in /usr/$CTARGET.
1123 - This setup is of course not an accident but designed on purpose so you can
1124 - easily migrate applications/libraries out of /usr/$CTARGET and into / on
1125 - your target board. If you wanted, you could even be lazy and use the
1126 - /usr/$CTARGET as a quick NFS root!
1127 - </p>
1128 -
1129 - <note>
1130 - Non-sysroot note:<br/>
1131 - The old style of cross-compilers was to use --prefix=/usr/$CTARGET. If you
1132 - are using versions of binutils/gcc that predate sysroot support, you may
1133 - have to do just this. I will not document this because (1) you should not
1134 - be using such old/crusty/busted versions and (2) it's quite a huge pita
1135 - compared to sysroot.
1136 - </note>
1137 - </body>
1138 -</subsection>
1139 +<p>
1140 +As you can see, it's just like the directory setup in <path>/</path> but in
1141 +<path>/usr/$CTARGET</path>. This setup is of course not an accident but
1142 +designed on purpose so you can easily migrate applications/libraries out of
1143 +<path>/usr/$CTARGET</path> and into <path>/</path> on your target board. If you
1144 +wanted, you could even be lazy and use the <path>/usr/$CTARGET</path> as a quick
1145 +NFS root!
1146 +</p>
1147
1148 +<note>
1149 +The old style of cross-compilers was to use <c>--prefix=/usr/$CTARGET</c>. If
1150 +you are using versions of binutils/gcc that predate sysroot support, you may
1151 +have to do just this. I will not document this because (1) you should not be
1152 +using such old/crusty/busted versions and (2) it's quite a huge pain compared to
1153 +sysroot.
1154 +</note>
1155 +
1156 +</body>
1157 +</subsection>
1158 <subsection>
1159 - <title>Binutils</title>
1160 - <body>
1161 - <p>
1162 - Grab the latest binutils tarball and unpack it.
1163 - </p>
1164 -
1165 - <p>
1166 - The --disable-werror configure option is to prevent binutils from aborting
1167 - the compile due to warnings. Great feature for developers, pita for users.
1168 - </p>
1169 +<title>Binutils</title>
1170 +<body>
1171 +
1172 +<p>
1173 +Grab the latest binutils tarball and unpack it.
1174 +</p>
1175 +
1176 +<p>
1177 +The <c>--disable-werror</c> configure option is to prevent binutils from
1178 +aborting the compile due to warnings. Great feature for developers, but a pain
1179 +for users.
1180 +</p>
1181
1182 <pre caption="configure and build binutils">
1183 $ <i>./configure \
1184 @@ -358,41 +365,42 @@
1185 $ <i>make install DESTDIR=$PWD/install-root</i>
1186 </pre>
1187
1188 - <p>
1189 - The reason we install into the localdir is so we can remove crap that
1190 - doesn't belong. For example, a normal install will give us
1191 - /usr/lib/libiberty.a which doesn't belong in our host /usr/lib. So
1192 - clean out stuff first:
1193 - </p>
1194 +<p>
1195 +The reason we install into the localdir is so we can remove crap that doesn't
1196 +belong. For example, a normal install will give us
1197 +<path>/usr/lib/libiberty.a</path> which doesn't belong in our host
1198 +<path>/usr/lib</path>. So clean out stuff first:
1199 +</p>
1200
1201 <pre caption="cleaning binutils">
1202 $ <i>rm -rf install-root/usr/{info,lib,man,share}</i>
1203 </pre>
1204
1205 - <p>
1206 - And install what's left:
1207 - </p>
1208 +<p>
1209 +And install what's left:
1210 +</p>
1211
1212 <pre caption="install binutils">
1213 # <i>cp -a install-root/* /</i>
1214 </pre>
1215 - </body>
1216 -</subsection>
1217
1218 +</body>
1219 +</subsection>
1220 <subsection>
1221 - <title>Kernel headers</title>
1222 - <body>
1223 - <p>
1224 - Grab the latest Linux tarball and unpack it. There are two ways of
1225 - installing the kernel headers: sanitized and unsanitized. The former
1226 - is clearly better (but requires a recent version of the Linux kernel),
1227 - but we'll quickly cover both.
1228 - </p>
1229 -
1230 - <note>
1231 - Clearly you'll have to replace $ARCH with a value that makes sense
1232 - for your platform.
1233 - </note>
1234 +<title>Kernel headers</title>
1235 +<body>
1236 +
1237 +<p>
1238 +Grab the latest Linux tarball and unpack it. There are two ways of
1239 +installing the kernel headers: sanitized and unsanitized. The former
1240 +is clearly better (but requires a recent version of the Linux kernel),
1241 +but we'll quickly cover both.
1242 +</p>
1243 +
1244 +<note>
1245 +Clearly you'll have to replace $ARCH with a value that makes sense for your
1246 +platform.
1247 +</note>
1248
1249 <pre caption="building/installing unsanitized headers">
1250 $ <i>yes "" | make ARCH=$ARCH oldconfig prepare</i>
1251 @@ -404,16 +412,17 @@
1252 <pre caption="building/installing sanitized headers">
1253 # <i>make ARCH=$ARCH headers_install INSTALL_HDR_PATH=/usr/$CTARGET/usr</i>
1254 </pre>
1255 - </body>
1256 -</subsection>
1257
1258 +</body>
1259 +</subsection>
1260 <subsection>
1261 - <title>System libc headers</title>
1262 - <body>
1263 - <p>
1264 - Grab the latest glibc tarball and unpack it. Glibc is picky, so you'll
1265 - have to compile in a dir separate from the source code.
1266 - </p>
1267 +<title>System libc headers</title>
1268 +<body>
1269 +
1270 +<p>
1271 +Grab the latest glibc tarball and unpack it. Glibc is picky, so you'll
1272 +have to compile in a directory separate from the source code.
1273 +</p>
1274
1275 <pre caption="building/installing glibc headers">
1276 $ <i>mkdir build</i>
1277 @@ -427,32 +436,33 @@
1278 # <i>make -k install-headers install_root=/usr/$CTARGET</i>
1279 </pre>
1280
1281 - <p>
1282 - Glibc sucks at life so you have to do a few things by hand:
1283 - </p>
1284 +<p>
1285 +Glibc sucks at life so you have to do a few things by hand:
1286 +</p>
1287
1288 <pre caption="help glibc">
1289 # <i>mkdir -p /usr/$CTARGET/usr/include/gnu</i>
1290 # <i>touch /usr/$CTARGET/usr/include/gnu/stubs.h</i>
1291 # <i>cp bits/stdio_lim.h /usr/$CTARGET/usr/include/bits/</i>
1292 </pre>
1293 - </body>
1294 -</subsection>
1295
1296 +</body>
1297 +</subsection>
1298 <subsection>
1299 - <title>GCC Stage 1 (C only)</title>
1300 - <body>
1301 - <p>
1302 - We first have to help gcc find the current libc headers.
1303 - </p>
1304 +<title>GCC Stage 1 (C only)</title>
1305 +<body>
1306 +
1307 +<p>
1308 +We first have to help gcc find the current libc headers.
1309 +</p>
1310
1311 <pre caption="help gcc">
1312 # <i>ln -s usr/include /usr/$CTARGET/sys-include</i>
1313 </pre>
1314
1315 - <p>
1316 - Then grab the latest gcc tarball and unpack it.
1317 - </p>
1318 +<p>
1319 +Then grab the latest gcc tarball and unpack it.
1320 +</p>
1321
1322 <pre caption="building gcc stage 1">
1323 $ <i>mkdir build</i>
1324 @@ -472,31 +482,32 @@
1325 $ <i>make install DESTDIR=$PWD/install-root</i>
1326 </pre>
1327
1328 - <p>
1329 - Same as binutils, gcc leaves some stuff behind we don't want.
1330 - </p>
1331 +<p>
1332 +Same as binutils, gcc leaves some stuff behind we don't want.
1333 +</p>
1334
1335 <pre caption="cleaning gcc stage 1">
1336 $ <i>rm -rf install-root/usr/{info,include,lib/libiberty.a,man,share}</i>
1337 </pre>
1338
1339 - <p>
1340 - Then install what's left (everything should be in CTARGET specific
1341 - directories which prevents overwriting your host files):
1342 - </p>
1343 +<p>
1344 +Then install what's left (everything should be in CTARGET specific directories
1345 +which prevents overwriting your host files):
1346 +</p>
1347
1348 <pre caption="installing gcc stage 1">
1349 # <i>cp -a install-root/* /</i>
1350 </pre>
1351 - </body>
1352 -</subsection>
1353
1354 +</body>
1355 +</subsection>
1356 <subsection>
1357 - <title>System libc</title>
1358 - <body>
1359 - <p>
1360 - Nuke the old glibc build dir and recreate it.
1361 - </p>
1362 +<title>System libc</title>
1363 +<body>
1364 +
1365 +<p>
1366 +Remove the old glibc build dir and recreate it.
1367 +</p>
1368
1369 <pre caption="building/installing glibc">
1370 $ <i>rm -rf build</i>
1371 @@ -509,16 +520,17 @@
1372 $ <i>make</i>
1373 # <i>make install install_root=/usr/$CTARGET</i>
1374 </pre>
1375 - </body>
1376 -</subsection>
1377
1378 +</body>
1379 +</subsection>
1380 <subsection>
1381 - <title>GCC Stage 2 (All frontends)</title>
1382 - <body>
1383 - <p>
1384 - Build up a full GCC now. Select whichever compiler frontends you like,
1385 - we'll just do C/C++ for simplicity.
1386 - </p>
1387 +<title>GCC Stage 2 (All frontends)</title>
1388 +<body>
1389 +
1390 +<p>
1391 +Build up a full GCC now. Select whichever compiler frontends you like; we'll
1392 +just do C/C++ for simplicity.
1393 +</p>
1394
1395 <pre caption="building/installing gcc stage 2">
1396 $ <i>./configure \
1397 @@ -532,94 +544,111 @@
1398 $ <i>make</i>
1399 # <i>make install</i>
1400 </pre>
1401 - </body>
1402 -</subsection>
1403
1404 +</body>
1405 +</subsection>
1406 <subsection>
1407 - <title>Core Runtime Files</title>
1408 - <body>
1409 - <p>
1410 - There are many random core runtime files that people wonder what they may
1411 - be for. Let's explain.
1412 - </p>
1413 -
1414 - <table>
1415 - <tr>
1416 - <th colspan="2">Files provided by glibc</th>
1417 - </tr>
1418 - <tr>
1419 - <th>File</th>
1420 - <th>Purpose</th>
1421 - </tr>
1422 - <tr>
1423 - <ti>crt0.o</ti>
1424 - <ti>Older style of the initial runtime code ? No one generates this anymore.</ti>
1425 - </tr>
1426 - <tr>
1427 - <ti>crt1.o</ti>
1428 - <ti>Newer style of the initial runtime code. Contains the _start symbol which sets up the env with argc/argv/libc _init/libc _fini before jumping to the libc main. glibc calls this file 'start.S'.</ti>
1429 - </tr>
1430 - <tr>
1431 - <ti>crti.o</ti>
1432 - <ti>Defines the function prolog; _init in the .init section and _fini in the .fini section. glibc calls this 'initfini.c'.</ti>
1433 - </tr>
1434 - <tr>
1435 - <ti>crtn.o</ti>
1436 - <ti>Defines the function epilog. glibc calls this 'initfini.c'.</ti>
1437 - </tr>
1438 - <tr>
1439 - <ti>Scrt1.o</ti>
1440 - <ti>Used in place of crt1.o when generating PIEs.</ti>
1441 - </tr>
1442 - <tr>
1443 - <ti>gcrt1.o</ti>
1444 - <ti>Used in place of crt1.o when generating code with profiling information. Compile with -pg. Produces output suitable for the gprof util.</ti>
1445 - </tr>
1446 - <tr>
1447 - <ti>Mcrt1.o</ti>
1448 - <ti>Like gcrt1.o, but is used with the prof utility. glibc installs this as a dummy file as it's useless on linux systems.</ti>
1449 - </tr>
1450 - </table>
1451 -
1452 - <table>
1453 - <tr>
1454 - <th colspan="2">Files provided by GCC</th>
1455 - </tr>
1456 - <tr>
1457 - <th>File</th>
1458 - <th>Purpose</th>
1459 - </tr>
1460 - <tr>
1461 - <ti>crtbegin.o</ti>
1462 - <ti>GCC uses this to find the start of the constructors.</ti>
1463 - </tr>
1464 - <tr>
1465 - <ti>crtbeginS.o</ti>
1466 - <ti>Used in place of crtbegin.o when generating shared objects/PIEs.</ti>
1467 - </tr>
1468 - <tr>
1469 - <ti>crtbeginT.o</ti>
1470 - <ti>Used in place of crtbegin.o when generating static executables.</ti>
1471 - </tr>
1472 - <tr>
1473 - <ti>crtend.o</ti>
1474 - <ti>GCC uses this to find the start of the destructors.</ti>
1475 - </tr>
1476 - <tr>
1477 - <ti>crtendS.o</ti>
1478 - <ti>Used in place of crtend.o when generating shared objects/PIEs.</ti>
1479 - </tr>
1480 - </table>
1481 -
1482 - <p>
1483 - The general linking order:
1484 - </p>
1485 +<title>Core Runtime Files</title>
1486 +<body>
1487 +
1488 +<p>
1489 +There are many random core runtime files that people wonder what they may be
1490 +for. Let's explain.
1491 +</p>
1492 +
1493 +<table>
1494 +<tr>
1495 + <th colspan="2">Files provided by glibc</th>
1496 +</tr>
1497 +<tr>
1498 + <th>File</th>
1499 + <th>Purpose</th>
1500 +</tr>
1501 +<tr>
1502 + <ti>crt0.o</ti>
1503 + <ti>
1504 + Older style of the initial runtime code. No one generates this anymore.
1505 + </ti>
1506 +</tr>
1507 +<tr>
1508 + <ti>crt1.o</ti>
1509 + <ti>
1510 + Newer style of the initial runtime code. Contains the _start symbol which
1511 + sets up the env with argc/argv/libc _init/libc _fini before jumping to the
1512 + libc main. glibc calls this file 'start.S'.
1513 + </ti>
1514 +</tr>
1515 +<tr>
1516 + <ti>crti.o</ti>
1517 + <ti>
1518 + Defines the function prolog; _init in the .init section and _fini in the
1519 + .fini section. glibc calls this 'initfini.c'.
1520 + </ti>
1521 +</tr>
1522 +<tr>
1523 + <ti>crtn.o</ti>
1524 + <ti>Defines the function epilog. glibc calls this 'initfini.c'.</ti>
1525 +</tr>
1526 +<tr>
1527 + <ti>Scrt1.o</ti>
1528 + <ti>Used in place of crt1.o when generating PIEs.</ti>
1529 +</tr>
1530 +<tr>
1531 + <ti>gcrt1.o</ti>
1532 + <ti>
1533 + Used in place of crt1.o when generating code with profiling information.
1534 + Compile with -pg. Produces output suitable for the gprof util.
1535 + </ti>
1536 +</tr>
1537 +<tr>
1538 + <ti>Mcrt1.o</ti>
1539 + <ti>
1540 + Like gcrt1.o, but is used with the prof utility. glibc installs this as a
1541 + dummy file as it's useless on linux systems.
1542 + </ti>
1543 +</tr>
1544 +</table>
1545 +
1546 +<table>
1547 +<tr>
1548 + <th colspan="2">Files provided by GCC</th>
1549 +</tr>
1550 +<tr>
1551 + <th>File</th>
1552 + <th>Purpose</th>
1553 +</tr>
1554 +<tr>
1555 + <ti>crtbegin.o</ti>
1556 + <ti>GCC uses this to find the start of the constructors.</ti>
1557 +</tr>
1558 +<tr>
1559 + <ti>crtbeginS.o</ti>
1560 + <ti>Used in place of crtbegin.o when generating shared objects/PIEs.</ti>
1561 +</tr>
1562 +<tr>
1563 + <ti>crtbeginT.o</ti>
1564 + <ti>Used in place of crtbegin.o when generating static executables.</ti>
1565 +</tr>
1566 +<tr>
1567 + <ti>crtend.o</ti>
1568 + <ti>GCC uses this to find the start of the destructors.</ti>
1569 +</tr>
1570 +<tr>
1571 + <ti>crtendS.o</ti>
1572 + <ti>Used in place of crtend.o when generating shared objects/PIEs.</ti>
1573 +</tr>
1574 +</table>
1575 +
1576 +<p>
1577 +The general linking order:
1578 +</p>
1579 +
1580 <pre caption="general linking order">
1581 ... crt1.o crti.o crtbegin.o [-L paths] [user objects] [gcc libs] [C libs] [gcc libs] crtend.o crtn.o
1582 </pre>
1583 - </body>
1584 -</subsection>
1585
1586 +</body>
1587 +</subsection>
1588 </section>
1589
1590 </sections>
1591
1592
1593
1594 1.5 xml/htdocs/proj/en/base/embedded/handbook/cross-compiling-kernel.xml
1595
1596 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiling-kernel.xml?rev=1.5&view=markup
1597 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiling-kernel.xml?rev=1.5&content-type=text/plain
1598 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiling-kernel.xml?r1=1.4&r2=1.5
1599
1600 Index: cross-compiling-kernel.xml
1601 ===================================================================
1602 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiling-kernel.xml,v
1603 retrieving revision 1.4
1604 retrieving revision 1.5
1605 diff -u -r1.4 -r1.5
1606 --- cross-compiling-kernel.xml 13 Apr 2010 18:45:31 -0000 1.4
1607 +++ cross-compiling-kernel.xml 30 Aug 2010 03:59:07 -0000 1.5
1608 @@ -1,7 +1,10 @@
1609 <?xml version='1.0' encoding='UTF-8'?>
1610 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
1611
1612 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiling-kernel.xml,v 1.4 2010/04/13 18:45:31 nightmorph Exp $ -->
1613 +<!-- The content of this document is licensed under the CC-BY-SA license -->
1614 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
1615 +
1616 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-compiling-kernel.xml,v 1.5 2010/08/30 03:59:07 nightmorph Exp $ -->
1617
1618 <sections>
1619
1620
1621
1622
1623 1.4 xml/htdocs/proj/en/base/embedded/handbook/cross-qemu.xml
1624
1625 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-qemu.xml?rev=1.4&view=markup
1626 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-qemu.xml?rev=1.4&content-type=text/plain
1627 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-qemu.xml?r1=1.3&r2=1.4
1628
1629 Index: cross-qemu.xml
1630 ===================================================================
1631 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-qemu.xml,v
1632 retrieving revision 1.3
1633 retrieving revision 1.4
1634 diff -u -r1.3 -r1.4
1635 --- cross-qemu.xml 14 Feb 2010 23:56:33 -0000 1.3
1636 +++ cross-qemu.xml 30 Aug 2010 03:59:07 -0000 1.4
1637 @@ -1,6 +1,9 @@
1638 <?xml version='1.0' encoding='UTF-8'?>
1639 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
1640 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-qemu.xml,v 1.3 2010/02/14 23:56:33 solar Exp $ -->
1641 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/cross-qemu.xml,v 1.4 2010/08/30 03:59:07 nightmorph Exp $ -->
1642 +
1643 +<!-- The content of this document is licensed under the CC-BY-SA license -->
1644 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
1645
1646 <sections>
1647
1648
1649
1650
1651 1.2 xml/htdocs/proj/en/base/embedded/handbook/emu-armulator.xml
1652
1653 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-armulator.xml?rev=1.2&view=markup
1654 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-armulator.xml?rev=1.2&content-type=text/plain
1655 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-armulator.xml?r1=1.1&r2=1.2
1656
1657 Index: emu-armulator.xml
1658 ===================================================================
1659 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-armulator.xml,v
1660 retrieving revision 1.1
1661 retrieving revision 1.2
1662 diff -u -r1.1 -r1.2
1663 --- emu-armulator.xml 26 Aug 2007 13:16:26 -0000 1.1
1664 +++ emu-armulator.xml 30 Aug 2010 03:59:07 -0000 1.2
1665 @@ -1,7 +1,10 @@
1666 <?xml version='1.0' encoding='UTF-8'?>
1667 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
1668
1669 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-armulator.xml,v 1.1 2007/08/26 13:16:26 vapier Exp $ -->
1670 +<!-- The content of this document is licensed under the CC-BY-SA license -->
1671 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
1672 +
1673 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-armulator.xml,v 1.2 2010/08/30 03:59:07 nightmorph Exp $ -->
1674
1675 <sections>
1676
1677 @@ -15,8 +18,11 @@
1678 <section>
1679 <title>Usage</title>
1680 <body>
1681 +
1682 <p>
1683 +TODO
1684 </p>
1685 +
1686 </body>
1687 </section>
1688
1689
1690
1691
1692 1.2 xml/htdocs/proj/en/base/embedded/handbook/emu-hercules.xml
1693
1694 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-hercules.xml?rev=1.2&view=markup
1695 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-hercules.xml?rev=1.2&content-type=text/plain
1696 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-hercules.xml?r1=1.1&r2=1.2
1697
1698 Index: emu-hercules.xml
1699 ===================================================================
1700 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-hercules.xml,v
1701 retrieving revision 1.1
1702 retrieving revision 1.2
1703 diff -u -r1.1 -r1.2
1704 --- emu-hercules.xml 26 Aug 2007 13:16:26 -0000 1.1
1705 +++ emu-hercules.xml 30 Aug 2010 03:59:07 -0000 1.2
1706 @@ -1,7 +1,10 @@
1707 <?xml version='1.0' encoding='UTF-8'?>
1708 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
1709
1710 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-hercules.xml,v 1.1 2007/08/26 13:16:26 vapier Exp $ -->
1711 +<!-- The content of this document is licensed under the CC-BY-SA license -->
1712 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
1713 +
1714 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-hercules.xml,v 1.2 2010/08/30 03:59:07 nightmorph Exp $ -->
1715
1716 <sections>
1717
1718 @@ -15,8 +18,11 @@
1719 <section>
1720 <title>Usage</title>
1721 <body>
1722 +
1723 <p>
1724 +TODO
1725 </p>
1726 +
1727 </body>
1728 </section>
1729
1730
1731
1732
1733 1.2 xml/htdocs/proj/en/base/embedded/handbook/emu-qemu.xml
1734
1735 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-qemu.xml?rev=1.2&view=markup
1736 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-qemu.xml?rev=1.2&content-type=text/plain
1737 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-qemu.xml?r1=1.1&r2=1.2
1738
1739 Index: emu-qemu.xml
1740 ===================================================================
1741 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-qemu.xml,v
1742 retrieving revision 1.1
1743 retrieving revision 1.2
1744 diff -u -r1.1 -r1.2
1745 --- emu-qemu.xml 26 Aug 2007 13:16:26 -0000 1.1
1746 +++ emu-qemu.xml 30 Aug 2010 03:59:07 -0000 1.2
1747 @@ -1,7 +1,10 @@
1748 <?xml version='1.0' encoding='UTF-8'?>
1749 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
1750
1751 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-qemu.xml,v 1.1 2007/08/26 13:16:26 vapier Exp $ -->
1752 +<!-- The content of this document is licensed under the CC-BY-SA license -->
1753 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
1754 +
1755 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-qemu.xml,v 1.2 2010/08/30 03:59:07 nightmorph Exp $ -->
1756
1757 <sections>
1758
1759 @@ -15,8 +18,11 @@
1760 <section>
1761 <title>Usage</title>
1762 <body>
1763 +
1764 <p>
1765 +TODO
1766 </p>
1767 +
1768 </body>
1769 </section>
1770
1771
1772
1773
1774 1.2 xml/htdocs/proj/en/base/embedded/handbook/emu-skyeye.xml
1775
1776 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-skyeye.xml?rev=1.2&view=markup
1777 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-skyeye.xml?rev=1.2&content-type=text/plain
1778 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-skyeye.xml?r1=1.1&r2=1.2
1779
1780 Index: emu-skyeye.xml
1781 ===================================================================
1782 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-skyeye.xml,v
1783 retrieving revision 1.1
1784 retrieving revision 1.2
1785 diff -u -r1.1 -r1.2
1786 --- emu-skyeye.xml 26 Aug 2007 13:16:26 -0000 1.1
1787 +++ emu-skyeye.xml 30 Aug 2010 03:59:07 -0000 1.2
1788 @@ -1,7 +1,10 @@
1789 <?xml version='1.0' encoding='UTF-8'?>
1790 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
1791
1792 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-skyeye.xml,v 1.1 2007/08/26 13:16:26 vapier Exp $ -->
1793 +<!-- The content of this document is licensed under the CC-BY-SA license -->
1794 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
1795 +
1796 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-skyeye.xml,v 1.2 2010/08/30 03:59:07 nightmorph Exp $ -->
1797
1798 <sections>
1799
1800 @@ -15,8 +18,11 @@
1801 <section>
1802 <title>Usage</title>
1803 <body>
1804 +
1805 <p>
1806 +TODO
1807 </p>
1808 +
1809 </body>
1810 </section>
1811
1812
1813
1814
1815 1.2 xml/htdocs/proj/en/base/embedded/handbook/emu-softgun.xml
1816
1817 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-softgun.xml?rev=1.2&view=markup
1818 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-softgun.xml?rev=1.2&content-type=text/plain
1819 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-softgun.xml?r1=1.1&r2=1.2
1820
1821 Index: emu-softgun.xml
1822 ===================================================================
1823 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-softgun.xml,v
1824 retrieving revision 1.1
1825 retrieving revision 1.2
1826 diff -u -r1.1 -r1.2
1827 --- emu-softgun.xml 26 Aug 2007 13:16:26 -0000 1.1
1828 +++ emu-softgun.xml 30 Aug 2010 03:59:07 -0000 1.2
1829 @@ -1,7 +1,10 @@
1830 <?xml version='1.0' encoding='UTF-8'?>
1831 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
1832
1833 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-softgun.xml,v 1.1 2007/08/26 13:16:26 vapier Exp $ -->
1834 +<!-- The content of this document is licensed under the CC-BY-SA license -->
1835 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
1836 +
1837 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/emu-softgun.xml,v 1.2 2010/08/30 03:59:07 nightmorph Exp $ -->
1838
1839 <sections>
1840
1841 @@ -15,8 +18,11 @@
1842 <section>
1843 <title>Usage</title>
1844 <body>
1845 +
1846 <p>
1847 +TODO
1848 </p>
1849 +
1850 </body>
1851 </section>
1852
1853
1854
1855
1856 1.4 xml/htdocs/proj/en/base/embedded/handbook/faq.xml
1857
1858 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/faq.xml?rev=1.4&view=markup
1859 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/faq.xml?rev=1.4&content-type=text/plain
1860 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/faq.xml?r1=1.3&r2=1.4
1861
1862 Index: faq.xml
1863 ===================================================================
1864 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/faq.xml,v
1865 retrieving revision 1.3
1866 retrieving revision 1.4
1867 diff -u -r1.3 -r1.4
1868 --- faq.xml 20 Mar 2008 11:38:43 -0000 1.3
1869 +++ faq.xml 30 Aug 2010 03:59:07 -0000 1.4
1870 @@ -1,7 +1,10 @@
1871 <?xml version='1.0' encoding='UTF-8'?>
1872 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
1873
1874 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/faq.xml,v 1.3 2008/03/20 11:38:43 vapier Exp $ -->
1875 +<!-- The content of this document is licensed under the CC-BY-SA license -->
1876 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
1877 +
1878 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/faq.xml,v 1.4 2010/08/30 03:59:07 nightmorph Exp $ -->
1879
1880 <sections>
1881
1882 @@ -15,6 +18,7 @@
1883 <section>
1884 <title>I get "configure: error: C compiler cannot create executables"</title>
1885 <body>
1886 +
1887 <p>
1888 This is a generic error and can be caused by just about anything. The test is
1889 pretty simple: can the requested compiler create an executable? However, this
1890 @@ -25,12 +29,14 @@
1891 this test is run and see what exactly the error message is that the toolchain
1892 is spitting out.
1893 </p>
1894 +
1895 </body>
1896 </section>
1897
1898 <section>
1899 <title>"epatch" always fails in newly compiled system</title>
1900 <body>
1901 +
1902 <p>
1903 The bash package does not properly cross-compile and mixes the host signal
1904 definitions with those of the target. This manifests itself differently
1905 @@ -40,18 +46,21 @@
1906 all the calls to epatch. Once you've installed the fixed bash this way,
1907 uncomment all of the bash lines and rebuild it again.
1908 </p>
1909 +
1910 </body>
1911 </section>
1912
1913 <section>
1914 <title>uClibc build segfaults/crashes while building locale</title>
1915 <body>
1916 +
1917 <p>
1918 The uClibc locale support is pretty experimental at this point. Unless you
1919 really need support for it (and you're willing to help bang on the problem),
1920 simply disable support by adding <c>-nls -iconv -pregen -userlocales</c> to
1921 your <c>USE</c> when building uClibc.
1922 </p>
1923 +
1924 </body>
1925 </section>
1926
1927
1928
1929
1930 1.7 xml/htdocs/proj/en/base/embedded/handbook/intro.xml
1931
1932 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/intro.xml?rev=1.7&view=markup
1933 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/intro.xml?rev=1.7&content-type=text/plain
1934 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/intro.xml?r1=1.6&r2=1.7
1935
1936 Index: intro.xml
1937 ===================================================================
1938 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/intro.xml,v
1939 retrieving revision 1.6
1940 retrieving revision 1.7
1941 diff -u -r1.6 -r1.7
1942 --- intro.xml 13 Apr 2010 18:45:31 -0000 1.6
1943 +++ intro.xml 30 Aug 2010 03:59:07 -0000 1.7
1944 @@ -1,7 +1,10 @@
1945 <?xml version='1.0' encoding='UTF-8'?>
1946 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
1947
1948 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/intro.xml,v 1.6 2010/04/13 18:45:31 nightmorph Exp $ -->
1949 +<!-- The content of this document is licensed under the CC-BY-SA license -->
1950 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
1951 +
1952 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/intro.xml,v 1.7 2010/08/30 03:59:07 nightmorph Exp $ -->
1953
1954 <sections>
1955
1956
1957
1958
1959 1.6 xml/htdocs/proj/en/base/embedded/handbook/the-more-you-know.xml
1960
1961 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/the-more-you-know.xml?rev=1.6&view=markup
1962 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/the-more-you-know.xml?rev=1.6&content-type=text/plain
1963 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/the-more-you-know.xml?r1=1.5&r2=1.6
1964
1965 Index: the-more-you-know.xml
1966 ===================================================================
1967 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/the-more-you-know.xml,v
1968 retrieving revision 1.5
1969 retrieving revision 1.6
1970 diff -u -r1.5 -r1.6
1971 --- the-more-you-know.xml 1 Dec 2009 02:51:31 -0000 1.5
1972 +++ the-more-you-know.xml 30 Aug 2010 03:59:07 -0000 1.6
1973 @@ -1,7 +1,10 @@
1974 <?xml version='1.0' encoding='UTF-8'?>
1975 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
1976
1977 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/the-more-you-know.xml,v 1.5 2009/12/01 02:51:31 vapier Exp $ -->
1978 +<!-- The content of this document is licensed under the CC-BY-SA license -->
1979 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
1980 +
1981 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/the-more-you-know.xml,v 1.6 2010/08/30 03:59:07 nightmorph Exp $ -->
1982
1983 <sections>
1984
1985 @@ -14,74 +17,119 @@
1986
1987 <section>
1988 <title>Books</title>
1989 +<subsection>
1990 +<title>Embedded Books</title>
1991 +<body>
1992 +
1993 +<ul>
1994 + <li>
1995 + <uri link="http://www.oreilly.com/catalog/belinuxsys/">Building Embedded
1996 + Linux Systems</uri>
1997 + </li>
1998 + <li>
1999 + <uri link="http://www.oreilly.com/catalog/dbhardware2/">Designing Embedded
2000 + Hardware</uri>
2001 + </li>
2002 + <li>
2003 + <uri link="http://www.oreilly.com/catalog/embsys2/">Programming Embedded
2004 + Systems</uri>
2005 + </li>
2006 + <li>
2007 + <uri
2008 + link="http://www.informit.com/store/product.aspx?isbn=0131679848">Embedded
2009 + Linux Primer</uri>
2010 + </li>
2011 + <li>
2012 + <uri
2013 + link="http://www.amazon.com/Embedded-Linux-System-Design-Development/dp/0849340586">Embedded
2014 + Linux System Design and Development</uri>
2015 + </li>
2016 +</ul>
2017 +
2018 +</body>
2019 +</subsection>
2020 +<subsection>
2021 +<title>Linux Kernel Books</title>
2022 +<body>
2023 +
2024 +<ul>
2025 + <li>
2026 + <uri link="http://www.oreilly.com/catalog/linuxdrive3/">Linux Device
2027 + Drivers</uri>
2028 + </li>
2029 + <li>
2030 + <uri link="http://www.oreilly.com/catalog/understandlk/">Understanding the
2031 + Linux Kernel</uri>
2032 + </li>
2033 + <li>
2034 + <uri link="http://www.oreilly.com/catalog/9780596100797/">Linux Kernel in a
2035 + Nutshell</uri>
2036 + </li>
2037 + <li>
2038 + <uri link="http://www.informit.com/store/product.aspx?isbn=0131181637">Linux
2039 + Kernel Primer</uri>
2040 + </li>
2041 + <li>
2042 + <uri link="http://www.oreilly.com/catalog/understandlni/">Understanding
2043 + Linux Network Internals</uri>
2044 + </li>
2045 + <li>
2046 + <uri link="http://www.informit.com/store/product.aspx?isbn=0672327201">Linux
2047 + Kernel Development</uri>
2048 + </li>
2049 +</ul>
2050
2051 - <subsection>
2052 - <title>Embedded Books</title>
2053 - <body>
2054 - <ul>
2055 - <li><uri link="http://www.oreilly.com/catalog/belinuxsys/">Building Embedded Linux Systems</uri></li>
2056 - <li><uri link="http://www.oreilly.com/catalog/dbhardware2/">Designing Embedded Hardware</uri></li>
2057 - <li><uri link="http://www.oreilly.com/catalog/embsys2/">Programming Embedded Systems</uri></li>
2058 - <li><uri link="http://www.informit.com/store/product.aspx?isbn=0131679848">Embedded Linux Primer</uri></li>
2059 - <li><uri link="http://www.amazon.com/Embedded-Linux-System-Design-Development/dp/0849340586">Embedded Linux System Design and Development</uri></li>
2060 - </ul>
2061 - </body>
2062 - </subsection>
2063 -
2064 - <subsection>
2065 - <title>Linux Kernel Books</title>
2066 - <body>
2067 - <ul>
2068 - <li><uri link="http://www.oreilly.com/catalog/linuxdrive3/">Linux Device Drivers</uri></li>
2069 - <li><uri link="http://www.oreilly.com/catalog/understandlk/">Understanding the Linux Kernel</uri></li>
2070 - <li><uri link="http://www.oreilly.com/catalog/9780596100797/">Linux Kernel in a Nutshell</uri></li>
2071 - <li><uri link="http://www.informit.com/store/product.aspx?isbn=0131181637">Linux Kernel Primer</uri></li>
2072 - <li><uri link="http://www.oreilly.com/catalog/understandlni/">Understanding Linux Network Internals</uri></li>
2073 - <li><uri link="http://www.informit.com/store/product.aspx?isbn=0672327201">Linux Kernel Development</uri></li>
2074 - </ul>
2075 - </body>
2076 - </subsection>
2077 +</body>
2078 +</subsection>
2079
2080 </section>
2081
2082 <section>
2083 <title>Links</title>
2084 +<subsection>
2085 +<title>Embedded Forums</title>
2086 +<body>
2087 +
2088 +<ul>
2089 + <li><uri link="http://ucdot.org/">Embedded Linux Developer Forum</uri></li>
2090 + <li><uri link="http://uclinux.org/">The uClinux Distribution</uri></li>
2091 +</ul>
2092 +
2093 +</body>
2094 +</subsection>
2095 +<subsection>
2096 +<title>Cross-compiler Pages</title>
2097 +<body>
2098 +
2099 +<ul>
2100 + <li>
2101 + <uri link="http://sourceware.org/ml/crossgcc/">Cross GCC Mailing
2102 + List</uri>
2103 + </li>
2104 + <li>
2105 + <uri
2106 + link="http://ymorin.is-a-geek.org/projects/crosstool">crosstool-NG</uri>
2107 + </li>
2108 + <li><uri link="http://www.kegel.com/crosstool/">Crosstool</uri></li>
2109 +</ul>
2110 +</body>
2111 +
2112 +</subsection>
2113 +<subsection>
2114 +<title>Projects</title>
2115 +<body>
2116 +
2117 +<ul>
2118 + <li><uri link="http://sourceware.org/binutils/">Binutils</uri></li>
2119 + <li><uri link="http://gcc.gnu.org/">GCC</uri></li>
2120 + <li><uri link="http://www.gnu.org/software/libc/">Glibc</uri></li>
2121 + <li><uri link="http://www.kernel.org/">Linux Kernel</uri></li>
2122 + <li><uri link="http://uclibc.org/">uClibc</uri></li>
2123 + <li><uri link="http://busybox.net/">BusyBox</uri></li>
2124 +</ul>
2125 +</body>
2126
2127 - <subsection>
2128 - <title>Embedded Forums</title>
2129 - <body>
2130 - <ul>
2131 - <li><uri link="http://ucdot.org/">Embedded Linux Developer Forum</uri></li>
2132 - <li><uri link="http://uclinux.org/">The uClinux Distribution</uri></li>
2133 - </ul>
2134 - </body>
2135 - </subsection>
2136 -
2137 - <subsection>
2138 - <title>Cross-compiler Pages</title>
2139 - <body>
2140 - <ul>
2141 - <li><uri link="http://sourceware.org/ml/crossgcc/">Cross GCC Mailing List</uri></li>
2142 - <li><uri link="http://ymorin.is-a-geek.org/projects/crosstool">crosstool-NG</uri></li>
2143 - <li><uri link="http://www.kegel.com/crosstool/">Crosstool</uri></li>
2144 - </ul>
2145 - </body>
2146 - </subsection>
2147 -
2148 - <subsection>
2149 - <title>Projects</title>
2150 - <body>
2151 - <ul>
2152 - <li><uri link="http://sourceware.org/binutils/">Binutils</uri></li>
2153 - <li><uri link="http://gcc.gnu.org/">GCC</uri></li>
2154 - <li><uri link="http://www.gnu.org/software/libc/">Glibc</uri></li>
2155 - <li><uri link="http://www.kernel.org/">Linux Kernel</uri></li>
2156 - <li><uri link="http://uclibc.org/">uClibc</uri></li>
2157 - <li><uri link="http://busybox.net/">BusyBox</uri></li>
2158 - </ul>
2159 - </body>
2160 - </subsection>
2161 -
2162 +</subsection>
2163 </section>
2164
2165 </sections>
2166
2167
2168
2169 1.5 xml/htdocs/proj/en/base/embedded/handbook/tuples.xml
2170
2171 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/tuples.xml?rev=1.5&view=markup
2172 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/tuples.xml?rev=1.5&content-type=text/plain
2173 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/tuples.xml?r1=1.4&r2=1.5
2174
2175 Index: tuples.xml
2176 ===================================================================
2177 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/tuples.xml,v
2178 retrieving revision 1.4
2179 retrieving revision 1.5
2180 diff -u -r1.4 -r1.5
2181 --- tuples.xml 24 Dec 2007 21:47:41 -0000 1.4
2182 +++ tuples.xml 30 Aug 2010 03:59:07 -0000 1.5
2183 @@ -1,7 +1,10 @@
2184 <?xml version='1.0' encoding='UTF-8'?>
2185 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
2186
2187 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/tuples.xml,v 1.4 2007/12/24 21:47:41 vapier Exp $ -->
2188 +<!-- The content of this document is licensed under the CC-BY-SA license -->
2189 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
2190 +
2191 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/tuples.xml,v 1.5 2010/08/30 03:59:07 nightmorph Exp $ -->
2192
2193 <sections>
2194
2195 @@ -14,8 +17,8 @@
2196
2197 <section>
2198 <title>Background</title>
2199 -
2200 <body>
2201 +
2202 <p>
2203 The <uri link="http://savannah.gnu.org/projects/config">GNU config</uri> project
2204 exists to take all known systems out there and generate a short string which
2205 @@ -24,18 +27,20 @@
2206 </p>
2207
2208 <p>
2209 -The canonicalized form is: <b>machine</b>-<b>vendor</b>-<b>kernel</b>-<b>operating system</b>.
2210 -Many tuples may actually omit the vendor field (since it is completely arbitrary).
2211 -The <b>operating system</b> field has also expanded its meaning over time to
2212 +The canonicalized form is:
2213 +<b>machine</b>-<b>vendor</b>-<b>kernel</b>-<b>operating system</b>. Many tuples
2214 +may actually omit the vendor field (since it is completely arbitrary). The
2215 +<b>operating system</b> field has also expanded its meaning over time to
2216 indicate the userland and/or userland ABI.
2217 </p>
2218 +
2219 </body>
2220 </section>
2221
2222 <section>
2223 <title>Examples</title>
2224 -
2225 <body>
2226 +
2227 <p>
2228 Here is a (by no means complete) table of many common configurations. Note
2229 that not all permutations will work as some fields (like <b>kernel</b> or
2230 @@ -45,82 +50,82 @@
2231
2232 <table>
2233 <tr>
2234 - <th>Machine</th>
2235 - <th>Vendor</th>
2236 - <th>Kernel</th>
2237 - <th>Operating System</th>
2238 + <th>Machine</th>
2239 + <th>Vendor</th>
2240 + <th>Kernel</th>
2241 + <th>Operating System</th>
2242 </tr>
2243 <tr>
2244 - <ti>
2245 - alpha <br/>
2246 - arm / armeb <br/>
2247 - avr / avr32 <br/>
2248 - bfin <br/>
2249 - cris <br/>
2250 - hppa / hppa1.1 / hppa2.0 / hppa64 <br/>
2251 - ia64 <br/>
2252 - i386 / i486 / i586 / i686 <br/>
2253 - m68k <br/>
2254 - mips / mipsel / mips64 / mips64el <br/>
2255 - nios / nios2 <br/>
2256 - powerpc / powerpc64 <br/>
2257 - sparc / sparcv8 / sparcv9 / sparc64 <br/>
2258 - s390 / s390x <br/>
2259 - sh / sh3 / sh4 / sheb / sh3eb / sh4eb / sh64 <br/>
2260 - vax <br/>
2261 - x86_64 <br/>
2262 - </ti>
2263 - <ti>
2264 - gentoo <br/>
2265 - pc <br/>
2266 - softfloat <c>[1]</c> <br/>
2267 - unknown <br/>
2268 - </ti>
2269 - <ti>
2270 - elf <c>[2]</c> <br/>
2271 - freebsd6.2 <br/>
2272 - linux <br/>
2273 - mingw32 / mingw64 <br/>
2274 - uclinux <c>[3]</c> <br/>
2275 - </ti>
2276 - <ti>
2277 - gnu <c>[4]</c> <br/>
2278 - gnueabi <c>[5]</c> <br/>
2279 - uclibc <c>[6]</c> <br/>
2280 - uclibceabi <br/>
2281 - </ti>
2282 + <ti>
2283 + alpha <br/>
2284 + arm / armeb <br/>
2285 + avr / avr32 <br/>
2286 + bfin <br/>
2287 + cris <br/>
2288 + hppa / hppa1.1 / hppa2.0 / hppa64 <br/>
2289 + ia64 <br/>
2290 + i386 / i486 / i586 / i686 <br/>
2291 + m68k <br/>
2292 + mips / mipsel / mips64 / mips64el <br/>
2293 + nios / nios2 <br/>
2294 + powerpc / powerpc64 <br/>
2295 + sparc / sparcv8 / sparcv9 / sparc64 <br/>
2296 + s390 / s390x <br/>
2297 + sh / sh3 / sh4 / sheb / sh3eb / sh4eb / sh64 <br/>
2298 + vax <br/>
2299 + x86_64 <br/>
2300 + </ti>
2301 + <ti>
2302 + gentoo <br/>
2303 + pc <br/>
2304 + softfloat <c>[1]</c> <br/>
2305 + unknown <br/>
2306 + </ti>
2307 + <ti>
2308 + elf <c>[2]</c> <br/>
2309 + freebsd6.2 <br/>
2310 + linux <br/>
2311 + mingw32 / mingw64 <br/>
2312 + uclinux <c>[3]</c> <br/>
2313 + </ti>
2314 + <ti>
2315 + gnu <c>[4]</c> <br/>
2316 + gnueabi <c>[5]</c> <br/>
2317 + uclibc <c>[6]</c> <br/>
2318 + uclibceabi <br/>
2319 + </ti>
2320 </tr>
2321 </table>
2322
2323 <ol>
2324 -<li> <!-- [1] -->
2325 -Remember that part where we said the <b>vendor</b> field was completely
2326 -arbitrary? That's almost completely true. In the Gentoo world, we've
2327 -allocated the field <e>softfloat</e> to indicate softfloat toolchains.
2328 -If you need a softfloat toolchain, make sure to set the vendor field
2329 -in your tuple with this in it.
2330 -</li>
2331 -<li> <!-- [2] -->
2332 -When you use <e>elf</e> as the operating system, you're actually saying you do
2333 -not want to run an operating system at all, but just some code directly on the
2334 -hardware. This is almost exclusively accomplished with newlib (with help from
2335 -libgloss).
2336 -</li>
2337 -<li> <!-- [3] -->
2338 -The <e>uclinux</e> field produces FLAT binaries which run on Linux with the
2339 -MMU disabled (so called no-mmu).
2340 -</li>
2341 -<li> <!-- [4] -->
2342 -The <e>gnu</e> field indicates glibc as the system libc.
2343 -</li>
2344 -<li> <!-- [5] -->
2345 -The <e>eabi</e> suffix will work on only a few embedded architectures (arm and
2346 -ppc at the moment). This tells the toolchain to generate code for the newer
2347 -Embedded ABI.
2348 -</li>
2349 -<li> <!-- [6] -->
2350 -The <e>uclibc</e> field indicates uClibc as the system libc.
2351 -</li>
2352 + <li> <!-- [1] -->
2353 + Remember that part where we said the <b>vendor</b> field was completely
2354 + arbitrary? That's almost completely true. In the Gentoo world, we've
2355 + allocated the field <e>softfloat</e> to indicate softfloat toolchains. If
2356 + you need a softfloat toolchain, make sure to set the vendor field in your
2357 + tuple with this in it.
2358 + </li>
2359 + <li> <!-- [2] -->
2360 + When you use <e>elf</e> as the operating system, you're actually saying you
2361 + do not want to run an operating system at all, but just some code directly
2362 + on the hardware. This is almost exclusively accomplished with newlib (with
2363 + help from libgloss).
2364 + </li>
2365 + <li> <!-- [3] -->
2366 + The <e>uclinux</e> field produces FLAT binaries which run on Linux with the
2367 + MMU disabled (so called no-mmu).
2368 + </li>
2369 + <li> <!-- [4] -->
2370 + The <e>gnu</e> field indicates glibc as the system libc.
2371 + </li>
2372 + <li> <!-- [5] -->
2373 + The <e>eabi</e> suffix will work on only a few embedded architectures (arm
2374 + and ppc at the moment). This tells the toolchain to generate code for the
2375 + newer Embedded ABI.
2376 + </li>
2377 + <li> <!-- [6] -->
2378 + The <e>uclibc</e> field indicates uClibc as the system libc.
2379 + </li>
2380 </ol>
2381
2382 <p>
2383
2384
2385
2386 1.2 xml/htdocs/proj/en/base/embedded/handbook/vendors.xml
2387
2388 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/vendors.xml?rev=1.2&view=markup
2389 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/vendors.xml?rev=1.2&content-type=text/plain
2390 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/proj/en/base/embedded/handbook/vendors.xml?r1=1.1&r2=1.2
2391
2392 Index: vendors.xml
2393 ===================================================================
2394 RCS file: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/vendors.xml,v
2395 retrieving revision 1.1
2396 retrieving revision 1.2
2397 diff -u -r1.1 -r1.2
2398 --- vendors.xml 26 Aug 2007 13:21:49 -0000 1.1
2399 +++ vendors.xml 30 Aug 2010 03:59:07 -0000 1.2
2400 @@ -1,7 +1,10 @@
2401 <?xml version='1.0' encoding='UTF-8'?>
2402 <!DOCTYPE sections SYSTEM "/dtd/book.dtd">
2403
2404 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/vendors.xml,v 1.1 2007/08/26 13:21:49 vapier Exp $ -->
2405 +<!-- The content of this document is licensed under the CC-BY-SA license -->
2406 +<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
2407 +
2408 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/proj/en/base/embedded/handbook/vendors.xml,v 1.2 2010/08/30 03:59:07 nightmorph Exp $ -->
2409
2410 <sections>
2411
2412 @@ -15,6 +18,7 @@
2413 <section>
2414 <title>Hardware Donations</title>
2415 <body>
2416 +
2417 <p>
2418 Obviously the first barrier to supporting something is hardware. It's hard to
2419 develop for something without hardware to actually test on. There are
2420 @@ -27,11 +31,13 @@
2421 The target of the development is to produce a firmware image which can be used
2422 on just the one device.
2423 </p>
2424 +
2425 <p>
2426 If you have hardware to spare, feel free to contact the
2427 <mail link="embedded@g.o">Gentoo Embedded team</mail> to find the best
2428 home for your donation. Thanks!
2429 </p>
2430 +
2431 </body>
2432 </section>