3
0
mirror of https://github.com/triqs/dft_tools synced 2024-12-25 13:53:40 +01:00
dft_tools/doc/installation/clang.rst
2014-10-18 21:19:51 +02:00

68 lines
2.1 KiB
ReStructuredText

.. index:: clang
.. highlight:: bash
.. _install_clang:
Using the clang compiler
========================
**clang/llvm** is one of the very best C++ compilers, with gcc. It is open
source on linux and OS X (where it is now the standard compiler provided by
Apple).
The **clang** compiler is *highly recommended* for anyone developing in C++ since:
* It is standard compliant (C++11).
* It has very nice and useful error messages, much nicer than intel or gcc (even thought gcc is catching up).
It really makes little sense to develop with e.g. gcc 4.6 today, especially with a library like TRIQS,
which uses a lot of metaprogramming.
Note, however, that for *production* compilations, gcc, especially recent versions, still produces in general
a slighly more optimal code for TRIQS applications, even if the differences are small. In fact, a bug in the
compiler was recently found and reported.
It is highly recommended to use the latest stable version on Linux (3.4), and the default compiler on OS X (Mountain lion).
Get and install clang on linux
------------------------------
Precompiled versions are available at the `LLVM dowload page <http://llvm.org/releases/download.html>`_.
Just untar them and add the directory in your path.
It is also very easy to compile **clang** from source, just follow the
`instructions <http://clang.llvm.org/get_started.html#build>`_.
Usage
-----
In order to use clang when building TRIQS::
CXX=clang++ cmake -DCMAKE_INSTALL_PREFIX=path_to_install_directory ../src + other options
.. note::
On OS X, the options -std=c++11 and -stdlib=libc++ are automatically added by the TRIQS
installation script.
libclang
----------
Some tools for developers (e.g. automatically C++/Python wrapper generation), use libclang
(delivered with clang), and its python bindings (usually not given).
The latest version is necessary.
A pip package, updated to the latest version, is on github.
Install it simply with ::
pip install -e git+https://github.com/parcollet/python-clang.git#egg=clang
To uninstall it (or another version) ::
pip uninstall clang