Building

This document describes the process of building the .NET CLI to PIR translator.

Requirements

To build the translator you will need the following:-

• A C compiler, linker, make tool and Perl 5. If you have built Parrot before, you will already have all of these.
• ICU (International Components For Unicode), so Parrot can handle the UTF-16 strings used by .NET. Parrot must be built with ICU support.
• A built Parrot source tree. The Parrot source, available from SVN as well as a number of release builds, can be located at the Parrot webstie (http://www.parrot.org/.
• For running the regression tests and translating any vaguely real world programs (as in, ones that use the .NET class library), Mono (http://www.go-mono.com/). This is an open source implementation of the .NET runtime, class libraries and compilers.
• pod2html for generating HTML documentation (usually installed with Perl).

Building

Enter the source directory for the translator and run Configure.pl, passing it the path to your built Parrot source tree.

  perl Configure.pl --parrot ../parrot

This will generate a makefile. To build the translator using the makefile, type the name of the make program for your platform, which will likely be one of the following:

  make

Or

  nmake

Running The Tests

Run the regression tests like this:

  make test

Replacing make with the name of your make program, as used when building.