home *** CD-ROM | disk | FTP | other *** search
/ ftp.uni-stuttgart.de/pub/systems/acorn/ / Acorn.tar / Acorn / acornet / dev / ada / ada.spk / !Ada / !ReadMe < prev    next >
Text File  |  1994-08-15  |  7KB  |  195 lines
  1.                         Ada/Ed translator and interpreter
  2.  
  3. 0.      Introduction
  4.  
  5. This file (sort of) documents the Peter Burwood port of the Ada/Ed
  6. translator and interpreter for the Ada programming language to the
  7. Acorn range of ARM based machines, running RISC-OS 2 / 3. For copyright
  8. details see !Help.
  9.  
  10. This is the first release of version 1.11.0a. It appears NYU are no longer
  11. developing Ada/Ed since the release of GNAT (the GNU Ada system). GNAT
  12. cannot be ported until the GNU assembler (GAS) is available for ARM and then
  13. must be cross-compiled from a GNAT supported platform.
  14.  
  15. Ada/Ed generally runs in a 640K wimpslot though large programs may
  16. require more.
  17.  
  18. This is a binary distribution only (sources are over 3MB in size), and
  19. consists of the following packages :
  20.  
  21. !Ada - Non-specific files, documentation, etc.
  22.   !Help          General help and copyright.
  23.   !ReadMe        This file.
  24.   !Run
  25.   !Sprites
  26.   Doc.adaed      The Ada/Ed users manual.
  27.   maketest       Task obey file to build the example programs.
  28.   ada.*          Example Ada programs (light on comments!).
  29.   c.*            Example C program called from Ada.
  30.   o.*            Object file for example c program.
  31.  
  32. Ada/Ed translator and interpreter
  33.   bin.adabind    Ada linker.
  34.   bin.adacomp    Ada compiler control program.
  35.   bin.adaexec    Ada interpreter.
  36.   bin.adalib     Ada library manager.
  37.   lib.adabind    copy of Ada linker.
  38.   lib.adagen     Ada virtual machine code generator.
  39.   lib.adaint     Partially linked Ada interpreter for interfacing to C
  40.   lib.adaprs     Ada parser.
  41.   lib.adasem     Ada semantic analyser.
  42.   lib.predef     Ada predefined library.
  43.  
  44.  
  45. 1.      Installation
  46.  
  47. The (default) installation of Ada/Ed is relatively simple :
  48.  
  49. *       Copy this directory, and its files, onto your hard disc.
  50. *       Double click on the !Ada application to setup the environment.
  51.  
  52. If you copy the !Ada.!Run file to !Ada.!Boot and ensure that !Ada is run
  53. during your boot up procedure, everything will be setup as required.
  54.  
  55. 2.      Using Ada/Ed
  56.  
  57. See the !Ada.maketest file for examples on compiling and running some of the
  58. supplied example Ada programs. Read the file !Ada.doc.adaed for a fuller
  59. description. This file has been unedited, apart from formatting, and so
  60. contains some non RISC OS notes, particularly the FORTRAN stuff, though this
  61. may work.
  62.  
  63. File names are automatically converted from <file>.<ext> when necessary to
  64. <ext>.<file> if the original file doesn't exist. Directories are created as
  65. necessary and removed when they become empty.
  66.  
  67. During compilation work files are created in the <library> directory and
  68. should be deleted when they are no longer required. The output of the
  69. compiler is also stored in the library directory as rather unhelpfully
  70. `numbered' files. If the source file to be compiled contains errors then
  71. examine the listing file in the lis directory. Re-running the compiler
  72. should delete all obsolete work files, though not always!
  73.  
  74. There is a limitation of approximately 256 units in am Ada library and a
  75. cunning file naming convention is used to overcome the RISC OS limit of 77
  76. files per directory. Basically, additional directories are created when
  77. required by appending a number from 1 to 9 to the directory name.
  78.  
  79. For most of the details for using Ada/Ed see the file !Ada.doc.adaed
  80.  
  81. 2.1     RISC-OS specific features.
  82.  
  83. *       Interworking with Norcroft cc
  84.  
  85. Code compiled with Ada/Ed can be linked by the Ada binder with code produced
  86. by the Norcroft CC compiler, and probably other APCS-R conformant compilers,
  87. with no problems. See !Ada.ada.test_int and !Ada.doc.adaed for more
  88. information.
  89.  
  90. *       Wimpslot
  91.  
  92. Ada/Ed is able to extend the wimpslot while executing an Ada program, though
  93. 640K is normally sufficient.
  94.  
  95. *       Debugging
  96.  
  97. Debugging is only available by a simple trace option. See !Ada.doc.adaed for
  98. more information.
  99.  
  100. 2.2     Feature not yet implemented
  101.  
  102. *       AMU support
  103.  
  104. This is not supported yet. The files are compiled to rather unfriendly named
  105. files in the library directory and it is impossible for AMU to determine
  106. whether a unit is up to date. An Ada frontend similar to the the cc
  107. frontend should appear shortly.
  108.  
  109. *       Throwback
  110.  
  111. Errors are currently output only to the screen. Later versions should
  112. support Throwback
  113.  
  114.  
  115. 4.      Known bugs / Problems
  116.  
  117. This is a list of all the known (by me) bugs and problems in Ada/Ed
  118. 1.11.0a Release 1. This list does not include any implementation
  119. restrictions mentioned in !Ada.doc.appendix_f.
  120.  
  121. Bug 1:
  122. The compiler may crash with a `getsymptr' error. I have seen this happen
  123. with a package incorporating generic functions which accesses package level
  124. global symbols (in the parent package of the generic) and is then with'ed by
  125. a later unit.
  126.  
  127. Reported by:    Me
  128. status:         Not yet cleared
  129.  
  130. Preventative actions:
  131. Try recompiling the unit that uses the generic in the same file as the
  132. generic.
  133.  
  134. ================================================================================
  135.  
  136. Bug 2:
  137. Occasionaly, Ada/Ed calls later phases of the compiler when the source
  138. contained errors. This generally results in a `chaos' message.
  139.  
  140. Reported by:    Me
  141. status:         Not yet cleared.
  142.  
  143. Preventative actions:
  144. Fix the source code and recompile it.
  145.  
  146. ================================================================================
  147.  
  148. Bug 3:
  149. If you use a command line like `adacomp -s adfs::harddisc4.$.work.bug.ada'
  150. (or ... ada.bug), the resultant listing file will be called lis.harddisc4 in
  151. your current directory.
  152.  
  153. Reported by:    Me
  154. status:         Not yet cleared
  155.  
  156. Preventative actions:
  157. Set the working directory to the directory `adfs::harddisc4.$.work' in this
  158. example and use `adacomp -s bug.ada'
  159.  
  160. ================================================================================
  161.  
  162. 5.      Acknowledgements, sources and other bits
  163.  
  164. *       Acknowledgements
  165.  
  166. Thanks go to the New York University for writing and implementing this
  167. software.
  168.  
  169. *       Sources
  170.  
  171. The standard sources for Ada/Ed are freely available from cs.nyu.edu
  172. (128.122.140.24) in the directory pub/adaed via anonymous FTP. These sources
  173. have not been converted to run on Acorn machines.
  174.  
  175. If you want the complete sources for Ada/Ed for Acorn machines, your best
  176. action is probably not to bother at the moment, and wait till a later
  177. version comes out with reported bugs hopefully fixed, and then get in touch
  178. with me.
  179.  
  180. 6.      Contacting me
  181.  
  182. 3.      Obtaining Ada/Ed
  183.  
  184. Ada/Ed can be obtained from various FTP sites (HENSA etc.) or can be
  185. obtained directly from me by sending 2 single density or 1 high density
  186. floppy discs and return postage to:
  187.  
  188.          Peter Burwood
  189.          205 Masons Avenue
  190.          Harrow
  191.          Middx
  192.          HA3 5AZ
  193.  
  194. I can also be contacted by email as `adaed@arcangel.demon.co.uk'
  195.