| blob | fb4a6d2a4e8fd2fe5acb22e438fc23a597bb95d2 |
1 --- illumos-gcc-0f5ed4c/gcc/doc/install.texi.orig
2 +++ illumos-gcc-0f5ed4c/gcc/doc/install.texi
3 @@ -2746,7 +2746,8 @@
4 <!-- -------- host/target specific issues start here ---------------- -->
5 <hr />
6 @end html
7 -@heading @anchor{alpha-x-x}alpha*-*-*
8 +@anchor{alpha-x-x}
9 +@heading alpha*-*-*
11 This section contains general configuration information for all
12 alpha-based platforms using ELF (in particular, ignore this section for
13 @@ -2761,7 +2762,8 @@
14 @html
15 <hr />
16 @end html
17 -@heading @anchor{alpha-dec-osf}alpha*-dec-osf*
18 +@anchor{alpha-dec-osf}
19 +@heading alpha*-dec-osf*
20 Systems using processors that implement the DEC Alpha architecture and
21 are running the DEC/Compaq Unix (DEC OSF/1, Digital UNIX, or Compaq
22 Tru64 UNIX) operating system, for example the DEC Alpha AXP systems.
23 @@ -2834,14 +2836,16 @@
24 @html
25 <hr />
26 @end html
27 -@heading @anchor{arc-x-elf}arc-*-elf
28 +@anchor{arc-x-elf}
29 +@heading arc-*-elf
30 Argonaut ARC processor.
31 This configuration is intended for embedded systems.
33 @html
34 <hr />
35 @end html
36 -@heading @anchor{arm-x-elf}arm-*-elf
37 +@anchor{arm-x-elf}
38 +@heading arm-*-elf
39 ARM-family processors. Subtargets that use the ELF object format
40 require GNU binutils 2.13 or newer. Such subtargets include:
41 @code{arm-*-freebsd}, @code{arm-*-netbsdelf}, @code{arm-*-*linux}
42 @@ -2850,7 +2854,8 @@
43 @html
44 <hr />
45 @end html
46 -@heading @anchor{arm-x-coff}arm-*-coff
47 +@anchor{arm-x-coff}
48 +@heading arm-*-coff
49 ARM-family processors. Note that there are two different varieties
50 of PE format subtarget supported: @code{arm-wince-pe} and
51 @code{arm-pe} as well as a standard COFF target @code{arm-*-coff}.
52 @@ -2858,14 +2863,16 @@
53 @html
54 <hr />
55 @end html
56 -@heading @anchor{arm-x-aout}arm-*-aout
57 +@anchor{arm-x-aout}
58 +@heading arm-*-aout
59 ARM-family processors. These targets support the AOUT file format:
60 @code{arm-*-aout}, @code{arm-*-netbsd}.
62 @html
63 <hr />
64 @end html
65 -@heading @anchor{avr}avr
66 +@anchor{avr}
67 +@heading avr
69 ATMEL AVR-family micro controllers. These are used in embedded
70 applications. There are no standard Unix configurations.
71 @@ -2902,7 +2909,8 @@
72 @html
73 <hr />
74 @end html
75 -@heading @anchor{bfin}Blackfin
76 +@anchor{bfin}
77 +@heading Blackfin
79 The Blackfin processor, an Analog Devices DSP.
80 @ifnothtml
81 @@ -2919,7 +2927,8 @@
82 @html
83 <hr />
84 @end html
85 -@heading @anchor{cris}CRIS
86 +@anchor{cris}
87 +@heading CRIS
89 CRIS is the CPU architecture in Axis Communications ETRAX system-on-a-chip
90 series. These are used in embedded applications.
91 @@ -2954,7 +2963,8 @@
92 @html
93 <hr />
94 @end html
95 -@heading @anchor{crx}CRX
96 +@anchor{crx}
97 +@heading CRX
99 The CRX CompactRISC architecture is a low-power 32-bit architecture with
100 fast context switching and architectural extensibility features.
101 @@ -2980,7 +2990,8 @@
102 @html
103 <hr />
104 @end html
105 -@heading @anchor{dos}DOS
106 +@anchor{dos}
107 +@heading DOS
109 Please have a look at the @uref{binaries.html,,binaries page}.
111 @@ -2992,7 +3003,8 @@
112 @html
113 <hr />
114 @end html
115 -@heading @anchor{x-x-freebsd}*-*-freebsd*
116 +@anchor{x-x-freebsd}
117 +@heading *-*-freebsd*
119 The version of binutils installed in @file{/usr/bin} probably works with
120 this release of GCC@. However, on FreeBSD 4, bootstrapping against the
121 @@ -3040,7 +3052,8 @@
122 @html
123 <hr />
124 @end html
125 -@heading @anchor{h8300-hms}h8300-hms
126 +@anchor{h8300-hms}
127 +@heading h8300-hms
128 Renesas H8/300 series of processors.
130 Please have a look at the @uref{binaries.html,,binaries page}.
131 @@ -3053,7 +3066,8 @@
132 @html
133 <hr />
134 @end html
135 -@heading @anchor{hppa-hp-hpux}hppa*-hp-hpux*
136 +@anchor{hppa-hp-hpux}
137 +@heading hppa*-hp-hpux*
138 Support for HP-UX version 9 and older was discontinued in GCC 3.4.
140 We require using gas/binutils on all hppa platforms. Version 2.19 or
141 @@ -3105,7 +3119,8 @@
142 @html
143 <hr />
144 @end html
145 -@heading @anchor{hppa-hp-hpux10}hppa*-hp-hpux10
146 +@anchor{hppa-hp-hpux10}
147 +@heading hppa*-hp-hpux10
149 For hpux10.20, we @emph{highly} recommend you pick up the latest sed patch
150 @code{PHCO_19798} from HP@. HP has two sites which provide patches free of
151 @@ -3133,7 +3148,8 @@
152 @html
153 <hr />
154 @end html
155 -@heading @anchor{hppa-hp-hpux11}hppa*-hp-hpux11
156 +@anchor{hppa-hp-hpux11}
157 +@heading hppa*-hp-hpux11
159 GCC 3.0 and up support HP-UX 11. GCC 2.95.x is not supported and cannot
160 be used to compile GCC 3.0 and up.
161 @@ -3244,7 +3260,8 @@
162 @html
163 <hr />
164 @end html
165 -@heading @anchor{x-x-linux-gnu}*-*-linux-gnu
166 +@anchor{x-x-linux-gnu}
167 +@heading *-*-linux-gnu
169 Versions of libstdc++-v3 starting with 3.2.1 require bug fixes present
170 in glibc 2.2.5 and later. More information is available in the
171 @@ -3253,7 +3270,8 @@
172 @html
173 <hr />
174 @end html
175 -@heading @anchor{ix86-x-linux}i?86-*-linux*
176 +@anchor{ix86-x-linux}
177 +@heading i?86-*-linux*
179 As of GCC 3.3, binutils 2.13.1 or later is required for this platform.
180 See @uref{http://gcc.gnu.org/PR10877,,bug 10877} for more information.
181 @@ -3265,7 +3283,8 @@
182 @html
183 <hr />
184 @end html
185 -@heading @anchor{ix86-x-solaris210}i?86-*-solaris2.10
186 +@anchor{ix86-x-solaris210}
187 +@heading i?86-*-solaris2.10
188 Use this for Solaris 10 or later on x86 and x86-64 systems. This
189 configuration is supported by GCC 4.0 and later versions only.
191 @@ -3277,7 +3296,8 @@
192 @html
193 <hr />
194 @end html
195 -@heading @anchor{ia64-x-linux}ia64-*-linux
196 +@anchor{ia64-x-linux}
197 +@heading ia64-*-linux
198 IA-64 processor (also known as IPF, or Itanium Processor Family)
199 running GNU/Linux.
201 @@ -3297,7 +3317,8 @@
202 @html
203 <hr />
204 @end html
205 -@heading @anchor{ia64-x-hpux}ia64-*-hpux*
206 +@anchor{ia64-x-hpux}
207 +@heading ia64-*-hpux*
208 Building GCC on this target requires the GNU Assembler. The bundled HP
209 assembler will not work. To prevent GCC from using the wrong assembler,
210 the option @option{--with-gnu-as} may be necessary.
211 @@ -3312,7 +3333,8 @@
212 <hr />
213 <!-- rs6000-ibm-aix*, powerpc-ibm-aix* -->
214 @end html
215 -@heading @anchor{x-ibm-aix}*-ibm-aix*
216 +@anchor{x-ibm-aix}
217 +@heading *-ibm-aix*
218 Support for AIX version 3 and older was discontinued in GCC 3.4.
220 ``out of memory'' bootstrap failures may indicate a problem with
221 @@ -3443,42 +3465,48 @@
222 @html
223 <hr />
224 @end html
225 -@heading @anchor{iq2000-x-elf}iq2000-*-elf
226 +@anchor{iq2000-x-elf}
227 +@heading iq2000-*-elf
228 Vitesse IQ2000 processors. These are used in embedded
229 applications. There are no standard Unix configurations.
231 @html
232 <hr />
233 @end html
234 -@heading @anchor{m32c-x-elf}m32c-*-elf
235 +@anchor{m32c-x-elf}
236 +@heading m32c-*-elf
237 Renesas M32C processor.
238 This configuration is intended for embedded systems.
240 @html
241 <hr />
242 @end html
243 -@heading @anchor{m32r-x-elf}m32r-*-elf
244 +@anchor{m32r-x-elf}
245 +@heading m32r-*-elf
246 Renesas M32R processor.
247 This configuration is intended for embedded systems.
249 @html
250 <hr />
251 @end html
252 -@heading @anchor{m6811-elf}m6811-elf
253 +@anchor{m6811-elf}
254 +@heading m6811-elf
255 Motorola 68HC11 family micro controllers. These are used in embedded
256 applications. There are no standard Unix configurations.
258 @html
259 <hr />
260 @end html
261 -@heading @anchor{m6812-elf}m6812-elf
262 +@anchor{m6812-elf}
263 +@heading m6812-elf
264 Motorola 68HC12 family micro controllers. These are used in embedded
265 applications. There are no standard Unix configurations.
267 @html
268 <hr />
269 @end html
270 -@heading @anchor{m68k-x-x}m68k-*-*
271 +@anchor{m68k-x-x}
272 +@heading m68k-*-*
273 By default, @samp{m68k-*-aout}, @samp{m68k-*-coff*},
274 @samp{m68k-*-elf*}, @samp{m68k-*-rtems}, @samp{m68k-*-uclinux} and
275 @samp{m68k-*-linux}
276 @@ -3504,7 +3532,8 @@
277 @html
278 <hr />
279 @end html
280 -@heading @anchor{m68k-x-uclinux}m68k-*-uclinux
281 +@anchor{m68k-x-uclinux}
282 +@heading m68k-*-uclinux
283 GCC 4.3 changed the uClinux configuration so that it uses the
284 @samp{m68k-linux-gnu} ABI rather than the @samp{m68k-elf} ABI.
285 It also added improved support for C++ and flat shared libraries,
286 @@ -3515,7 +3544,8 @@
287 @html
288 <hr />
289 @end html
290 -@heading @anchor{mips-x-x}mips-*-*
291 +@anchor{mips-x-x}
292 +@heading mips-*-*
293 If on a MIPS system you get an error message saying ``does not have gp
294 sections for all it's [sic] sectons [sic]'', don't worry about it. This
295 happens whenever you use GAS with the MIPS linker, but there is not
296 @@ -3573,7 +3603,8 @@
297 @html
298 <hr />
299 @end html
300 -@heading @anchor{mips-sgi-irix5}mips-sgi-irix5
301 +@anchor{mips-sgi-irix5}
302 +@heading mips-sgi-irix5
304 In order to compile GCC on an SGI running IRIX 5, the @samp{compiler_dev.hdr}
305 subsystem must be installed from the IDO CD-ROM supplied by SGI@.
306 @@ -3603,7 +3634,8 @@
307 @html
308 <hr />
309 @end html
310 -@heading @anchor{mips-sgi-irix6}mips-sgi-irix6
311 +@anchor{mips-sgi-irix6}
312 +@heading mips-sgi-irix6
314 If you are using SGI's MIPSpro @command{cc} as your bootstrap compiler, you must
315 ensure that the N32 ABI is in use. To test this, compile a simple C
316 @@ -3687,7 +3719,8 @@
317 @html
318 <hr />
319 @end html
320 -@heading @anchor{powerpc-x-x}powerpc-*-*
321 +@anchor{powerpc-x-x}
322 +@heading powerpc-*-*
324 You can specify a default version for the @option{-mcpu=@var{cpu_type}}
325 switch by using the configure option @option{--with-cpu-@var{cpu_type}}.
326 @@ -3699,7 +3732,8 @@
327 @html
328 <hr />
329 @end html
330 -@heading @anchor{powerpc-x-darwin}powerpc-*-darwin*
331 +@anchor{powerpc-x-darwin}
332 +@heading powerpc-*-darwin*
333 PowerPC running Darwin (Mac OS X kernel).
335 Pre-installed versions of Mac OS X may not include any developer tools,
336 @@ -3716,70 +3750,81 @@
337 @html
338 <hr />
339 @end html
340 -@heading @anchor{powerpc-x-elf}powerpc-*-elf
341 +@anchor{powerpc-x-elf}
342 +@heading powerpc-*-elf
343 PowerPC system in big endian mode, running System V.4.
345 @html
346 <hr />
347 @end html
348 -@heading @anchor{powerpc-x-linux-gnu}powerpc*-*-linux-gnu*
349 +@anchor{powerpc-x-linux-gnu}
350 +@heading powerpc*-*-linux-gnu*
352 PowerPC system in big endian mode running Linux.
354 @html
355 <hr />
356 @end html
357 -@heading @anchor{powerpc-x-netbsd}powerpc-*-netbsd*
358 +@anchor{powerpc-x-netbsd}
359 +@heading powerpc-*-netbsd*
360 PowerPC system in big endian mode running NetBSD@.
362 @html
363 <hr />
364 @end html
365 -@heading @anchor{powerpc-x-eabisim}powerpc-*-eabisim
366 +@anchor{powerpc-x-eabisim}
367 +@heading powerpc-*-eabisim
368 Embedded PowerPC system in big endian mode for use in running under the
369 PSIM simulator.
371 @html
372 <hr />
373 @end html
374 -@heading @anchor{powerpc-x-eabi}powerpc-*-eabi
375 +@anchor{powerpc-x-eabi}
376 +@heading powerpc-*-eabi
377 Embedded PowerPC system in big endian mode.
379 @html
380 <hr />
381 @end html
382 -@heading @anchor{powerpcle-x-elf}powerpcle-*-elf
383 +@anchor{powerpcle-x-elf}
384 +@heading powerpcle-*-elf
385 PowerPC system in little endian mode, running System V.4.
387 @html
388 <hr />
389 @end html
390 -@heading @anchor{powerpcle-x-eabisim}powerpcle-*-eabisim
391 +@anchor{powerpcle-x-eabisim}
392 +@heading powerpcle-*-eabisim
393 Embedded PowerPC system in little endian mode for use in running under
394 the PSIM simulator.
396 @html
397 <hr />
398 @end html
399 -@heading @anchor{powerpcle-x-eabi}powerpcle-*-eabi
400 +@anchor{powerpcle-x-eabi}
401 +@heading powerpcle-*-eabi
402 Embedded PowerPC system in little endian mode.
404 @html
405 <hr />
406 @end html
407 -@heading @anchor{s390-x-linux}s390-*-linux*
408 +@anchor{s390-x-linux}
409 +@heading s390-*-linux*
410 S/390 system running GNU/Linux for S/390@.
412 @html
413 <hr />
414 @end html
415 -@heading @anchor{s390x-x-linux}s390x-*-linux*
416 +@anchor{s390x-x-linux}
417 +@heading s390x-*-linux*
418 zSeries system (64-bit) running GNU/Linux for zSeries@.
420 @html
421 <hr />
422 @end html
423 -@heading @anchor{s390x-ibm-tpf}s390x-ibm-tpf*
424 +@anchor{s390x-ibm-tpf}
425 +@heading s390x-ibm-tpf*
426 zSeries system (64-bit) running TPF@. This platform is
427 supported as cross-compilation target only.
429 @@ -3790,7 +3835,8 @@
430 @c with 2.0 until 2.6, 7, 8, etc. Solaris 1 was a marketing name for
431 @c SunOS 4 releases which we don't use to avoid confusion. Solaris
432 @c alone is too unspecific and must be avoided.
433 -@heading @anchor{x-x-solaris2}*-*-solaris2*
434 +@anchor{x-x-solaris2}
435 +@heading *-*-solaris2*
437 Sun does not ship a C compiler with Solaris 2. To bootstrap and install
438 GCC you first have to install a pre-built compiler, see the
439 @@ -3880,7 +3926,8 @@
440 @html
441 <hr />
442 @end html
443 -@heading @anchor{sparc-sun-solaris2}sparc-sun-solaris2*
444 +@anchor{sparc-sun-solaris2}
445 +@heading sparc-sun-solaris2*
447 When GCC is configured to use binutils 2.14 or later the binaries
448 produced are smaller than the ones produced using Sun's native tools;
449 @@ -3942,7 +3989,8 @@
450 @html
451 <hr />
452 @end html
453 -@heading @anchor{sparc-sun-solaris27}sparc-sun-solaris2.7
454 +@anchor{sparc-sun-solaris27}
455 +@heading sparc-sun-solaris2.7
457 Sun patch 107058-01 (1999-01-13) for Solaris 7/SPARC triggers a bug in
458 the dynamic linker. This problem (Sun bug 4210064) affects GCC 2.8
459 @@ -4004,7 +4052,8 @@
460 @html
461 <hr />
462 @end html
463 -@heading @anchor{sparc-x-linux}sparc-*-linux*
464 +@anchor{sparc-x-linux}
465 +@heading sparc-*-linux*
467 GCC versions 3.0 and higher require binutils 2.11.2 and glibc 2.2.4
468 or newer on this platform. All earlier binutils and glibc
469 @@ -4014,7 +4063,8 @@
470 @html
471 <hr />
472 @end html
473 -@heading @anchor{sparc64-x-solaris2}sparc64-*-solaris2*
474 +@anchor{sparc64-x-solaris2}
475 +@heading sparc64-*-solaris2*
477 When configuring the GNU Multiple Precision Library (GMP) or the
478 MPFR library, the canonical target triplet must be specified as
479 @@ -4038,14 +4088,16 @@
480 @html
481 <hr />
482 @end html
483 -@heading @anchor{sparcv9-x-solaris2}sparcv9-*-solaris2*
484 +@anchor{sparcv9-x-solaris2}
485 +@heading sparcv9-*-solaris2*
487 This is a synonym for sparc64-*-solaris2*.
489 @html
490 <hr />
491 @end html
492 -@heading @anchor{x-x-vxworks}*-*-vxworks*
493 +@anchor{x-x-vxworks}
494 +@heading *-*-vxworks*
495 Support for VxWorks is in flux. At present GCC supports @emph{only} the
496 very recent VxWorks 5.5 (aka Tornado 2.2) release, and only on PowerPC@.
497 We welcome patches for other architectures supported by VxWorks 5.5.
498 @@ -4080,7 +4132,8 @@
499 @html
500 <hr />
501 @end html
502 -@heading @anchor{x86-64-x-x}x86_64-*-*, amd64-*-*
503 +@anchor{x86-64-x-x}
504 +@heading x86_64-*-*, amd64-*-*
506 GCC supports the x86-64 architecture implemented by the AMD64 processor
507 (amd64-*-* is an alias for x86_64-*-*) on GNU/Linux, FreeBSD and NetBSD@.
508 @@ -4090,7 +4143,8 @@
509 @html
510 <hr />
511 @end html
512 -@heading @anchor{xtensa-x-elf}xtensa*-*-elf
513 +@anchor{xtensa-x-elf}
514 +@heading xtensa*-*-elf
516 This target is intended for embedded Xtensa systems using the
517 @samp{newlib} C library. It uses ELF but does not support shared
518 @@ -4108,7 +4162,8 @@
519 @html
520 <hr />
521 @end html
522 -@heading @anchor{xtensa-x-linux}xtensa*-*-linux*
523 +@anchor{xtensa-x-linux}
524 +@heading xtensa*-*-linux*
526 This target is for Xtensa systems running GNU/Linux. It supports ELF
527 shared objects and the GNU C library (glibc). It also generates
528 @@ -4120,7 +4175,8 @@
529 @html
530 <hr />
531 @end html
532 -@heading @anchor{windows}Microsoft Windows
533 +@anchor{windows}
534 +@heading Microsoft Windows
536 @subheading Intel 16-bit versions
537 The 16-bit versions of Microsoft Windows, such as Windows 3.1, are not
538 @@ -4177,7 +4233,8 @@
539 @html
540 <hr />
541 @end html
542 -@heading @anchor{x-x-cygwin}*-*-cygwin
543 +@anchor{x-x-cygwin}
544 +@heading *-*-cygwin
546 Ports of GCC are included with the
547 @uref{http://www.cygwin.com/,,Cygwin environment}.
548 @@ -4190,7 +4247,8 @@
549 @html
550 <hr />
551 @end html
552 -@heading @anchor{x-x-interix}*-*-interix
553 +@anchor{x-x-interix}
554 +@heading *-*-interix
556 The Interix target is used by OpenNT, Interix, Services For UNIX (SFU),
557 and Subsystem for UNIX-based Applications (SUA). Applications compiled
558 @@ -4202,7 +4260,8 @@
559 @html
560 <hr />
561 @end html
562 -@heading @anchor{x-x-mingw32}*-*-mingw32
563 +@anchor{x-x-mingw32}
564 +@heading *-*-mingw32
566 GCC will build with and support only MinGW runtime 3.12 and later.
567 Earlier versions of headers are incompatible with the new default semantics
568 @@ -4211,7 +4270,8 @@
569 @html
570 <hr />
571 @end html
572 -@heading @anchor{os2}OS/2
573 +@anchor{os2}
574 +@heading OS/2
576 GCC does not currently support OS/2. However, Andrew Zabolotny has been
577 working on a generic OS/2 port with pgcc. The current code can be found
578 @@ -4220,7 +4280,8 @@
579 @html
580 <hr />
581 @end html
582 -@heading @anchor{older}Older systems
583 +@anchor{older}
584 +@heading Older systems
586 GCC contains support files for many older (1980s and early
587 1990s) Unix variants. For the most part, support for these systems
588 @@ -4266,7 +4327,8 @@
589 @html
590 <hr />
591 @end html
592 -@heading @anchor{elf}all ELF targets (SVR4, Solaris 2, etc.)
593 +@anchor{elf}
594 +@heading all ELF targets (SVR4, Solaris 2, etc.)
596 C++ support is significantly better on ELF targets if you use the
597 @uref{./configure.html#with-gnu-ld,,GNU linker}; duplicate copies of