Commit 06655d3f authored by PRUVOST Florent's avatar PRUVOST Florent

fix docs -> doc, update ChangeLog

parent 4a1077c1
...@@ -6,6 +6,7 @@ chameleon-1.0.0 ...@@ -6,6 +6,7 @@ chameleon-1.0.0
- Add First stage algorithm fo r the SVD/EVD solvers - Add First stage algorithm fo r the SVD/EVD solvers
- add timing drivers time_zpotrs_tile and time_zgeqrs_tile - add timing drivers time_zpotrs_tile and time_zgeqrs_tile
- deactivate warmup by default - deactivate warmup by default
- add an orgmode user guide documentation, see in doc/orgmode/
chameleon-0.9.1 chameleon-0.9.1
------------------------------------------------------------------------ ------------------------------------------------------------------------
......
This diff is collapsed.
...@@ -43,7 +43,6 @@ dedicated to dense linear algebra. ...@@ -43,7 +43,6 @@ dedicated to dense linear algebra.
now. Future releases will be available on this gitlab project. now. Future releases will be available on this gitlab project.
* Documentation * Documentation
** User guide ** User guide
The user guide is available directly in the sources as emacs The user guide is available directly in the sources as emacs
orgmode files, see : orgmode files, see :
...@@ -51,6 +50,13 @@ dedicated to dense linear algebra. ...@@ -51,6 +50,13 @@ dedicated to dense linear algebra.
2) [[file:doc/orgmode/chapters/installing.org][Installing]] 2) [[file:doc/orgmode/chapters/installing.org][Installing]]
3) [[file:doc/orgmode/chapters/using.org][Using]] 3) [[file:doc/orgmode/chapters/using.org][Using]]
This documentation could also be generated in html and/or pdf :
#+begin_src
# build the doc with cmake (emacs with orgmode and latex are required), e.g.
cmake .. -DCHAMELEON_ENABLE_DOC=ON
make doc
#+end_src
** Source code documentation (doxygen) ** Source code documentation (doxygen)
There is no up-to-date documentation of Chameleon. We would like to There is no up-to-date documentation of Chameleon. We would like to
provide a doxygen documentation hosted on [[https://about.gitlab.com/2016/04/07/gitlab-pages-setup/][gitlab]] in the provide a doxygen documentation hosted on [[https://about.gitlab.com/2016/04/07/gitlab-pages-setup/][gitlab]] in the
......
...@@ -28,7 +28,6 @@ developers must follow and that should be read by contributors. ...@@ -28,7 +28,6 @@ developers must follow and that should be read by contributors.
* Documentation * Documentation
<<sec:doc>> <<sec:doc>>
** Generate the documentation ** Generate the documentation
*** Prerequisites *** Prerequisites
To generate the documentation you need to have [[http://www.stack.nl/~dimitri/doxygen/][Doxygen]] and To generate the documentation you need to have [[http://www.stack.nl/~dimitri/doxygen/][Doxygen]] and
...@@ -36,25 +35,25 @@ developers must follow and that should be read by contributors. ...@@ -36,25 +35,25 @@ developers must follow and that should be read by contributors.
For example, on Debian systems: For example, on Debian systems:
#+begin_src sh #+begin_src sh
sudo apt install doxygen texinfo sudo apt install doxygen texinfo texlive texlive-latex-extra emacs
#+end_src #+end_src
*** configure + make documentation *** configure + make documentation
Enter into the Chameleon's source root directory and configure Enter into the Chameleon's source root directory and configure
with *CHAMELEON_ENABLE_DOCS=ON*, then generate the documentation with *CHAMELEON_ENABLE_DOC=ON*, then generate the documentation
with ~make docs~ with ~make doc~
#+begin_src sh #+begin_src sh
cd chameleon cd chameleon
mkdir build && cd build mkdir build && cd build
cmake .. -DCHAMELEON_ENABLE_DOCS=ON cmake .. -DCHAMELEON_ENABLE_DOC=ON
make docs make doc
#+end_src #+end_src
** Rules about source code documentation ** Rules about source code documentation
Please refer to this file for the documentation guidelines [[file:docs/doxygen/README.org][README]]. Please refer to this file for the documentation guidelines [[file:doc/doxygen/README.org][README]].
* Naming and writting conventions * Naming and writting conventions
...@@ -83,8 +82,10 @@ developers must follow and that should be read by contributors. ...@@ -83,8 +82,10 @@ developers must follow and that should be read by contributors.
#+begin_src sh #+begin_src sh
export CHAMELEON_ROOT=/path/to/chameleon/sources/to/be/released export CHAMELEON_ROOT=/path/to/chameleon/sources/to/be/released
cmake $CHAMELEON_ROOT -DCHAMELEON_ENABLE_DOCS=ON cmake $CHAMELEON_ROOT -DCHAMELEON_ENABLE_DOC=ON
make docs && cp docs/texinfo/users_guide.pdf $CHAMELEON_ROOT && make package_source make doc
cp doc/orgmode/users_guide.pdf $CHAMELEON_ROOT
make package_source
#+end_src #+end_src
A tarball chameleon-major.minor.patch.tar.gz should be generated A tarball chameleon-major.minor.patch.tar.gz should be generated
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment