view etc/README.MinGW @ 12733:b67c2d580a25 stable

maint: clean up top-level directory * build-aux/bootstrap: Rename from bootstrap. * build-aux/bootstrap.conf: Rename from bootstrap.conf. * build-aux/changelog.tmpl: Rename from changelog.tmpl. * build-aux/bootstrap.conf: Update for new file locations. * build-aux/common.mk: Rename from common.mk. * build-aux/diff-template: Rename from diff-template. * build-aux/mk-opts.pl: Rename from mk-opts.pl. * build-aux/mkinstalldirs: Rename from mkinstalldirs. * build-aux/move-if-change: Rename from move-if-change. * etc/CHECKLIST: Rename from CHECKLIST. * etc/HACKING: Rename from HACKING. * etc/NEWS.1: Rename from NEWS.1. * etc/NEWS.2: Rename from NEWS.2. * etc/NEWS.3: Rename from NEWS.3. * etc/OLD-ChangeLogs/ChangeLog: Rename from OLD-ChangeLogs/ChangeLog. * etc/OLD-ChangeLogs/ChangeLog.1: Rename from OLD-ChangeLogs/ChangeLog.1. * etc/OLD-ChangeLogs/doc-ChangeLog: Rename from OLD-ChangeLogs/doc-ChangeLog. * etc/OLD-ChangeLogs/libcruft-ChangeLog: Rename from OLD-ChangeLogs/libcruft-ChangeLog. * etc/OLD-ChangeLogs/liboctave-ChangeLog: Rename from OLD-ChangeLogs/liboctave-ChangeLog. * etc/OLD-ChangeLogs/scripts-ChangeLog: Rename from OLD-ChangeLogs/scripts-ChangeLog. * etc/OLD-ChangeLogs/src-ChangeLog: Rename from OLD-ChangeLogs/src-ChangeLog. * etc/OLD-ChangeLogs/test-ChangeLog: Rename from OLD-ChangeLogs/test-ChangeLog. * etc/PROJECTS: Rename from PROJECTS. * etc/README.Cygwin: Rename from README.Cygwin. * etc/README.Linux: Rename from README.Linux. * etc/README.MacOS: Rename from README.MacOS. * etc/README.MinGW: Rename from README.MinGW. * etc/README.Windows: Rename from README.Windows. * etc/README.devel: Rename from README.devel. * etc/README.ftp: Rename from README.ftp. * etc/README.gnuplot: Rename from README.gnuplot. * etc/README.kpathsea: Rename from README.kpathsea. * etc/README.mirrors: Rename from README.mirrors. * etc/README.snapshots: Rename from README.snapshots. * etc/gdbinit: Rename from gdbinit. * m4/acinclude.m4: Rename from acinclude.m4. * src/mkoctfile.cc.in: Rename from mkoctfile.cc.in. * src/mkoctfile.in: Rename from mkoctfile.in. * src/octave-config.cc.in: Rename from octave-config.cc.in. * src/octave-config.in: Rename from octave-config.in. * config.guess, config.sub, missing, octave-sh: Delete. * Makefile.am: Include build-aux/common.mk instead of common.mk. * examples/Makefile.am, libcruft/Makefile.am, liboctave/Makefile.am, liboctave/config-ops.sh, scripts/Makefile.am, src/DLD-FUNCTIONS/config-module.sh, test/Makefile.am, autogen.sh, doc/Makefile.am, doc/faq/Makefile.am, doc/icons/Makefile.am, doc/interpreter/Makefile.am, doc/interpreter/config-images.sh, doc/liboctave/Makefile.am, doc/refcard/Makefile.am, build-aux/common.mk, src/Makefile.am: Update for new file locations. * Makefile.am: Don't build mkoctfile or octave-config here. * README: Update INSTALL info. * build-aux/mkinstalldirs: Update to new version. * src/Makefile.am (mkoctfile, octave-config): New targets.
author John W. Eaton <jwe@octave.org>
date Fri, 10 Jun 2011 14:35:42 -0400
parents README.MinGW@f0e61a6a0fb4
children 494f9bac8862 c49d891eb263
line wrap: on
line source

1. General Users
================

A MInGW bundle is available from sourceforge.

 http://octave.sourceforge.net/index.html

2. Developers
=============

The process for building Octave from source is as follows.

 * Install development tools and compiler
 * Install or compile dependencies of Octave
 * Download Octave source
 * Configure and compile source

We strongly encourage experienced users to build Octave from the
testing and development snapshots to try the latest features of Octave.

A good tutorial on building Octave for version 3.2 is available from 
http://octave.svn.sourceforge.net/viewvc/octave/trunk/octave-forge/admin/Windows/mingw32/HOWTO.txt 

Additional information beyond the tutorial is summarized below.

 2.1 Development tools and compiler
 ----------------------
 Msys + MinGW development Tools

 The Msys + MinGW development Tools are required to build Octave from source.

 The latest version of the Msys system is 1.0.16.  For MinGW, search and use
 the most recent version available.  Note: The Howto.txt file describing
 the development tools is rather old.

 The latest GCC (GNU Complier Collection) for MinGW is gcc-4.5.0.  Earlier
 versions are not recommended for building Octave 3.4.xx.

 The latest Msys, MinGW, and GCC tools can be downloaded from 
 http://sourceforge.net/projects/mingw/files/ 

 (Compiling for 64-bit binaries requires mingw-64 toolkits.  This has not been
  tested.)

 2.2 Dependencies
 ----------------------

 External program dependencies
 
  * gnuplot (you can build this with the shell script mentioned in Howto.txt)
  * MikTeX
  * ghostscript
  * pstoedit (required for printing using FLTK (OpenGL) graphics)
  * fig2dev (Optional; better quality for FLTK printing in some file formats)
  * sed
  * less

 The tools below are required for building the development sources from
 the Mercurial archive, but not for simply building Octave from a snapshot
 tar.gz file.

  * Mercurial
  * git
  * automake
  * autoconf

 Library dependencies

  Please read Howto.txt carefully on how to build them.  The Howto.txt is old
  so some revisions will be required when using GCC-4.5.0

 2.3 Download Octave source
 ----------------------

  The source for testing snapshots can be downloaded from the official Octave
  web site.  http://www.gnu.org/software/octave/download.html 

  The very latest development code is also available via anonymous access to a
  read-only Mercurial archive.  The method of download is described on the web
  site.  You will also need to install gnulib as another dependency.  Please
  visit http://www.gnu.org/software/gnulib/ and download sources using git.

 2.4 Configure and compile source
 ----------------------

  Building from source can be carried out using the script described in
  Howto.txt.  
  
  When using GCC-4.5.0, remove flags for shared libstdc++ because a shared
  build is already the default.

  When running './configure', you must add '--enable-float-truncate' option. 
  Please see the following thread for more information: 
  http://thread.gmane.org/gmane.comp.gnu.octave.bugs/12361/focus=12404

  To build development sources from the Mercurial repository you must run
  'autogen.sh' (bootstrap) before running configure and make.  This requires
  that automake and autoconf tools be installed.


Tatsuro MATSUOKA
tmacchant@yahoo.co.jp

Benjamin Lindner
bjmldn@gmail.com 


Last updated: Sat Jan 22 17:29:12 PST 2011