Developer Repository for ViennaCL
==========================================

*Looking for ViennaCL releases? Visit [http://viennacl.sourceforge.net/](http://viennacl.sourceforge.net/)*

This is the developer repository of ViennaCL including the latest features and changes. Feel free to clone the repository, send us your pull requests, or update the Wiki here at github. All contributions are welcome. You might also want to subscribe to our [developer mailing list](http://lists.sourceforge.net/mailman/listinfo/viennacl-devel). There are no 'stupid questions', so don't hesitate to get in contact with us.

To build the developer version of ViennaCL, simply clone the repository and issue the following commands (the following steps are for Unix-based systems):
<pre>
$> cd viennacl-dev
$> cd build
$> cmake ..
$> make
</pre>

(Note that parallel builds using e.g. `make -j4` won't work straight away because the OpenCL kernels need to be build first. Only after the kernels are built, you can interrupt the build process and issue `make -j4`). Additional build options are available when calling `cmake-gui` instead of `cmake`

Feedback from developers on Windows on the build process of the developer version are welcome.

System requirements for the developer version:

* Boost libraries >= 1.45 (older versions require to define `USE_OLD_BOOST_FILESYSTEM_VERSION` in auxiliary/converter.cpp)
* CMake 2.8 or higher
* A not-too-ancient C++ compiler

Optional:

* OpenMP-enabled C++ compiler
* One or more OpenCL SDKs (1.1 or higher)
* CUDA toolkit (4.x or higher)
* Eigen (3.0 or higher)
* MTL 4


Sending Pull Requests
--------------------------

We strive for high code quality and maintainability. Before sending pull requests, please ensure that your contribution passes the following minimum requirements, which are commonly considered good practice in software engineering:

* The new code passes all tests when running 'make test'.
* The new code compiles cleanly at high warning levels (-Wall -pedantic, just enable `ENABLE_PEDANTIC_FLAGS` within CMake) on at least GCC and/or Clang, ideally also Visual Studio compilers. The more the better, but at least one of the compilers should have been tested.
* For new functions or classes, please add Doxygen comments to the code. This makes it easier for others to quickly build on top of your code.
* Don't use tabs. Configure your editor such that it uses two spaces instead.

Thanks! :-)