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