Skip to content

Latest commit

 

History

History
110 lines (87 loc) · 3.95 KB

README-MinGW64.md

File metadata and controls

110 lines (87 loc) · 3.95 KB
Raw

BUILDING on Windows (MinGW/MSYS2)

General

In this document we will suppose you use a 64-bit machine.

MinGW/MSYS2 uses the Gnu toolset to compile Windows programs for Windows. This is probably the easiest way to obtain workable Java bindings for Windows.

In order to prepare this document, MSYS2 version 20161025 was installed.

A note for new MSYS2 users

Download and install MinGW/MSYS2 from http://msys2.org.

MSYS2 uses the pacman package management. If you are not familiar with it, consult the Pacman Rosetta.

Also note that MSYS2 have two working modes (shells): MSYS and MINGW64. The difference between them is the value of environment variables, e.g. PATH, PKG_CONFIG_PATH and MANPATH. For native Windows software development, the MINGW64 shell must be used (the MSYS shell is for MinGW/MSYS2 development- applications compiled from it recognize the MSYS virtual filesystem).

First install mingw-w64-x86_64-toolchain. Also install the rest of the prerequisite tools from the list in the main README.

NOTE: You must also install mingw-w64-x86_64-pkg-config .

You may find that the system is extremely slow. In that case, consult the Web for how to make tweaks that considerably speed it up. In addition, to avoid I/O trashing, don't use a too high make parallelism (maybe even only -j 2).

Packages that are used by the link-grammar library

mingw-w64-x86_64-sqlite3
mingw-w64-x86_64-libtre-git
mingw-w64-x86_64-gettext
mingw-w64-x86_64-hunspell, mingw-w64-x86_64-hunspell-en (optional)
zlib-devel (optional - for the SAT parser)
mingw-w64-x86_64-python2
mingw-w64-x86_64-python3

Java bindings

Install Apache Ant and Java JDK & JRE (both under Windows). Make sure you have the environment variable JAVA_HOME set as needed (under Windows, the MINGW64 shell will inherit it).

Then build and install link-grammar with

 mkdir build
 cd build
 ../configure
 make
 make install

In MINGW64, the default install prefix is /mingw64 which is mapped to C:\msys64\mingw64, so after 'make install', the libraries and executable will be found at C:\msys64\mingw64\bin and the dictionary files at C:\msys64\mingw64\share\link-grammar.

Python bindings

The bindings for Python2 (2.7.15) and Python3 (3.7.0) work fine.
All the tests pass (when configured with hunspell and the SAT parser).

Here is a way to work with python3 from Windows:

C:\>cd \msys64\mingw64\bin
C:\msys64\mingw64\bin>.\python3
Python 3.7.0 (default, Jul 14 2018, 09:27:14)  [GCC 7.3.0 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> from linkgrammar import *
>>> print(Sentence("This is a test",Dictionary(),ParseOptions()).parse().next().diagram())

    +----->WV----->+---Ost--+
    +-->Wd---+-Ss*b+  +Ds**c+
    |        |     |  |     |
LEFT-WALL this.p is.v a  test.n

>>>

Test results

All the tests.py tests pass, and also make installcheck is fine. From the tests in the tests/directory, the multi-thread test fails due to segfault at the hunspell library (a fix for that is being investigated). Regretfully, using Aspell for now is not an option, as it is not available yet for MinGW.

BTW, here is how to run the java-multi test directly:
cd tests; make TEST_LOGS=multi-java check-TESTS

Running

On MINGW64, just invoke link-parser.
In Windows, put C:\msys64\mingw64\bin in your PATH (or cd to it), then invoke link-parser. On both MINGW64 and Windows console, you can invoke mingw/link-parser.bat, which also sets PATH for the dot and PhotoViewer commands (needed for the wordgraph display feature). For more details see RUNNING the program.