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