Differences

This shows you the differences between two versions of the page.

--- install:compile_cygwin [2008/08/25 12:51] – 92.252.45.110
+++ install:compile_cygwin [2010/12/03 09:30] (current) – old revision restored eros
@@ Line 1: / Line 1: @@
 ====== Compiling CWB from source under Windows ======
-Compilation and installation of CWB version 2.2.b98
+Compilation and installation of CWB version 3.0
+===== Status of the Cywgin port =====
+The Cygwin port of the CWB is **experimental**.  While the source code compiles without error messages and basic CQP queries work well, it is currently not possible to process large corpora (e.g. in the 100M word range).
+The problems we have encountered may be due to limitations in the virtual memory management of Windows and the Cygwin emulation layer manage.  Apparently, a user process is limited to a 2 GB address space in Windows, and Cygwin seems to impose [[http://cygwin.com/cygwin-ug-net/setup-maxmem.html|further restrictions]].  Help from someone with more experience in Windows and Cygwin programming would be highly welcome, so that we can identify the true cause of the problems and try to find a workaround.
+In the long term, we hope to offer a native Windows port of the CWB.  Please join the [[http://devel.sslmit.unibo.it/mailman/listinfo/cwb|CWBdev mailing list]] if you would be interested to work on this port.
@@ Line 12: / Line 24: @@
   * ''gcc''
   * ''libncurses-devel''
+  * ''make''
+  * ''perl''
 We recommend to install the simple text editor ''nano'' (from the //Editors// section) for editing configuration files, but you can also use your favourite Windows text editor.
 ===== Getting the source code =====
-Get the source code from [[http://cwb.sourceforge.net/|here]], and unpack it:
+Get the source code from [[http://sourceforge.net/projects/cwb/|here]], and unpack it:
 <code bash>
-tar xf cwb-XXXXXX.tgz
+tar xf cwb-XXXXXX.tgz (current version 2.2.b99-RC1)
 </code>
@@ Line 26: / Line 41: @@
 <code bash>
-cd cwb-3.0
+cd cwb-XXXXXX (current version 2.2.b99-RC1)
 </code>
+**Important note:** In principle, you can unpack the CWB source code anywhere you like, but //don't put it on a network drive// (we've encountered some weird errors there) and make sure that the directory path //does not contain blanks// (which will happen e.g. if you put the source code on your Desktop). The best solution is probably to keep the source code somewhere in the Cygwin directory tree, e.g. your Cygwin home directory.
@@ Line 38: / Line 55: @@
 </code>
-Otherwise, navigate to the ''cwb-3.0'' directory in Windows Explorer and open the file ''config.mk'' with a text editor.
+Otherwise, navigate to the ''cwb-XXXXXX'' directory in Windows Explorer and open the file ''config.mk'' with a text editor.
 In the **platform** directive, insert //cygwin//
@@ Line 82: / Line 99: @@
 include $(TOP)/config/site/cygwin
 </file>
 ===== Compilation =====
-Then we compile the different components, one at a time. First we clean and check dependencies:
+The easiest way to compile the CWB is to type
+<code bash>
+make all
+</code>
+at the command line, and go to fetch a cup of coffee (due to the overhead of the Cygwin emulation layer, compilation is much slower than on Unix systems).
+Since the Cygwin port is still experimental, it is probably a good idea to compile each component of the CWB separately. This will make it easier to recognise compilation errors and warnings. First, clean up any old files and check dependencies:
 <code bash>
@@ Line 92: / Line 119: @@
 </code>
-Then we compile the corpus library:
+Then, compile the ''editline'' library used by CQP, which is included in the CWB source code distribution:
 <code bash>
-make cl
+make editline
 </code>
-Then editline:
+Now compile the corpus library:
 <code bash>
-make editline
+make cl
 </code>
 Then the utilities:
@@ Line 110: / Line 138: @@
 </code>
-Finally we compile cqp:
+And finally CQP:
 <code bash>
 make cqp
 </code>
+You may also want to check that the manpages are up to date:
+<code bash>
+make man
+</code>
 ===== Installation =====
@@ Line 121: / Line 157: @@
 <code bash>
-sudo make install
+make install
 </code>
+If you have set up Cygwin with a separate administrator account, you may need to type ''sudo make install'' and enter the administrator password here.