components/openindiana/illumos-gcc/patches/02-install.texi.patch

   1 --- illumos-gcc-0f5ed4c/gcc/doc/install.texi.1  2016-12-04 14:04:50.730758034 +0300
   2 +++ illumos-gcc-0f5ed4c/gcc/doc/install.texi    2016-12-04 14:04:59.989400991 +0300
   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*-*-*
  10
  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.
  32
  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}.
  61
  62  @html
  63  <hr />
  64  @end html
  65 -@heading @anchor{avr}avr
  66 +@anchor{avr}
  67 +@heading avr
  68
  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
  78
  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
  88
  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
  98
  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
 108
 109  Please have a look at the @uref{binaries.html,,binaries page}.
 110
 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*
 118
 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.
 129
 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.
 139
 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
 148
 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
 158
 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
 168
 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*
 178
 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.
 190
 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.
 200
 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.
 219
 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.
 230
 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.
 239
 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.
 248
 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.
 257
 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.
 266
 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
 303
 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
 313
 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-*-*
 323
 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).
 334
 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.
 344
 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*
 351
 352  PowerPC system in big endian mode running Linux.
 353
 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@.
 361
 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.
 370
 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.
 378
 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.
 386
 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.
 395
 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.
 403
 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@.
 411
 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@.
 419
 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.
 428
 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*
 436
 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*
 446
 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
 456
 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*
 466
 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*
 476
 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*
 486
 487  This is a synonym for sparc64-*-solaris2*.
 488
 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-*-*
 505
 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
 515
 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*
 525
 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
 535
 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
 545
 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
 555
 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
 565
 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
 575
 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
 585
 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.)
 595
 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