Regenerating documentation

From Horde3D Wiki
Jump to: navigation, search

Horde3D uses NaturalDocs as documentation generator. This instruction is written for the version 1 of NaturalDocs. Version 2 is not tested and may or may not work with the instruction below.

In order to regenerate documentation you'll have to:

  1. Install NaturalDocs.
  2. Copy horde's css file (api.css) from <Horde's SDK folder>/Horde3D/Docs/html/css to <NaturalDocs folder>/Styles. On Windows it is likely in C:\Program Files (x86)\NaturalDocs. On Linux it is likely in /usr/share/perl5/naturaldocs.
  3. Use the following command to generate docs:

naturaldocs -i <full path to Horde SDK folder>\Horde3D\Bindings\C++ -o FramedHTML <OutputPath> -p <ProjectPath> -s api.

OutputPath and ProjectPath should also be full paths, like C:/GeneratedDocs.

NaturalDocs cannot change the name of the css file that is included with generated documentation, so it is always named main.css and resides in <ProjectPath>/styles. Therefore, the reference to the css file should be changed in the generated docs from ../styles/main.css to css/api.css. After that generated doc file should be renamed to _api.html and copied to <Horde's SDK folder>/Horde3D/Docs/html.

Automated script for Windows is available. Powershell 2.0 is required. In order to run the script open (first time only) powershell with administrator rights and type Set-ExecutionPolicy RemoteSigned or Set-ExecutionPolicy Unrestricted. Open the script with your favorite text editor and change the paths at the top. Run the script.

Automated script for Linux is also available. Do not forget to make script executable with chmod +x

Check this forum thread to download scripts: link