GCC安装手册
这是一份在Unix系统上安装GNU CC的程序，VMS系统的使用者请看
*注解:VMS 安装。在这一节中，我们假设编译的动作是在和
原始档案相同的目录下执行;如果希望在其他目录下执行编译动
作，请看 *注解:其他目录。
在MS-DOS下直接安装 GNU CC 是不可行的，使用 DOS 下的任何
编译器皆无法成功的编译 GNU CC，除非你使用 GNU CC 本身。欲
在 MS-DOS 下安装 GNU CC，你必需取得已完全编译完成的套件：DJGPP。
DJGPP 中含有机器码档案以及原始程式档，并且还包含了所有必需的
编译工具及函式库。
1.如果你是在另外一部机器上，在同一目录下先完成了GNU CC的
编译，执行 "make distclean" 来删除一些可能无用的档案。
其中一个被删除的档案叫做 "Makefile"；如果 "make distclean"
回应 Makefile 不存在（not exist）的讯息，那可能表示这个目
录已经被适当的清理完毕。
2.在 System V Release 4 系统上，请确定在路径 "PATH" 设定中，
"/usr/bin" 在 "/usr/ucb" 之前。因为 "/usr/ucb" 中的 cc 使用了
有错误的函式库。
3.你可以执行 "configure" 这支程式来设定 host machine、build machine
、及 target machine。
所谓的 "build machine" 指的是你目前正在使用的机器；而
"host machine" 则是你期望编译後所产生的编译器工作的
机器；最後 "target machine" 则是你期望这个编译器
（正在做编译的那个）产生的目的码的主机。（一般而言，
前两者是相同的）。
如果你正在建立一的产生它自己执行的机器的目的码的编译器
（native compiler），一般而言，不需要在 "configure" 作
任何的设定；它将以目前正在使用的机器作为 host、build 及
target machine。所以当你制作 native compiler 的时候，不需
作任何设定。除非 "configure" 无法指出你的系统组态或是它猜
错了。
这样的情况下，用选项 --build 指定 build machine 的
"configuration name"； host 及 target machine 将预设和 build
machine相同。（若你正在建立的是一个交互编译器，请看
*注解:交互编译器）
底下是一个例子：
./configure --build=sparc-sun-sunos4.1
建置名 (configuration name) 可能是一个标准的形式或者是标准形
式的缩写。
一个完整的建置名有由 "-" 号分开的三个部份。大概是：
"CPU名称-厂商名称-系统名称"（每一个部份可含有自己的
"-" 号，configure 这个程式会自行分辨之）。举例来说：
"m68k-sun-sunos4.1" 是指 Sun 3。
你也可以用别名取代部份的建置名。例如： `sun3' 就代表了 `m68k-sun'
，`sun3-sunos4.1' 也是另一种 Sun 3 的表示方法。你也可以简单点用
`sun3-sunos'，因为这边假设 SunOS 的版本预设为 4. `sun3-bsd' 也可
以，因为 `configure' 知道 SunOS 是 Sun 3 上唯一的 BSD 变种。
你可以在各种系统型态後面注明版本号码，及 CPU 型号。在大部份的例子
当中，版本是没用的，而且会被忽略掉。所以如果你知道的话，最好也把
号码加上去。(ranma 注：这段原文怪怪的)
关於所支援的建置名与建置的相关注解，请参考 *注解:建置。在继续安装
GNU CC 之前，你最好看一下那份注解。
底下有四种附加的选项可以让你分别指定不同的硬体与软体建置：
`--with-gnu-as', `with-gnu-ld`, `--with-stabs' 及 `--nfp'。
`--with-gnu-as'
如果你想要将 GNU CC 拿来跟 GNU 组译器 (GNU assembler)
并用的话，你可以在执行 `configure' 时加上 `--with-gnu-as' 这
个选项。
使用这个选项并不会安装 GAS。 它只是将 GNU CC 的输出修改成可以
和 GAS 并用而已。要不要安装 GAS 由你自己决定。
相反地，如果你 *不要* 使用 GAS 而且在建构 GNU CC 时不注明
`--with-gnu-as' 的话，你也要自己决定是不是要安装 GAS。 GNU CC
会在各个目录□找 `as' 这个程式，如果它找到了 GAS 的话，它会用
GAS。如果你不确定 GNU CC 到底是找到哪一个组译器来用的话，在
执行 gcc 时加上 `-v' 这个选项。
会因为你是否使用 GAS 而产生不同变化的系统有：
`hppa1.0-ANY-ANY', `hppa1.1-ANY-ANY', `i386-ANY-sysv',
`i386-ANY-isc',
`i860-ANY-bsd', `m68k-bull-sysv', `m68k-hp-hpux',
`m68k-sony-bsd',
`m68k-altos-sysv', `m68000-hp-hpux', `m68000-att-sysv',
`ANY-lynx-lynxos', 及 `mips-ANY'). 对於其他系统,
`--with-gnu-as' 并不会造成影响。
上述系统中 (除了 HP-PA, 386 上的 ISC, 及 `mips-sgi-irix5.*')，
如果你使用 GAS，你也应该要使用 GNU 连结器 (linker)，也就是要
注明 `--with-gnu-ld'。
`--with-gnu-ld'
如果你想要拿 GNU 连结器跟 GNU CC 并用的话，注明这个选项。
这个选项并不会安装 GNU 连结器，它只是改变 GNU CC 的习性来
配合 GNU 连结器而已。比较不同的是，它使得 `collet2' 这个程式
不会被安装。这个程式是在大部份的建构中拿来做系统连结器的前
置处理用的。
`--with-stabs'
在大部份以 MIPS 为基础的系统以及 Alpha 上，你必须指明
要 GNU CC 产生出正规的 ECOFF 除错格式，或是要 BSD 式的
stabs 传递 ECOFF 的符号表。正规的 ECOFF 除错格式并不能完整地
处理 C 以外的语言。而 BSD stabs 格式可以处理其他语言，但只能
在 GNU 除错器 (GNU debugger) 上面做。
在正常情况下，GNU CC 预设使用 ECOFF 除错格式，如果你偏好 BSD
stabs 格式，在编译时注明 `--with-stabs'。
不管你在建立 GNU CC 时是选用哪一种预设值，使用者都可以用
`-gcoff' 和 `-gstabs+' 这两个选项来指定他所要用的除错格式。
`--with-stabs' 在 386 上的 ISC 系统中有特别意义，当 `--with-gas'
也被用到时。它会选择使用嵌在 COFF 输出中的 stabs 除错资讯
(stabs debugging information embedded in COFF output) 。这类的
除错资讯也支援 C++，普通的 COFF 除错资讯并不能做到。
`--with-stabs' 在跑 SVR4 的 386 系统中也有特殊意义。它选择使
用嵌在 ELF 输出中的 stabs 除错资讯。在 386 SVR4 平台上，目前的
C++ 编译器 (2.6.0 版) 并不支援 DWARF 除错资讯。stabs 提供了
另一个可以用的方法。它需要 GAS 和 GDB，因为正常的 SVR4 工具并
不能产生或解译 stabs 格式。
`--nfp'
在某些系统上，你必须藉由这个选项注明这台机器是否有浮点运
算器。这些系统包括了 `m68k-sun-sunosN' 及 `m68k-isi-bsd'。目前
`--nfp' 在其他系统上并没有作用，虽然在别的系统上可能也可以有不
同的效果。
`configure' 这个程式会去原始码目录底下的子目录□面去找那些要跟
GNU CC 整合的其他编译器。例如 GNU 的 C++ 编译器，G++，放在 `cp'
这个子目录□。`configure' 会把建立这些编译器的规则加到 `Makefile'
中。
底下我们会详细说明所有 `configure' 会设定的档案。在正常情况下，
你不需要去担心这些档案。
* 会建立一个叫 `config.h' 的档案，□面有一个 `#include' 记载了你
将来要用来执行这个编译器行的机器的顶层设定档 (*注解:建置)。这个档
案用来定义 host machine 的资讯。其中包含 `tm.h'。
顶层设定档放在 `config' 这个子目录□。它都叫做 `xm-某某东西.h'，
通常是 `xm-机器名.h'，但有些例外。
如果你的系统不支援符号连结 (symbolic link)，你可以要设定 `config.h'
让它包含一条 `#include' 指到适当的档案。
* 会建立一个叫 `tconfig.h' 的档案，它引入了 target machine 的顶层
设定档。这是为了要用来编译一些要在那台机器上跑的程式。
* 会建立一个叫 `tm.h' 的档案，它包含了 target machine 的机器描述
巨集档案 (machine-description macro file)。它应该是放在 `config'
子目录中而且它的名字通常是 `机器名.h'。
* `configure' 这个命令档也会在 `Makefile.in' 这个样版档上加入一些字
来产生 `Makefile'。 这些额外的文字来自 `config' 目录中叫做
`t-TARGET' 及 `x-HOST' 的档案。如果这些档案不存在，那就表示不需
要为 target 或 host machine 加上其他东西。
4. 安装 GNU CC 的标准目录是 `/usr/local/lib'。如果你打算安装到别的地方，
在执行 `configure' 的注明 `--previx=目录'。`目录' 是你打算用来取代
`/usr/local' 的目录名称，除了底下这个例外： 不管你的编译器安装在何处，
`/usr/local/include' 都是会被加到找寻标头档的目录。如果你不想要这样，
你可以用下面这个 `--local-prefix' 选项。
5. 指定 `--local-prefix=目录'，这样可以让你设定编译器找寻标头档的路径。
而不是使用 `/usr/local/include'。
*只有* 在你的电脑上放你特殊的规格档案有不同习惯 (不是 `/usr/local')
时，你才会需要 `--local-prefix' 这个选项。
*不要* 把 `/usr' 指定给 `--local-prefix'！你在 `--local-prefix' 所
用的目录 *必须不* 包含所有的系统标准标头档。如果它真的包含，某些程
式会被编译成错的。(包括 GNU Emacs, 在某些目标机器上)，因为这样做会
盖掉或搞丢 `fixincludes' 所定的标头档案集。
6. 确定 Bison 剖析器产生机 (parser generator) 已经安装。(如果 Bison
所产生出来的 `c-parse.c' 跟 `cexp.c' 这两个档案比 `c-parse.y' 跟
`cexp.y' 还新，而且你不打算改这些 `.y' 档的话，这步就不用做。
在 1988 年 9 月 8 号之前的 Bison 版本会产生不正确的 `c-parse.c'。
7. 如果你选择了一个需要其他 GNU 工具(像是 GAS 或 GNU 连结器) 而不是
标准系统工具的组态来做 GNU CC 的话，记得在建立 GNU CC 的目录底下
安装所需的工具，并命名为 `as', 'ld' 或其他相关名称。这样会使得编
译器会在编译 `enquire' 时去找这些适当的工具。
或者是，你可以在做後来的编译工作时把 `PATH' 环境变数值设成 GNU
工具在标准系统工具之前。
8. 建立这个编译器。只要在编译器目录□打入 `make LANGUAGES=c' 就好了。
`LANGUAGES=c' 指明了只会编译 C 编译器。makefile 正常下会去编译所有
它支援的语言，目前是 C, C++ 和 Objective C。然而，只有 C 是你用其
他非 GNU C 编译器所编出来的会动的一个。再说，在这个阶段编译 C 以外
的东西是在浪费时间。
通常，你可以打入这个参数 `LANGUAGES="LIST"' 指明你要的语言，其中
"LIST" 是 `c', `c++' 和 `objective-c' 之一或多个。如果你在 GNU CC
原始码目碌下有其他附加的 GNU 编译器，你会可以加到 `LIST' □面。
忽略掉在编 `insn-emit.c' 时所有 "statement not reached"
的警告讯息，那是正常的。还有，警告讯息 "unknown escape sequence" 在
编 `genopinit.c' 或是其他档案是也是正常的。同理，你也可以不理那些
在 `insn-emit.c' 和 `insn-recog.c' 的 "constant is so large that it
is unsigned" 和 `enquire.o' □的关於 "comparison always being zero"
。 其他编译错误可能表示了移植到你的机器或作业系统时的错误，你应该
仔细检查并提出报告 (附注：虫)。
有些要钱的编译器因为它们本身的虫或是限制，在编 GNU CC 时会失败。例如
Microsoft 的编译器说会用光所有巨集空间。有的 Ultrix 的编译器会用完
表示式空间，你必需分开问题发生处的叙述。
9. 如果你在做交互编译器，就此打住。 *附注：交互编译器
10. 用底下这个命令把第一阶段目的档案和可执行档案放到一个目录：
make stage1
这些档案会放到一个叫 `stage1' 的副目录□。当安装完成以後，你或许
会用 `rm -r stage` 把这些档案杀掉。
11. 如果你选择了一个需要其他 GNU 工具(像是 GAS 或 GNU 连结器) 而不是
标准系统工具的组态来做 GNU CC 的话，把这些要用的工具放在 `stage1'
子目录下，并命名为 `as', `ld' 或相关档名。这样会使得在做下一阶段
时第一阶段编译器会在这□找适合的工具。
或者是，你可以在做後续的编译工作时把 `PATH' 环境变数值设成 GNU
工具在标准系统工具之前。
12. 用底下这个命令叫这个编译器自己再重新编译一次：
make CC="stage1/xgcc -Bstage1/" CFLAGS="-g -O2"
这叫做建造第二阶段编译器。
上面这个命令会造出所有支援语言的编译器。如果你不要全部都做，你可以
用 `LANGUAGES="LIST"' 注明你要做的语言。 LIST 可以包含 `c', `c++',
`objective-c' 和 `proto' 之一或多个，以空白分开。`proto' 是指
`protoize' 和 `unprotoize' 这两个程式，它们不是一个独立的语言，
但是你是用 `LANGUAGES' 决定要不要安装它们。
如果你还要继续做第三阶段编译器，那你只要在第二阶段做出 C 语言就好了。
当你做完第二阶段编译器以後，如果磁碟空间快没了，你可以砍掉 `stage1'
这个子目录。
在没有浮点运算硬体的 68000 或 68020 系统上，除非你已经选了一个预设
没有浮点运算器的 `tm.h' 档，不然就用底下这个：
make CC="stage1/xgcc -Bstage1/" CFLAGS="-g -O2 -msoft-float"
13. 如果你想以叫这个编译器再编译它自己一次来测试它的话，把其他需要的
GNU 工具 (像是 GAS 或 GNU linker) 放在 `stage2' 子目录□，就像在
你之前在 `stage1' 子目录□做的一样，然後：
make stage2
make CC="stage2/xgcc -Bstage2/" CFLAGS="-g -O2"
这叫做建造第三阶段编译器。 除了 `-B' 选项，编译选项都跟你在做第二
阶段编译器时一样。但是 `LANGUAGES' 这个选项不一定要一样。上面这个
命令会做出所有支援的编译器。如果你不要全部都做，你可以用如前所述的
`LANGUAGES="LIST"' 选项指定你要的语言。
如果你不需要安装任何附加的 GNU 工具，你可能要用底下这个命令
make bootstrap LANGUAGES=LANGUAGE-LIST BOOT_CFLAGS=OPTION-LIST
而不是做 `stage1', `stage2'，并执行它们做出来的东西。
14. 然後是比较第二阶段目的档跟最後的目的档 -- 除了时间戳记 (time stamp)
之外，它们应该要一样才对。
在某些系统上，有意义的比较目的档是不可能的；它们总是显示 "不同"。
目前在 Solaris 和一些使用 ELF 目的档格式的系统上都会发生。在某些版本
的 SGI 机器上的 Irix 和 Alpha 系统上的 DEC Unix (OSF/1)，你不可能不指
定 `-save-temps' 而比较这些档案。如果你在比较上出了错，去看看上述个别
系统的说明。你在其他系统上也可能发生类似问题。
用这个命令来比较档案：
make compare
它会提到所有第二阶段和第三阶段的目的档的不同。有任何不同的话，不管是
多麽无害，都显示 GNU CC 在第二阶段把编译器做错了，所以有可能有严重
的错误。你应该检查并提出报告。(*附注：虫)
如果你的系统不会在目的档上放时间戳记，有一个比较快的方法来比较它们
(用 Bourne shell)：
for file in *.o; do
cmp $file stage2/$file
done
如果你是在 MIPS 的机器上用了 `-mno-mips-tfile' 选项，你将没办法去
比较这些档案。
15. 打 `make install' 安装编译器驱动程式，这□面包括了编译器的各个
阶段 (pass) 和执行时期支援。在 `CC', `CFLAG', `LANGUAGES' □用
跟你在做编译时用一样的值。这样做有个必需的理由是因为某些版本的
make □面有虫，会莫名其妙地重新编译档案。假如你指定了一样的变数
值，那些档案会适当地被重编译。
举例来说，假如你已经建立好第二阶段编译器，你可以用底下的命令：
make install CC="stage2/xgcc -Bstage2/" CFLAGS="-g -O" LANGUAGES="LIST"
这样做会把 `cc1',`cpp' 跟 `libgcc.a' 拷贝到
`/usr/local/lib/gcc-lib/TARGET/VERSION' 这个目录□，这个目录是编译器
驱动程式用来找这些档案的地方。TARGET 是你在执行 `configure' 时所指定的
目标机器型态，而 VERSION 是 GNU CC 的版本号码。这种命名方法是为了要
使得不同版本及/或交互编译器可以同时存在。
这样做也会把驱动程式 `xgcc' 放在 `/usr/local/bin/gcc' □面，使得它
在典型的执行搜寻路径□出现。
在某些系统上，这个命令会使得某些档案被重新编译。这通常是 `make' 的
错。你可以忽略掉这个问题，或是使用 GNU Make。
*警告* Sun 的函式库中的 `alloca' 是有错的。要避免掉这个错误，确定
你安装了用 GNU CC 所编译出来的 GNU CC 可执行档。(就是说，第二阶段
或第三阶段的可执行档，而不是第一阶段的) 它们会把 `alloca' 当成是
内建函数，而不会用到函数库中的那一个。
(通常最好是使用第二阶段或第三阶段所产生的 GNU CC 可执行档，因为一
般来说它们在执行上会比其他的编译器快)
16. 如果你要用 C++，你大概也要安装 libg++ 这套东西。它应该在你取得 GNU C
的同一个地方。由於 GNU C 没有另外的 C 执行时期函式库，所以它也不包含
C++ 执行程式库。所有的 I/O 函数、特殊类别函式库等等都包含在 libg++
□面。