diff --git a/doc/source/users_guide/CMakeLists.txt b/doc/source/users_guide/CMakeLists.txt index 4450c63037..91cadd9b32 100644 --- a/doc/source/users_guide/CMakeLists.txt +++ b/doc/source/users_guide/CMakeLists.txt @@ -1,4 +1,5 @@ set(SOURCES index.rst + installing.rst using.rst files.rst groups.rst diff --git a/doc/source/users_guide/index.rst b/doc/source/users_guide/index.rst index 9edb62f27b..204f6cccdb 100644 --- a/doc/source/users_guide/index.rst +++ b/doc/source/users_guide/index.rst @@ -2,13 +2,14 @@ Users guide =========== -This chapter will contain the userse guide for the C++ wrapper. +This chapter will contain the users guide for the C++ wrapper. Still need to add a table of contents here. .. toctree:: :maxdepth: 1 - + + installing using overview files diff --git a/doc/source/users_guide/installing.rst b/doc/source/users_guide/installing.rst new file mode 100644 index 0000000000..8f54608a7c --- /dev/null +++ b/doc/source/users_guide/installing.rst @@ -0,0 +1,47 @@ +====================== +Installing the library +====================== + +This chapter describes the installation of *h5cpp* from sources. + +Requirements +------------ + +In order to build the code you need + +* a C++ compiler with reasonable C++11 support (gcc>=4.9,Micrsoft Developer Studio >= 2015) +* the Boost libraries +* the HDF5 C library +* googletest to build the unit tests +* sphinx (with python) and doxygen for the documentation build +* cmake >= 3.0 + +Getting the code +---------------- + +You can either obtain one of the release tar balls from the `release site`_ of the +project on GitHub or clone the master branch of the repository. +In the first case you get a source tree with + +.. code-block:: bash + + $ tar -xzf h5cpp-*.tar.gz + +while in the latter you may want to use + +.. code-block:: bash + + $ git clone https://github.com/ess-dmsc/h5cpp.git + +*h5cpp* uses :program:`CMake` to build the code in which case an out of +source build is recommended. + +_release site: https://github.com/ess-dmsc/h5cpp/releases + + + +Building and testing +-------------------- + +Installation +------------ \ No newline at end of file