home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / g77_2 / !gcc / docs / fortran / !Readme next >
Encoding:
Text File  |  1996-11-09  |  3.0 KB  |  104 lines
  1. The GNU Fortran compiler
  2. ========================
  3.  
  4. Introduction
  5. ------------
  6.  
  7. This is a port of the GNU Fortran compiler (version 0.5.18) for the 
  8. Fortran 77 and 90 programming language dialects to the Acorn range of
  9. ARM based machines, running under RISC OS. As such, this package is
  10. covered by the FSF General Public License (see the files docs.COPYING
  11. and docs.COPYINGLIB for details).
  12.  
  13. This port is © 1996 Nick Burrett
  14.  
  15. As with GNU programs, THERE IS NO WARRANTY OF ANY SORT
  16.  
  17. This compiler requires a minimum 2800Kb of free RAM for compilations.
  18.  
  19.  
  20. Files
  21. -----
  22.  
  23. This is a binary distribution only and consists of the following files:
  24.  
  25.   bin.f771          The Fortran compiler
  26.   bin.g77           The Fortran compiler front end
  27.   docs.g77          Fortran compiler instruction manual
  28.   docs.Fortran77    This documentation
  29.   gcc.o.libf2c      Fortran compiler runtime library
  30.  
  31. The compiler sources (about 1600Kb) can be obtained from the sites listed at
  32. the end of docs.!Intro.
  33.  
  34.  
  35. Installation
  36. ------------
  37.  
  38. Before attempting to use GNU C, it should be noted that this distribution
  39. will require the GCC front end files stored in the archive gccmain.zip.
  40. If you do not have a copy of this, it can be retrieved from
  41.   ftp://micros.hensa.ac.uk/micros/arch/riscos/b/b013/gccmain.zip
  42. and relevant mirrors.
  43.  
  44. GNU Fortran 0.5.18 also requires UnixLib 3.7a or later, but not UnixLib 4.0.
  45. GNU Fortran will not work with UnixLib 3.6e or earlier.
  46.  
  47.  
  48. Compiling Fortran source
  49. ------------------------
  50.  
  51. Fortran source files can be kept in either the 'for' or 'f' directories.
  52.  
  53. Fortran comes with an extra file called g77. g77 is a front end binary for
  54. the Fortran compiler, and will automatically include the necessary run-time
  55. library needed by Fortran whenever the compilation needs it.
  56.  
  57. Typing:
  58.     gcc -c f.test
  59. or  g77 -c f.test
  60.  
  61. will compile the Fortran file, test, into an AOF file and store it in the
  62. 'o' directory.
  63.  
  64. Typing:
  65.   gcc f.test -o test -lf2c -Wl,-rescan
  66.  
  67. is equivalent to:
  68.   g77 f.test -o test -Wl,-rescan
  69.  
  70. libf2c is the standard run-time library required by Fortran. Notice the
  71. extra command line option '-Wl,-rescan'. This requests drlink to rescan
  72. all libraries to try and resolve missing references. It is equivalent
  73. to passing '-rescan' on the drlink command line.
  74.  
  75. All GNU compilers require the library gcc:o.libgcc to operate. So separate
  76. compile and link operations must include this.
  77.  
  78.  
  79. Known problems
  80. --------------
  81.  
  82. If you find a bug then please read the file docs.bugs for what to do if
  83. you have found a bug.
  84.  
  85. This is an early release of the GNU Fortran compiler, therefore I can't
  86. be expected to make major enhancements to it's functionality. A large
  87. number of bugs are caused by the run-time library and UnixLib, when
  88. these are identified they are usually fixed quickly.
  89.  
  90.  
  91. Known Restrictions
  92. ------------------
  93.  
  94. There are currently no known restrictions.
  95.  
  96.  
  97. Contacting me
  98. -------------
  99.  
  100. I can be contacted by e-mail at: nickb@digibank.demon.co.uk
  101.  
  102. However, if there is no response from that address I can be contacted
  103. through Simon Callan: gcc@callan.demon.co.uk.
  104.