home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 2 / RISC_DISC_2.iso / pd_share / program / fortran77_210 / readme < prev    next >
Encoding:
Text File  |  1994-10-15  |  8.2 KB  |  188 lines
  1.                        FORTRAN PUBLIC DOMAIN LIBRARY
  2.  
  3. This is a PD library. If you wish to redistribute any of these files in
  4. any way, please include an acknowledgement to the 'Fortran Friends'
  5. ShareWare library and include the relevant copyright notices in the
  6. documentation files. Please read these notices carefully; some of the
  7. libraries forbid their sale for commercial gain.
  8.  
  9. The Fortran compiler is not on this disk.
  10.  
  11. Fortran Release 2 for Acorn computers is available for £99 (ex VAT) from:
  12.  
  13.  Intelligent Interfaces Ltd,     Tel.  (0703) 261514 
  14.  P.O.Box 80,                     Fax.  (0703) 267904
  15.  Eastleigh, 
  16.  Hants SO5 5YX, UK.
  17.  
  18. Further contributions which complement the existing collection are welcome.
  19. Please send your compiled libraries to add to this library, and/or the
  20. source code if you prefer, to the address below; I shall then send you an
  21. updated version of this library disc. Information on bugs you have found,
  22. sources of PD libraries etc. are also most welcome. Join the self-help
  23. 'Fortran Friends' group now! 
  24.  
  25. Routines must be your own copyright, accompanied by a text file describing
  26. briefly what the routine does, defining the parameters, and any error
  27. returns. You must include a copyright notice giving your name and address
  28. so that users can contact you if they have any queries. No attempt will be
  29. made to fix any problems in your routines, nor remove duplicate entry
  30. points. However, test programs should be provided where possible, so that
  31. their execution on the Archimedes can be checked.
  32.  
  33.  *************************************************************************
  34.  
  35.                         Disk FFriends_1 Contents  20 Feb 93
  36.  
  37.    From D.J. & K.M. Crennell (unless otherwise indicated)
  38.  
  39. 1. !Fortran77
  40.       A desktop tool allowing compilation, linking, and execution. This 
  41.       does NOT include the fortran compiler nor the linker; it can be used
  42.       with release 2 (and the ASD debugger if you wish), or you may use the
  43.       recently released Acorn DDE with its revised linker. The text file
  44.       'Instruct' within the !Fortran77 application directory gives setup and
  45.       running instructions.
  46.  
  47.    (An improved version of this which uses windows rather than menus
  48.     is marketed by Intelligent Interfaces, see address above).
  49.  
  50.    The following libraries are written in Assembler for speed. Since most
  51.    people have neither the Assembler, nor the library making utilities, the
  52.    Assembler source is not included.
  53.  
  54. 2. Binario (added 15 Jan 1992)
  55.    Fast binary input/output, callable from Fortran, as used by "Interacter"
  56.    from Interactive Software Services and supplied by Lawson Wakefield.
  57.  
  58. 3. Graphics
  59.    33 Graphics Routines which emulate the similar BASIC commands
  60.       e.g.    CALL LINE(IX1,IY1,IX2,IY2)
  61.  
  62. 4. SpriteOp
  63.    44 Sprite_Op routines for all the SpriteOps
  64.        names of the form SPOPnn, 02 < nn < 62
  65.  
  66. 5. Utils
  67.    11 Utilities e.g. J = IGET()  simulates the BASIC GET command, and a
  68.        general SWI calling routine.
  69.  
  70. 6. Wimp
  71.    51 Wimp routines covering all wimp operations + some utilities.
  72.  
  73.    There are fortran test programs using these libraries called Tdraw
  74.    TGraphics, TSpriteOp TUtils and Twimp. There is no documentation
  75.    for these other than the comments within the programs which are
  76.    not intended as tutorials, just implementation tests.
  77.  
  78. Fortran source libraries contributed.
  79.  
  80.     Only the source and documentation are supplied in directories f77 and
  81.     docs. To create libraries, compile the routines and move the aof to the
  82.     'lib' directory, see the file '!Fortran77.Instruct' for details.
  83.  
  84. 1.  DrawF
  85.     A set of utilities to create Draw files for 'path' and 'text' objects.
  86.  
  87. 2.  Graphdemo (added 31 Dec 91)
  88.     A set of utilities to plot a line graph through a set of X,Y points
  89.     with axes labelled with 'nice' values. The demo reads the points from
  90.     a file (called 'GraphData', not supplied), and plots the graph within a
  91.     window set by the user. The GraphData file has an x and a y on each
  92.     line, read with free format input. It has only been tested from a
  93.     non-WIMP program, and needs a little work to be usable from the WIMP.
  94.     The Drawfile GrfDemCons demonstrates the layout and meaning of the
  95.     variables. The only other documentation is in the source code comments.
  96.  
  97. 3.  ACMToms (added 17 Jan 92)
  98.     Various algorithms supplied by C.Johnson, originally part of the ACMToms
  99.      (See Readme in that directory for further information). Adapted to run
  100.     on RISC-OS by K.M.Crennell using the 'Fortran Friends' libraries.
  101.  
  102. 4. ARTlib (added 19 Feb 93)
  103.     Library of utility routines which simplify free format input, supplied
  104.     by A.R.Thawley, (see Library.Docs.ARTReadMe for further information)
  105.  
  106. Fortran applications
  107.  
  108. 1. SphereRot (added 7 Dec 91)
  109.    An example of the use of SpriteOps for the manipulation of objects made
  110.    of spheres. (Not Desktop)             
  111.  
  112. 2. WimpPoly (added 7 Dec 91)
  113.    An example of the use of Wimp routines called from Fortran to display
  114.    polyhedra from pre-stored datafiles. (There is not room for all the
  115.    datafiles on the !Fortran77 disc, they can be found on another ShareWare
  116.    disc.)
  117.  
  118. Advice for converting a Basic program to Fortran (with example).
  119.  
  120. List of reported bugs in Fortran77 release 2.
  121.  
  122. List of commercial suppliers of libraries callable from fortran.
  123.  
  124. List of bulletin boards accessible from the Joint Academic Network.
  125.  
  126. List of names and addresses of 'Fortran Friends'
  127.  *************************************************************************
  128.  
  129. The distributed disc (FFriends_1 )structure is:
  130.  
  131.     $.Readme       (this file)
  132.      .Bas2F77      (instructions for converting Basic to Fortran)
  133.      .TCircles     (simple Basic program for use with instructions above,
  134.                     the converted program is library.f77.Tcircles)
  135.      .F77Buglist   (List of reported errors in Fortran77 Release 2, with
  136.                    example code)
  137.      .F77LibList   (List of commercial suppliers of Fortran libraries)
  138.      .PDInfo       (List of software libraries accessible from JANET) 
  139.      .!Fortran77   (the front end RISC-OS application with documentation)
  140.      .!SphereRot   (application, see its 'ReadMe' file for instructions)
  141.      .!WimpPoly    (application, see its 'ReadMe' file for instructions)
  142.      .ACMToms.     (ReadMe & Copyright notice)    
  143.              .f77  (directory of Fortran algorithms)
  144.      .library.
  145.              .docs (directory of documentation, one file for each library)
  146.              .f77  (directory of fortran source, example programs)
  147.              .lib  (fortran libraries)
  148.  
  149.  *************************************************************************
  150.  
  151. INSTALLATION INSTRUCTIONS FOR HARD DISK OWNERS
  152.  
  153.  1. It is assumed that Fortran77 is already installed on your system.
  154.  2. Copy the library files in the disc FFriends_1.$.library.lib directory to
  155.     the .lib directory of your Fortran installation. 
  156.  3. Copy the application !Fortran77 to any suitable directory where you 
  157.     store your utility programs.
  158.  4. Read the documentation files, !Fortran77.Instruct, and those in the
  159.     directory library.docs
  160.  
  161.  *************************************************************************
  162.  
  163. INSTALLATION INSTRUCTIONS FOR MAKING A WORKING FLOPPY DISK VERSION 
  164.  
  165.  1. Format an 800K floppy disc. 
  166.  2. Create new directories $.Library, $.Library.lib and $.f77
  167.  3. Copy from your Fortran77 system disc the files f77fe, f77cg, and link to
  168.     the Library directory of the working floppy.
  169.  4. Copy from your Fortran77 system disc the F77 library 
  170.     (name Library.lib.f77) to Library.lib.f77 on the working floppy.
  171.  5. Copy the library files in the disc FFriends_1.$.library.lib directory to
  172.     the directory Library.lib on the working floppy. 
  173.  6. Copy the application !Fortran77 to the top directory of the working 
  174.     floppy, then delete the file !Fortran77.Instruct from the working floppy     to save space.
  175.  7. Read the documentation files, this file, !Fortran77.Instruct, and those
  176.     in the directory library.docs.
  177.  8. Copy the Fortran program you want to compile into the $.f77 directory of     the working floppy.
  178.  9. Load the FPEmulator module from your Fortran77 system disc.
  179.  
  180.   Your working disc should then be ready to run. 
  181.  
  182. Enjoy it!
  183.  
  184.                K.M. Crennell
  185.                P.O. Box 64,
  186.                Didcot,
  187.                Oxon, OX11 0TH.
  188.