Hello,
The documentation explain how to build doc.dox-part and doc.dox-skeleton, but next steps are not clearly described. What and how to use Cmake to produce doxygen documentation?
Thanks
documentation openvibe
Re: documentation openvibe
Hello MatthieuG,
The documentation is generated along with the applications when you run the build script. Everything ends in
/openvibe-documentation/. If you are running on Windows, we currently have some problems: CMake does not parse every subdirectory, thus the documentation is not generated correctly. But if you build on linux, you should have your documentation (html / latex) in the /openvibe-documentation/ directory.
I hope this helps !
Laurent-
The documentation is generated along with the applications when you run the build script. Everything ends in
/openvibe-documentation/. If you are running on Windows, we currently have some problems: CMake does not parse every subdirectory, thus the documentation is not generated correctly. But if you build on linux, you should have your documentation (html / latex) in the /openvibe-documentation/ directory.
I hope this helps !
Laurent-
Re: documentation openvibe
so the good way is usually :
_create a dox-part in plugins\src\doc
_create a dox-skeleton in openvibe-documentation
-lunch the build script (win32- or linux-build)
But under windows, it doesn't process, does it!
The result of process should appear in openvibe-documentation?
_create a dox-part in plugins\src\doc
_create a dox-skeleton in openvibe-documentation
-lunch the build script (win32- or linux-build)
But under windows, it doesn't process, does it!
The result of process should appear in openvibe-documentation?
Re: documentation openvibe
You don't even have to do it yourself ;)_create a dox-part in plugins\src\doc
_create a dox-skeleton in openvibe-documentation
run the openvibe-plugin-inspector, it will check all existing boxes, and create the xxxx.dox-part-skeleton and xxxx.dox-skeleton files for you. The 2 files will be in /openvibe-documentation. Copy-paste the xxxx.dox-part-skeleton file in openvibe-plugins/[path-to-your-plugin-branch]/src/doc, rename it to xxxx.dox-part and complete it.
then run the linux build script, and watch the result in /openvibe-documentation.
Indeed, it doesn't process under Windows.But under windows, it doesn't process, does it!
Your question have made us think about our current documentation tutorial, which is incomplete. We will certainly update it to be more precise, and include the plugin-inspector usage.
Laurent-
- EDITED (Tue Dec 8) -
Re: documentation openvibe
It would be a very good idea to generate documentation pattern with plugin-inspector. At present, it seems it doesn't.
Re: documentation openvibe
I edited my last reply to be more precise.
You just have to fill the file between these tags with your documentation, copy the file in your plugin folder and rename it xxxx.dox-part.
Hope this helps
Laurent
The plugin-inspector generates such pattern, it's the xxxx.dox-part-skeleton file. This file contains every tags such as :It would be a very good idea to generate documentation pattern with plugin-inspector. At present, it seems it doesn't.
Code: Select all
* |OVP_DocBegin_BoxAlgorithm_XXXX_Input1|
* |OVP_DocEnd_BoxAlgorithm_XXXX_Input1|
Hope this helps
Laurent