home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / programming / fortranf1_1 / !Fortran77_Instruct < prev    next >
Encoding:
Text File  |  1994-01-30  |  6.3 KB  |  143 lines
  1.  
  2.      A Desktop Front End for FORTRAN 77      Version 2.10   7 Dec 1991
  3.                            by D.J. Crennell
  4.  
  5.   ************************************************************************
  6.                     C O P Y R I G H T    N O T I C E
  7.  
  8.     Copyright D.J & K.M. Crennell,          1 Aug 1991
  9.                   P.O. Box 64, Didcot, Oxon, OX11 0TH.
  10.  
  11.  This software is in the Public Domain and may not be sold or included in any
  12.  program that will be sold, without written permission from the authors.
  13.  
  14.  The authors must be given credit in any publications using this software.
  15.  
  16.  The software may be copied and distributed as long as no changes are made
  17.  and this copyright notice is included. Please send any suggested
  18.  improvements to the authors. 
  19.  
  20.  In no circumstances shall the authors be liable for any damage, loss of
  21.  profits, or any indirect or consequential loss arising out of the use of
  22.  this software or inability to use this software, even if they have been
  23.  advised of the possibility of such loss.
  24.  
  25.  The authors do their best to ensure that this application is distributed
  26.  virus free.
  27.   ************************************************************************
  28.  
  29.  This application simplifies compiling, linking and running fortran77
  30. programs. It expects to find the following files and directories:
  31.  
  32.    directory   file    description
  33.  
  34.        %               the library directory
  35.        %.      f77fe   the Acorn fortran front end compiler
  36.        %.      f77cg   the Acorn fortran code generator
  37.        %.      link    the Acorn linker (if it is absent you will not be
  38.                        allowed to try to link)
  39.        %.lib           fortran libraries directory
  40.        %.lib.  f77     fortran system library
  41.        %.lib.  *       user libraries which may be included in the link step
  42.                        (see Note 3)
  43.        .f77.   *       fortran source, limited to the 77 files allowed in a
  44.                        directory
  45.        .aof.   *       up to 77 object files (from fortran above or
  46.                        elsewhere) for linking with the libraries in %.lib
  47.     System:modules     FPEmulator, the floating Point emulator module
  48.  
  49. Note 1.                                               
  50.    If you have the old Software Developer's Toolbox you may find the
  51. following two utilities useful:
  52.        %.asd      the Arthur Symbolic Debugger. This will allow the "debug"
  53.                   compiler option, when the program will be executed debug
  54.                   mode
  55.        %.squeeze  the aif compression utility can then be selected with the
  56.                   "squeeze" option.
  57.  
  58. Note 2.
  59.    If you have the new Acorn Desktop Development Environment package then
  60. you may use:
  61.        %.squeeze  the aif compression utility can then be selected with the
  62.                   "squeeze" option.
  63.       You can enter the DDE environment after compiling and linking by
  64.       selecting "debug" in the compiler menu provided Desktop Debugging Tool       has been "seen" by Risc-OS. (Untested 7 Dec 91)
  65.  
  66. Note 3.
  67.   By default !Fortran77 expects to find the libraries in the directory
  68.   $.library.lib, loads all those it finds, and lists them in alphabetical
  69.   order in its 'Libraries' menu.
  70.  
  71.   From version 2.10 of !Fortran77 you can:
  72.       redefine the libraries directory,
  73.       select which libraries to load,
  74.       change the linking order.
  75.  
  76.   Remember that libraries which call routines from other libraries 
  77.   must be loaded before those they call. 
  78.  
  79.   If you want to change the default directory or loading order, include a
  80.   textfile 'LibList' similar to the example included.
  81. --------------------------------------------------------------------------
  82.  
  83.  Instructions:
  84.  
  85.     Double click on the !Fortran77 icon which will install itself on the
  86. icon bar.
  87.  
  88.  1) Click "menu" over the icon and set:
  89.     a) whether to link, (squeeze) and run, (it always compiles)
  90.     b) the compilation options,
  91.     c) the link options,
  92.     d) which libraries to include,
  93.  
  94.  2) Drag any aof files to be used on to the icon,
  95.     or delete them from the menu if not required any more.
  96.  
  97.  3) Drag the fortran file(s) onto the icon. You must drag all at once
  98. because you will not get another chance.
  99.  
  100.    !Fortran77 will set the current directory to the one below the .f77 and
  101. create any .aof and .aif directories which it needs and which do not exist.
  102. Hence, if you have any INCLUDE files, they are best stored here and so will
  103. not need any directory prefix. 
  104.    If there are any compilation or linking errors, a file .err.<name> will
  105. contain the details and will be displayed by !Edit (if Risc-OS knows about
  106. it; similarly .asm.<name>, .lis.<name>, .map.<name> files will be created if
  107. they are asked for in the menu (<name> is that of the f77 file). 
  108.    Temporary files used in compiling and linking will be stored on RAM disc
  109. if possible, else they will be in a directory $.tmp; all of these will be
  110. deleted when they are no longer needed.
  111.  
  112.    Memory used:
  113.  
  114. Compilation: 320K (set up in cs% at beginning of DeskTopF77)
  115. Link:        640K (set up in ls% at beginning of DeskTopF77) 
  116. Run: This is calculated exactly from the .aif file, but RISC-OS will round
  117.      it up to a convenient size. Hence you can multi-task a running fortran
  118.      program. Running with the asd debugger requires much more memory.
  119.      Running with DTE the memory is controlled by the DTE.
  120.  
  121.    Versions:
  122.  
  123. 2.00  30 Nov 1991
  124.       Acorn Desktop Development Environment compatible version;
  125.       Link map and cross reference listings in link menu;
  126.       Debug option calls DTE package to run the aif (works, but not tested).
  127.         The presence of the new DDE environment is detected by the size(!) of
  128.       the linker. This is ~73K in the old version and ~27K in the DDE.
  129. 2.10  5 Dec 1991
  130.       Includes libraries directory redefinition (see Note 3 above). Also
  131.       minor corrections to the way Basic errors are handled.
  132. 2.11  19 Dec 1991
  133.       Correct error messages if trying to overwrite locked aof or aif files.
  134. 2.12  10 Jan 1992
  135.       Fix to bug in compilation from many files. Increase the size of the
  136.       RAM disc.
  137. 2.13  26 Apr 1992
  138.       Fix to !Run to set library to current filing system
  139. 2.14  30 Aug 1992
  140.       Fix line 1400 from "error" to "rror" so finds F77cg errors
  141. 2.15  07 Sep 1992
  142.       direct compiler messages with -ver rather than { > .. } construction.
  143.       This allows for problems in illegal INCLUDE file names.