From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1851) id 4AA8C3896C00; Tue, 18 May 2021 09:58:33 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 4AA8C3896C00 Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Martin Liska To: gcc-cvs@gcc.gnu.org Subject: [gcc(refs/users/marxin/heads/remove-install-old.texi)] docs: port old-intall.texi part to install.texi X-Act-Checkin: gcc X-Git-Author: Martin Liska X-Git-Refname: refs/users/marxin/heads/remove-install-old.texi X-Git-Oldrev: 26d502b0e705a2045fffb56f012410fcc9423222 X-Git-Newrev: a5af817b5769abf1e58119b9b07968ca0c40bb9d Message-Id: <20210518095833.4AA8C3896C00@sourceware.org> Date: Tue, 18 May 2021 09:58:33 +0000 (GMT) X-BeenThere: gcc-cvs@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 18 May 2021 09:58:33 -0000 https://gcc.gnu.org/g:a5af817b5769abf1e58119b9b07968ca0c40bb9d commit a5af817b5769abf1e58119b9b07968ca0c40bb9d Author: Martin Liska Date: Tue May 18 11:57:47 2021 +0200 docs: port old-intall.texi part to install.texi gcc/ChangeLog: * doc/install.texi: Port relevant part from install-old.texi and re-generate list of CPUs and systems. Diff: --- gcc/doc/install.texi | 70 +++++++++++++++++++++++++++++++++++++++++----------- 1 file changed, 56 insertions(+), 14 deletions(-) diff --git a/gcc/doc/install.texi b/gcc/doc/install.texi index f0591e06b3e..92c7d5fb279 100644 --- a/gcc/doc/install.texi +++ b/gcc/doc/install.texi @@ -697,23 +697,65 @@ The default value is @uref{https://gcc.gnu.org/,,https://gcc.gnu.org/}. @end table -@heading Target specification -@itemize @bullet -@item -GCC has code to correctly determine the correct value for @var{target} -for nearly all native systems. Therefore, we highly recommend you do -not provide a configure target when configuring a native compiler. +@heading Host, Build and Target specification -@item -@var{target} must be specified as @option{--target=@var{target}} -when configuring a cross compiler; examples of valid targets would be -m68k-elf, sh-elf, etc. +Specify the host, build and target machine configurations. You do this +when you run the @file{configure} script. -@item -Specifying just @var{target} instead of @option{--target=@var{target}} -implies that the host defaults to @var{target}. -@end itemize +The @dfn{build} machine is the system which you are using, the +@dfn{host} machine is the system where you want to run the resulting +compiler (normally the build machine), and the @dfn{target} machine is +the system for which you want the compiler to generate code. + +If you are building a compiler to produce code for the machine it runs +on (a native compiler), you normally do not need to specify any operands +to @file{configure}; it will try to guess the type of machine you are on +and use that as the build, host and target machines. So you don't need +to specify a configuration when building a native compiler unless +@file{configure} cannot figure out what your configuration is or guesses +wrong. + +In those cases, specify the build machine's @dfn{configuration name} +with the @option{--host} option; the host and target will default to be +the same as the host machine. + +Here is an example: + +@smallexample +./configure --host=x86_64-pc-linux-gnu +@end smallexample +A configuration name may be canonical or it may be more or less +abbreviated (@file{config.sub} script produces canonical versions). + +A canonical configuration name has three parts, separated by dashes. +It looks like this: @samp{@var{cpu}-@var{company}-@var{system}}. + +Here are the possible CPU types: + +@quotation +aarch64, alpha, alpha64, amdgcn, arc, arceb, arm, avr, bfin, bpf, c6x, cr16, +cris, csky, epiphany, fido, fr30, frv, ft32, h8300, hppa, hppa2.0, hppa64, +i486, i686, ia64, iq2000, lm32, m32c, m32r, m32rle, m68k, mcore, microblaze, +mips, mips64, mips64el, mips64octeon, mips64orion, mips64vr, mipsel, mipsisa32, +mipsisa32r2, mipsisa64, mipsisa64r2, mipsisa64r2el, mipsisa64sb1, mipsisa64sr71k, +mipstx39, mmix, mn10300, moxie, msp430, nds32be, nds32le, nios2, nvptx, or1k, +pdp11, powerpc, powerpc64, powerpcle, ppc, pru, riscv32, riscv64, rl78, rx, +s390, s390x, sh, shle, sparc, sparc64, tilegx, tilegxbe, tilepro, v850, v850e, +v850e1, vax, visium, x86_64, xstormy16, xtensa +@end quotation + +Here is a list of system types: + +@quotation +aix7.1, aix7.2, amdhsa, androideabi, aout, cygwin, darwin, darwin10, darwin7, +darwin8, darwin9, eabi, eabialtivec, eabisim, eabisimaltivec, elf, elf32, +elfbare, elfoabi, freebsd4, freebsd6, gnu, hpux, hpux10.1, hpux11.0, hpux11.3, +hpux11.9, linux, linux_altivec, lynxos, mingw32, mingw32crt, mmixware, msdosdjgpp, +musl, netbsd, netbsdelf, netbsdelf9, none, openbsd, qnx, rtems, solaris2.11, +symbianelf, tpf, uclibc, uclinux, uclinux_eabi, vms, vxworks, vxworksae, +vxworksmils +@end quotation @heading Options specification