= Install on Windows (from source, with CMAKE) =

== Prerequisites ==

 - You must have a C++ compiler. We assume here [http://en.wikipedia.org/wiki/Microsoft_Visual_Studio Visual Studio 2008]. The freely available [http://www.microsoft.com/Express/ Express Edition] is fine.
 - You must also download and install [http://www.cmake.org/files/v2.6/cmake-2.6.2-win32-x86.exe CMake 2.6.2 (.exe installer)] or later.

Optional tools:
 - For HTML document generation you need to install a recent version of {{{Doxygen}}} and {{{Ghostscript}}}.
 - If you want to keep track of the latest development of LEMON or even contribute to it, you need the [http://http://www.selenic.com/mercurial Mercurial] distributed version control system. We ''strongly'' recommend to use [http://tortoisehg.sourceforge.net/ TortoiseHg] which provides a simple installer for Mercurial, a nice GUI and also an integration to the MS-Windows Explorer.

== Obtaining the Source ==

 - Either download and extract the following {{{.zip}}} files.
   - [http://lemon.cs.elte.hu/hg/lemon-main/archive/r1.0.1.zip Latest stable release, version 1.0.1 (.zip)]
   - [http://lemon.cs.elte.hu/hg/lemon-main/archive/tip.zip Latest development snapshot (.zip)]
 - Or check out it with Mercurial. The development repository url is
   - http://lemon.cs.elte.hu/hg/lemon-main

== Configure the CMAKE ==

The compilation must be done in a separate folder. We suggest to create a subfolder called '''{{{build}}}''' in the root of the source code repository.

Then start the CMake GUI and browse the source code and the build folders.

It is even better to start the "Visual Studio 2008 Command Prompt" from the start menu. Then, in the command prompt, step into the build folder and type
{{{
cmake-gui ..
}}}
Now click on the "Configure" button. Here choose 
 - either '''{{{Visual Studio 9 2008}}}''' to create project files and an {{{.sln}} file usable from the Visual Studio IDE.
 - or '''{{{NMake Makefiles}}}''' to create makefiles and compile from command line. In this case you ''must'' start {{{cmake-gui}}} from the "Visual Studio 2008 Command Prompt"
Then click again on "Configure" and finally on "Generate".

The configuration is done

== Build and install ==

=== With NMake ===

 - Start the "Visual Studio 2008 Command Prompt".
 - Step into the build folder
 - To compile the source and build the library type
   {{{
nmake
   }}}
 - For executing the self tests run
   {{{
ctest
   }}}
 - To generate the HTML documentation (see the prerequisites above) type
   {{{
nmake html
   }}}
 - Finally, to install LEMON, type
   {{{
nmake install
   }}}

=== With IDE ===

Open the generated {{{LEMON.sln}}} file, the you will find several targets corresponding to the tasks of the previous section. They are
 - {{{ALL_BUILD}}}
 - {{{RUN_TESTS}}}
 - {{{HTML}}} ???
 - {{{INSTALL}}}