home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / octa21fs.zip / octave / README < prev    next >
Text File  |  2000-01-15  |  5KB  |  113 lines
  1. GNU Octave -- a high-level language for numerical computations.
  2.  
  3. Copyright (C) 1996, 1997 John W. Eaton
  4.  
  5. Last updated: Fri Feb  6 02:23:36 1998
  6.  
  7. Overview
  8. --------
  9.  
  10. GNU Octave is a high-level language, primarily intended for numerical
  11. computations.  It provides a convenient command line interface for
  12. solving linear and nonlinear problems numerically.
  13.  
  14. GNU Octave is free software; you can redistribute it and/or modify it
  15. under the terms of the GNU General Public License as published by the
  16. Free Software Foundation; either version 2, or (at your option) any
  17. later version.
  18.  
  19. GNU Octave is distributed in the hope that it will be useful, but
  20. WITHOUT ANY WARRANTY; without even the implied warranty of
  21. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the file
  22. COPYING for more details.
  23.  
  24. Availability
  25. ------------
  26.  
  27. The latest released version of Octave is always available via
  28. anonymous ftp from ftp.che.wisc.edu in the directory /pub/octave.
  29. Complete source and binaries for several popular systems are
  30. available.  Source distributions of Octave are also available from
  31. ftp.gnu.org in the directory /pub/gnu, as well as many mirror
  32. sites around the world.
  33.  
  34. Installation and Bugs
  35. ---------------------
  36.  
  37. Octave requires approximately 125MB of disk storage to unpack and
  38. compile from source (significantly less if you don't compile with
  39. debugging symbols or create shared libraries).  Once installed, Octave
  40. requires approximately 65MB of disk space (again, considerably less if
  41. you don't build shared libraries or the binaries and libraries do not
  42. include debugging symbols).
  43.  
  44. To compile Octave, you will need a recent version of GNU Make.  You
  45. will also need g++ 2.7.2 or later.  Version 2.8.0 or egcs 1.0.x should
  46. work.  Later versions may work, but C++ is still evolving, so don't be
  47. too surprised if you run into some trouble.
  48.  
  49. It is no longer necessary to have libg++, but you do need to have the
  50. GNU implementation of libstdc++.  If you are using g++ 2.7.2,
  51. libstdc++ is distributed along with libg++, but for later versions,
  52. libstdc++ is distributed separately.  For egcs, libstdc++ is included
  53. with the compiler distribution.
  54.  
  55. YOU MUST HAVE GNU MAKE TO COMPILE OCTAVE.  Octave's Makefiles use
  56. features of GNU Make that are not present in other versions of make.
  57. GNU Make is very portable and easy to install.
  58.  
  59. See the notes in the files INSTALL and INSTALL.OCTAVE for more
  60. specific installation instructions, including directions for
  61. installing Octave from a binary distribution.
  62.  
  63. The file BUGS contains a recommended procedure for reporting bugs, as
  64. well as a list of known problems and possible fixes.
  65.  
  66. Documentation
  67. -------------
  68.  
  69. Octave's manual has been revised for version 2.0, but it is lagging a
  70. bit behind the development of the software.  In particular, there is
  71. currently no complete documentation of the C++ class libraries or the
  72. support for dynamic linking and user-defined data types.  If you
  73. notice ommissions or inconsistencies, please report them as bugs to
  74. bug-octave@bevo.che.wisc.edu.  Specific suggestions for ways to
  75. improve Octave and its documentation are always welcome.
  76.  
  77. Implementation
  78. --------------
  79.  
  80. Octave is being developed with the Free Software Foundation's make,
  81. bison (a replacement for YACC), flex (a replacement for lex), gcc/g++,
  82. and libstdc++ on an Intel Pentium II system running Linux/GNU.  It
  83. should be possible to install it on any machine that runs GCC/G++.  It
  84. may also be possible to install it using other implementations of
  85. these tools, but it will most certainly require much more work.  Do
  86. yourself a favor and get the GNU development tools, either via
  87. anonymous ftp from ftp.gnu.org or by writing the Free Software
  88. Foundation, 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  89.  
  90. The underlying numerical solvers are currently standard Fortran ones
  91. like Lapack, Linpack, Odepack, the Blas, etc., packaged in a library
  92. of C++ classes (see the files in the libcruft and liboctave
  93. subdirectories).  If possible, the Fortran subroutines are compiled
  94. with the system's Fortran compiler, and called directly from the C++
  95. functions.  If that's not possible, they are translated with f2c and
  96. compiled with a C compiler.  Better performance is usually achieved if
  97. the intermediate translation to C is avoided.
  98.  
  99. The library of C++ classes may also be useful by itself.
  100.  
  101. Additional Information
  102. ----------------------
  103.  
  104. Up to date information about Octave is available on the WWW at the
  105. URL http://bevo.che.wisc.edu/octave, including archives of the
  106. help-octave, bug-octave, and octave-sources mailing lists.
  107.  
  108. --
  109. John W. Eaton
  110. jwe@bevo.che.wisc.edu
  111. University of Wisconsin-Madison
  112. Department of Chemical Engineering
  113.