Skip to content

Generating documentation

Killswitch edited this page Jun 16, 2015 · 1 revision

CBA's documentation is automatically generated from the [source code comments](Documenting SQF functions). Function documentation will be visible in-game within the functions browser (call BIS_fnc_help to see it). Both macro and function documentation will be generated as browsable HTML.

Installation required

  • Install Ruby (Recommendation: Use the windows installer.
  • Install ActivePerl (Other implementations of Perl should be fine, but CBA has only been tested with ActivePerl).
  • Install NaturalDocs.
  • Ensure that you have a correct path to your version of CBA before running anything (i.e. cba directory must be in an x directory).

Generating the documentation

  • Run x\cba\utils\make_functions_config.bat
  • Run x\cba\utils\make_docs.bat

Documentation will be generated at *docs\cba_functions_library*, which will also be packaged as docs\cba_functions_library.7z.