Build guide

To use Naggum, first of all you need to build it from source.

Windows

To build Naggum on Windows, just use Visual Studio or MSBuild like that:

$ cd naggum
$ nuget restore
$ msbuild /p:Configuration=Release Naggum.sln

Linux

See general build instructions for Linux in the file .travis.yml inside the Naggum source directory.

You’ll need Mono, NuGet and F# Compiler installed. Some of them may or may not be part of your Mono installation; just make sure you’ve got them all.

Please note that currently the project is compatible with Mono 4.4.2+.

Below is an example of setting up these tools on NixOS Linux; feel free to add instructions for any other distributions.

NixOS Linux

The instructions have been verified on NixOS 16.03. If something doesn’t work, please file an issue.

Enter the development environment:

$ cd naggum
$ nix-shell

After that you can download the dependencies and build the project using xbuild:

$ nuget restore
$ xbuild /p:Configuration=Release /p:TargetFrameworkVersion="v4.5"

After that, you can run Naggum.Compiler, for example:

$ cd Naggum.Compiler/bin/Release/
$ mono Naggum.Compiler.exe ../../../tests/test.naggum
$ mono test.exe

Documentation

You can build a local copy of Naggum documentation. To do that, install Python 2.7 and Sphinx. Ensure that you have sphinx-build binary in your PATH or define SPHINXBUILD environment variable to choose an alternative Sphinx builder. After that go to docs directory and execute make html (on Linux) or .\make.bat html (on Windows).