--------------------------------------------------------------

  MatEx-2D Tools

                                                  2004/3/31
  ISHIGURO, Makio, the Institute of Statistical Mathematics
  SAITO, Muneyoshi, Mathematical Systems Inc.
-------------------------------------------------------------

MatEx-2D Tools is a package of tools for the display and conversion 
of mathematical documents written in MatEx-2D, the 2-dim. language 
for mathematical expressions.

1. MatEx-2D, the 2-dim. language for mathematical expressions

"MatEx-2D" provides an intuitive and easy-to-read  way to express 
mathematical equations in a text file by way of the 2-dim. use of 
the text file. For details of MatEx-2D, read "2-dim. Language for
Mathematical Expressions, MatEx-2D" (doc/MatEx-2D.pdf, in Japanese).


2. MatEx-2D Tools

 1) MatEx-2D converter

   convert MatEx-2D format mathematical expressions into other formats.
   At present, conversion to TeX format is provided. 

 2) MatEx-2D ActiveX

   The component for displaying the mathematical expression in
   MatEx-2D format. It could be used to display mathematical 
   equations on browsers or self-made applications.

 3) MatEx-2D viewer

   The application for MatEx-2D mathematical expression check.

 4) MatEx-2D manager, the MatEx-2D ActiveX configurater 

    Fonts and/or coloring of MatEx-2D ActiveX could be customized.

All four tools can be used On Windows machines. On Linux machine,
the first one only works.

3. Environment

MatEx-2D Tools works on:

   - Windows 2000, Windows XP, Linux



4. Development Environment

  - Windows
   
     WindowsXP
     Microsoft Visual C++ 6.0(SP5)
     Microsoft Internet Explorer 6.0
     gcc version 3.3.1(Cygwin)

  - Linux

     RedHat 8.0
     gcc version 3.2

  - Languages

    C++ flex

    Compilers: g++ AMicrosoft Visual C++

5. Packages
  There are two kinds of package.
  matex-v1-0-win32.zip   ---> Package for Windows
  matex-v1-0-unix.tar.gz ---> Package for Linux

  Contents of packages(the same construction for both packages)

  ReadMe_e.txt -------> This file
  ReadMe_j.txt -------> Japanese version
  oml.basic.pdf ----> about OML  
  bin/ -------------> Binary and configuration files for Windows
  doc/
    release.pdf ------------> Release note(in Japanese)
    MatEx-2D.pdf -----------> MatEx-2D manual(in Japanese)
    matex2.pdf -------------> About MatEx-2D converter(in Japanese)
    activex-usage.pdf-------> On the use of ActiveX(in Japanese)
    detail.pdf -------------> detail of the installation(in Japanese)
  src/ -------------> source files
  sample/ ----------> HTML samples for the use of ActiveX on IE



6. Compile & Install

6.1. Windows

 EUsing the installer

   Installer for Windows version is prepared.

  [Install]

    Execute setup.exe, and follow the instruction of the installer.

  [Uninstall]

    Use "Add/Delete application" procedure of the "Control Panel".
 

 ECompile the source code

  [download/defreeze]
    download matex-v1-0-win32.zip and defreeze.

  [Compilation]

    If the environment allows, "VC project"for the compilation from
     the source is provided(src/vcprj/prjs/). Open the folder and
     build selecting the options 'prjs' and 'Win32 Release', then
     the binaries are copied under the folder src/vcprj/prjs/Release.

  [Installation]

   1) Place the binaries and configuration files

      Place the binaries and configuration files under the bin folder
      together in a folder.

   2) Edit install.bat and execute

   install.bat file looks as follows

-------------------------------------------------
@rem
@rem change the value of appname
@rem

@set appname="C:\foo\MatEx2DViewer.exe" <---- Change here
@regsvr32 /s MatEx2D.ocx
@regedit /S MatEx2D_safe.reg
@call createreg.bat %appname% > assoc.reg
@regedit /S assoc.reg
------------------------------------------------

   Change "C:\foo" to the pathname of the folder you placed the binaries
   file.

   Then execute the edited install.bat.


  [Uninstall]

   Execute uninstall.bat, and delete the binaries and configuration files.

   
6.2. Linux or Cygwin

For Linux or Cygwin on Windows, "MatEx-2D TeX converter" alone can be
used.

Download and defreeze matex-v1-0-unix.tar.gz, and compoile as follows:

  % cd src/
  % ./compile.sh

When the compile script normally finished, following files are
produced under the directory src/bin

    matex2

     executable file of "MatEx-2D TeX converter"
     (In case of Cygwin, the name is matex2.exe)

    libmatex.a

      MatEx-2D TeX converter libraly

    matex.h

      MatEx-2D TeX converter header file
      
    libtest.c

      Sample program of MatEx-2D TeX converter library use


7. Copyright and License condition

 MatEx-2D Tools

 [Copyright holders' statement]
 MatEx-2D Tools is a package of softwares which are realization of
 Ishiguro's original idea of 2-dim. mathematical expression parser 
 by Saito of Mathematical Systems Inc. We distribute this software 
 from ISMLIB of the Institute of Statistical Mathematics, ISM
 ( http://www.ism.ac.jp/ismlib/index_e.html ) under the conditions 
 of Open Market License(version:OML-SW-E-1996) proposed by 
 ISM( /http://www.ism.ac.jp/ismlib/license_e.html). The OML allows 
 the free use of the source code, including redistribution and 
 modification as far as the whole of this copyright holders' statement
 is copied and shown conspicuously in the redistribution or the 
 modified version or the document attached to the products made 
 utilizing MatEx-2D Tools.

 Copyright holders take no responsibility for any damage caused by the
 use of this software.

 Copyright_OML 2004
 ISHIGURO, Makio, the Institute of Statistical Mathematics
 SAITO, Muneyoshi, Mathematical Systems Inc.
 [End of Copyright holders' statement]