File	Date	Author	Commit
bin	2012-08-10	Pavel Shvets	[98b32e] some commit
doc	2012-05-16	Andrew V. Adinetz	[d19080] version 0.0.6 (beta)
samples	2012-09-25	Pavel Shvets	[19e339] some fixes, merge(and why it decided to merge? ...
src	2012-09-25	Pavel Shvets	[19e339] some fixes, merge(and why it decided to merge? ...
tst	2012-09-25	Pavel Shvets	[19e339] some fixes, merge(and why it decided to merge? ...
.cvsignore	2011-04-13	andrew	[b7af33] added some documentation
.gitignore	2012-08-10	Pavel Shvets	[98b32e] some commit
.gitignore.orig	2012-08-10	Pavel Shvets	[98b32e] some commit
changelog.txt	2012-05-16	Andrew V. Adinetz	[4aeadd] updated documentation
extran-key.snk	2010-08-30	andrew	[b12ce9] initial commit for NUDA project
extran-macros.nproj	2012-09-06	Andrew V. Adinetz	[36d5a6] Merge branch 'dislib' into dislib_w_cuda_fixes
extran-runtime.nproj	2012-09-06	Andrew V. Adinetz	[36d5a6] Merge branch 'dislib' into dislib_w_cuda_fixes
extran-stdlib.nproj	2012-09-06	Andrew V. Adinetz	[36d5a6] Merge branch 'dislib' into dislib_w_cuda_fixes
extran-strategy.nproj	2012-08-10	Pavel Shvets	[98b32e] some commit
lgpl.txt	2010-08-30	andrew	[0415b4] added license file to project root
makefile	2012-08-10	Pavel Shvets	[ee4789] premerge 1
makefile.def	2012-08-10	Pavel Shvets	[ee4789] premerge 1
nuda.sln	2012-08-10	Pavel Shvets	[98b32e] some commit
readme	2012-08-10	Pavel Shvets	[98b32e] some commit

Read Me

README

This is a readme file for extran project for Nemerle. Extran project is a testbed for
using existing extensible programming tools for parallel programming.

REQUIREMENTS

In order to compile this project, you need to have the following installed on your computer:

1) a version of Mono which will run Nemerle under Linux (2.11 was tested, other
mono versions must also work, starting probably from 2.8)

2) a version of Nemerle, tested with 1.1.372

3) NUnit version 2.4.8 (required only to run tests, now comes with mono by default)

For running OpenCL and NUDA programs:

1) a GPU with OpenCL 1.0 or higher support. Any NVidia GPU with CUDA capability 1.1 and
higher, and any ATI Radeon HD 3000 or higher series GPU (or equivalent professional or
servier grade GPUs) is OK

2) working OpenCL GPU implementation (AMD Stream SDK 2.1 or higher, or NVidia CUDA 3.0 or
higher is OK)

3) libgpuvm installed (http://github.com/canonizer/libgpuvm); affects only data
transfer efficiency, not functionality

BUILDING

To build the dll, simply run the following command in the root directory of the project:

make

For testing, run the following command in the root directory of the project:

make test

Note that if you don't have a supported GPU (see REQUIREMENTS), all OpenCL-related tests
will fail.

To compile the current version of documentation in doc/, you'll need a working LaTeX
distributive. To compile documentation, run the following command in the root of the
project:

make doc

INSTALLATION

First, set your mono path in the makefile.def file. Mono requires additional manipulation
for GAC-installed libraries to be visible to the compiler, and those manipulations need to
know the root Mono path. By default, it is /usr/lib/mono, and it can be changed in makefile.def.

For installing, run the following command in the root directory of the project:

make install

This will sign the assemblies, install them into GAC and set necessary softlinks. Note
that the user running this command must be permission to write into GAC. With default
installation path, this means the user must be a root. 

For uninstallation, run the following command in the root directory of the project:

make uninstall

SAMPLES

In order to compile samples, execute make in samples directory. If you already have a
version of NUDA installed in GAC (see INSTALLATION), be sure to set MONO_PATH=. in order
to use development version.

USING

See samples directory for Extran and NUDA samples. Also see documentation in doc/extran-guide.pdf.

//---------------------------------------

Building on Windows machine

REQUIREMENTS

MS Visual Stuido 2010,  Nemerle v1.1.372.0 (integrated to msvs)
	
BUILDING

1) Open nuda.sln in Visual Studio
2) Find a build button on your keyboards (F7, usually)
3) Press it

BUGS

Registering in GAC must be done manually as for now, but it is not necessary for work