home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / gpc_2 / !gcc / docs / pascal / !Readme next >
Encoding:
Text File  |  1996-11-16  |  3.0 KB  |  113 lines
  1. The GNU Pascal compiler
  2. ==================
  3.  
  4. Introduction
  5. ------------
  6.  
  7. This is a port of the GNU Pascal compiler (version 1.2) for the Pascal
  8. programming language to the Acorn range of ARM based machines, running
  9. under RISC OS. As such, this package is covered by the FSF General Public
  10. License (see the files docs.COPYING and docs.COPYINGLIB for details).
  11.  
  12. This port is © Copyright 1996 Nick Burrett
  13.  
  14. As with GNU programs, THERE IS NO WARRANTY OF ANY SORT
  15.  
  16. This compiler requires a minimum 2400Kb of free RAM for compilations.
  17.  
  18.  
  19. Files
  20. -----
  21.  
  22. This is a binary distribution only and consists of the following files:
  23.  
  24.   bin.gpc        Pascal compiler front end
  25.   bin.gpc-cpp        Pascal compiler pre-processor
  26.   bin.gpc1            Pascal compiler
  27.   gcc.o.libgpc        Pascal run-time library
  28.   docs.pascal.!Readme   This documentation
  29.   docs.pascal.gpc    Main pascal compiler documentation
  30.  
  31. The compiler sources (about 7Mb) can be obtained from
  32.     ftp:/kampi.hut.fi/jtv/gnu-pascal
  33.  or ftp:/src.doc.ic.ac.uk/pub/gnu/pascal
  34.  
  35. Installation
  36. ------------
  37.  
  38. Before attempting to use GNU Pascal, it should be noted that this
  39. distribution will require the GCC front end files stored in the archive
  40. gccmain.zip.
  41. If you do not have a copy of this, it can be retrieved from
  42.   ftp://micros.hensa.ac.uk/micros/arch/riscos/b/b013/gccmain.zip
  43.  
  44. GNU Pascal 2.7.2 also requires UnixLib 3.7a or later, but not UnixLib 4.0.
  45. GNU Pascal will not work with UnixLib 3.6e or earlier.
  46.  
  47.  
  48. Compiling Pascal source
  49. -----------------------
  50.  
  51. Pascal source files are kept in the 'p' or 'pas' directory.
  52.  
  53. Simply type:
  54.   gpc -c p.test
  55.  
  56. will compile the Pascal file, test, into an AOF file and store it in the 'o'
  57. directory.
  58.  
  59. Automatically compiling and linking is simple:
  60.   gpc p.test -o test
  61.  
  62. will compile and link the file p.test and store the resultant binary in the
  63. current directory and call it test.
  64.  
  65. GNU Pascal requires that the run-time library gcc:o.libgpc will need to be
  66. linked in all programs.
  67.  
  68. All GNU compilers require the library gcc:o.libgcc to operate. So separate
  69. compile and link operations must include this.
  70.  
  71.  
  72. Compiling and running the example programs
  73. ------------------------------------------
  74.  
  75. The following example programs are to be found in the directory !gcc.files.
  76. For each program, there is a list of the necessary command lines for how
  77. to compile, link and run the program.
  78.  
  79.  
  80. hellow
  81. ^^^^^^
  82. The standard Pascal program.
  83.  
  84. Source:     p.hellow
  85. Compile using:     gpc p.hellow -o hellow
  86. Run using:     hellow
  87.  
  88.  
  89.  
  90. Known problems
  91. --------------
  92.  
  93. If you find a bug then please read the file docs.bugs for what to do if
  94. you have found a bug.
  95.  
  96. There are no known problems.
  97.  
  98.  
  99. Known Restrictions
  100. ------------------
  101.  
  102. GNU Pascal (GPC) tries to be a Level 0 ISO 7185 compatible Pascal processor.
  103. There are two levels in the Pascal standard; level 0 processors are not
  104. required to understand conformant arrays (this is the only difference)
  105.  
  106. Contacting me
  107. -------------
  108.  
  109. I can be contacted by e-mail at: nickb@digibank.demon.co.uk
  110.  
  111. However, if there is no response from that address I can be contacted
  112. through Simon Callan: gcc@callan.demon.co.uk.
  113.