home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 7 / FreshFishVol7.bin / bbs / gnu / gcc-2.3.3-src.lha / GNU / src / amiga / gcc-2.3.3 / gcc.info-5 (.txt) < prev    next >
GNU Info File  |  1994-02-06  |  47KB  |  902 lines
  1. This is Info file gcc.info, produced by Makeinfo-1.49 from the input
  2. file gcc.texi.
  3.    This file documents the use and the internals of the GNU compiler.
  4.    Copyright (C) 1988, 1989, 1992 Free Software Foundation, Inc.
  5.    Permission is granted to make and distribute verbatim copies of this
  6. manual provided the copyright notice and this permission notice are
  7. preserved on all copies.
  8.    Permission is granted to copy and distribute modified versions of
  9. this manual under the conditions for verbatim copying, provided also
  10. that the sections entitled "GNU General Public License" and "Protect
  11. Your Freedom--Fight `Look And Feel'" are included exactly as in the
  12. original, and provided that the entire resulting derived work is
  13. distributed under the terms of a permission notice identical to this
  14.    Permission is granted to copy and distribute translations of this
  15. manual into another language, under the above conditions for modified
  16. versions, except that the sections entitled "GNU General Public
  17. License" and "Protect Your Freedom--Fight `Look And Feel'", and this
  18. permission notice, may be included in translations approved by the Free
  19. Software Foundation instead of in the original English.
  20. File: gcc.info,  Node: Unos Install,  Next: VMS Install,  Prev: 3b1 Install,  Up: Installation
  21. Installing GNU CC on Unos
  22. =========================
  23.    Use `configure unos' for building on Unos.
  24.    The Unos assembler is named `casm' instead of `as'.  For some
  25. strange reason linking `/bin/as' to `/bin/casm' changes the behavior,
  26. and does not work.  So, when installing GNU CC, you should install the
  27. following script as `as' in the subdirectory where the passes of GCC
  28. are installed:
  29.      #!/bin/sh
  30.      casm $*
  31.    The default Unos library is named `libunos.a' instead of `libc.a'. 
  32. To allow GNU CC to function, either change all references to `-lc' in
  33. `gcc.c' to `-lunos' or link `/lib/libc.a' to `/lib/libunos.a'.
  34.    When compiling GNU CC with the standard compiler, to overcome bugs in
  35. the support of `alloca', do not use `-O' when making stage 2. Then use
  36. the stage 2 compiler with `-O' to make the stage 3 compiler.  This
  37. compiler will have the same characteristics as the usual stage 2
  38. compiler on other systems.  Use it to make a stage 4 compiler and
  39. compare that with stage 3 to verify proper compilation.
  40.    (Perhaps simply defining `ALLOCA' in `x-crds' as described in the
  41. comments there will make the above paragraph superfluous.  Please
  42. inform us of whether this works.)
  43.    Unos uses memory segmentation instead of demand paging, so you will
  44. need a lot of memory.  5 Mb is barely enough if no other tasks are
  45. running. If linking `cc1' fails, try putting the object files into a
  46. library and linking from that library.
  47. File: gcc.info,  Node: VMS Install,  Next: WE32K Install,  Prev: Unos Install,  Up: Installation
  48. Installing GNU CC on VMS
  49. ========================
  50.    The VMS version of GNU CC is distributed in a backup saveset
  51. containing both source code and precompiled binaries.
  52.    To install the `gcc' command so you can use the compiler easily, in
  53. the same manner as you use the VMS C compiler, you must install the VMS
  54. CLD file for GNU CC as follows:
  55.   1. Define the VMS logical names `GNU_CC' and `GNU_CC_INCLUDE' to
  56.      point to the directories where the GNU CC executables
  57.      (`gcc-cpp.exe', `gcc-cc1.exe', etc.) and the C include files are
  58.      kept respectively.  This should be done with the commands:
  59.           $ assign /system /translation=concealed -
  60.             disk:[gcc.] gnu_cc
  61.           $ assign /system /translation=concealed -
  62.             disk:[gcc.include.] gnu_cc_include
  63.      with the appropriate disk and directory names.  These commands can
  64.      be placed in your system startup file so they will be executed
  65.      whenever the machine is rebooted.  You may, if you choose, do this
  66.      via the `GCC_INSTALL.COM' script in the `[GCC]' directory.
  67.   2. Install the `GCC' command with the command line:
  68.           $ set command /table=sys$common:[syslib]dcltables -
  69.             /output=sys$common:[syslib]dcltables gnu_cc:[000000]gcc
  70.           $ install replace sys$common:[syslib]dcltables
  71.   3. To install the help file, do the following:
  72.           $ library/help sys$library:helplib.hlb gcc.hlp
  73.      Now you can invoke the compiler with a command like `gcc /verbose
  74.      file.c', which is equivalent to the command `gcc -v -c file.c' in
  75.      Unix.
  76.    If you wish to use GNU C++ you must first install GNU CC, and then
  77. perform the following steps:
  78.   1. Define the VMS logical name `GNU_GXX_INCLUDE' to point to the
  79.      directory where the preprocessor will search for the C++ header
  80.      files. This can be done with the command:
  81.           $ assign /system /translation=concealed -
  82.             disk:[gcc.gxx_include.] gnu_gxx_include
  83.      with the appropriate disk and directory name.  If you are going to
  84.      be using libg++, this is where the libg++ install procedure will
  85.      install the libg++ header files.
  86.   2. Obtain the file `gcc-cc1plus.exe', and place this in the same
  87.      directory that `gcc-cc1.exe' is kept.
  88.      The GNU C++ compiler can be invoked with a command like `gcc /plus
  89.      /verbose file.cc', which is equivalent to the command `g++ -v -c
  90.      file.cc' in Unix.
  91.    We try to put corresponding binaries and sources on the VMS
  92. distribution tape.  But sometimes the binaries will be from an older
  93. version than the sources, because we don't always have time to update
  94. them.  (Use the `/version' option to determine the version number of
  95. the binaries and compare it with the source file `version.c' to tell
  96. whether this is so.)  In this case, you should use the binaries you get
  97. to recompile the sources.  If you must recompile, here is how:
  98.   1. Execute the command procedure `vmsconfig.com' to copy files
  99.      `vax-vms.h', `xm-vax-vms.h', `vax.c' and `vax.md' to `tm.h',
  100.      `config.h', `aux-output.c', and `md.' respectively, and to create
  101.      files `tconfig.h' and `hconfig.h'.  This procedure also creates
  102.      several linker option files used by `make-cc1.com' and a data file
  103.      used by `make-l2.com'.
  104.           $ @vmsconfig.com
  105.   2. Setup the logical names and command tables as defined above.  In
  106.      addition, define the VMS logical name `GNU_BISON' to point at the
  107.      to the directories where the Bison executable is kept.  This
  108.      should be done with the command:
  109.           $ assign /system /translation=concealed -
  110.             disk:[bison.] gnu_bison
  111.      You may, if you choose, use the `INSTALL_BISON.COM' script in the
  112.      `[BISON]' directory.
  113.   3. Install the `BISON' command with the command line:
  114.           $ set command /table=sys$common:[syslib]dcltables -
  115.             /output=sys$common:[syslib]dcltables -
  116.             gnu_bison:[000000]bison
  117.           $ install replace sys$common:[syslib]dcltables
  118.   4. Type `@make-gcc' to recompile everything (alternatively, you may
  119.      submit the file `make-gcc.com' to a batch queue).  If you wish to
  120.      build the GNU C++ compiler as well as the GNU CC compiler, you must
  121.      first edit `make-gcc.com' and follow the instructions that appear
  122.      in the comments.
  123.   5. In order to use GCC, you need a library of functions which GCC
  124.      compiled code will call to perform certain tasks, and these
  125.      functions are defined in the file `libgcc2.c'.  To compile this
  126.      you should use the command procedure `make-l2.com', which will
  127.      generate the library `libgcc2.olb'. `libgcc2.olb' should be built
  128.      using the compiler built from the same distribution that
  129.      `libgcc2.c' came from, and `make-gcc.com' will automatically do
  130.      all of this for you.
  131.      To install the library, use the following commands:
  132.           $ library gnu_cc:[000000]gcclib/delete=(new,eprintf)
  133.           $ library libgcc2/extract=*/output=libgcc2.obj
  134.           $ library gnu_cc:[000000]gcclib libgcc2.obj
  135.      The first command simply removes old modules that will be replaced
  136.      with modules from libgcc2.  If the VMS librarian complains about
  137.      those modules not being present, simply ignore the message and
  138.      continue on with the next command.
  139.      Whenever you update the compiler on your system, you should also
  140.      update the library with the above procedure.
  141.