home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS - Coast to Coast / simteldosarchivecoasttocoast2.iso / biology / gsrc208a.zip / README.TXT < prev    next >
Text File  |  1993-02-10  |  5KB  |  129 lines
  1. **************************************************************
  2. * THIS TEXT FILE CONTAINS INFORMATION ABOUT COMPILING GEPASI *
  3. **************************************************************
  4.  
  5. this is the source code for GEPASI 2.0, release 2.02c
  6.  
  7. Index
  8.  
  9. 1. COPYLEFT
  10. 2. MAKEFILES
  11. 3. LIBRARIES
  12. 4. COMMENTS
  13. 5. ANSI COMPLIANCE
  14. 6. HELP TEXT
  15. 7. PORTABILITY OF THE SIMULATION ENGINE
  16.  
  17.  
  18. 1. COPYLEFT
  19.  
  20.     GEPASI - a simulator of metabolic pathways and other dynamical systems
  21.     Copyright (C) 1989, 1992, 1993  Pedro Mendes
  22.                               University of Wales, Aberystwyth
  23.                               Dyfed, SY23 3DA, United Kingdom
  24.                               email: prm@aber.ac.uk
  25.  
  26.     This program is free software; you can redistribute it and/or modify
  27.     it under the terms of the GNU General Public License as published by
  28.     the Free Software Foundation; either version 1, or (at your option)
  29.     any later version.
  30.  
  31.     This program is distributed in the hope that it will be useful,
  32.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  33.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  34.     GNU General Public License for more details.
  35.  
  36.     You should have received a copy of the GNU General Public License
  37.     (file COPYING) along with this program; if not, write to the Free
  38.     Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  39.  
  40.   All C source code modules contain comments with the copyright notice, and
  41. all *.c files include COPYLEFT.H which has the above copyright notice. In no
  42. circumstances should this be deleted from the source code files. Any new *.c
  43. files added to the project should also comply with this.
  44.  
  45.  
  46. 2. MAKEFILES
  47.  
  48.    The following makefiles are available:
  49.  
  50.      gepasi.mak        Quick C/Win 1.0,  simulation engine, MS-DOS
  51.      gwsim.mak         Quick C/Win 1.0,  Simulation, MS-Windows
  52.      gwtop.mak         Quick C/Win 1.0,  Topology, MS-Windows
  53.      gepasi.hpj        MS Help Compiler, Help, MS-Windows
  54.  
  55.        these makefiles require that the source code files are in a directory
  56.        with the following path:  c:\source\gepasi . If you want to change this
  57.        you are responsible for the alterations in these make (project) files.
  58.  
  59.      Makefile.unx   cc, simulation engine, unix
  60.  
  61.        this makefile compiles the simualtion engine with the standard (?) C 
  62.        compiler, cc. It has only been tested in a DEC 5830 running Ultrix 4.2. 
  63.        Before using it, it should be renamed to 'Makefile'
  64.  
  65.  
  66. 3. LIBRARIES
  67.  
  68.   To compile GWSIM (Simulation) and GWTOP (Topology) the MS-Windows 3.0 or 3.1 
  69. libraries must be in the INCLUDE path and you must also have a resource
  70. compiler. The simulation engine does not require any libraries other than the
  71. standard C libraries, including support for double precision floating-point
  72. calculations. 
  73.  
  74.  
  75. 4. COMMENTS
  76.  
  77.   The source code contains comments explaining what is being done. New bits 
  78. of code should be well explained inside comments and it would be useful to 
  79. add the date when such changes were made, by whom and an address (email 
  80. should be enough). 
  81.  
  82.   Each module has at the top a large block of comment lines providing a title 
  83. for the code block and also a list of compilers that have successfully handled 
  84. it. If you managed to compile this code with a different compiler, please add 
  85. it to the list. This should greatly facilitate other users efforts in 
  86. compiling GEPASI. 
  87.  
  88.  
  89. 5. ANSI COMPLIANCE
  90.  
  91.    As much as possible, the code is compliant with the ANSI standard. However, 
  92. the code has not been thourogly tested and there are certainly some parts that 
  93. need to be changed to the standard.
  94.  
  95.    The LSODA package, which was primarily converted from the original FORTRAN 
  96. version with the AT&T f2c program, is notably a non-compliant part. For 
  97. example, there are no function prototypes and the old K&R style of function 
  98. declarations is still used. This is going to be corrected in future versions.
  99.  
  100.  
  101. 6. HELP TEXT
  102.  
  103.    The text of the help file can be found in GEPASI.RTF, in Rich Text Format.
  104. This text can be used to build other help files, like man pages, etc. 
  105.  
  106. 7. PORTABILITY OF THE SIMULATION ENGINE
  107.  
  108.    The floating-point exception handler is not foolproof. It works for the 
  109. environments tested (compiler and OS) but there are no garantees for other 
  110. environments. 
  111.  
  112. Clearing the screen is a highly non-portable action and therefore the cls()
  113. function (in pmu.c) only clears the screen if compiled under MS-DOS. New 
  114. cls() functions to work with other operating systems are welcome, although
  115. this is by no means a critical need. Functions to read the cursor position 
  116. and to set it (get_cursor() and set_cursor()) are also on the same list. 
  117. Please do not suggest to use the CURSES package, I am trying to keep 
  118. GEPASI's simulation engine independent of libraries as much as possible.
  119.  
  120.  
  121. Pedro Mendes
  122. Dept Biological Sciences
  123. University of Wales
  124. Aberystwyth,
  125. Dyfed SY23 3AX
  126. United Kingdom
  127. prm@aber.ac.uk
  128.  
  129.