source_docs_howto

Generating the Doxygen Source Documentation

Within the Fldigi git repository is a script that generates a ​Doxygen interactive HTML website by analyzing the source code of Fldigi.

The script does not exist in the regularly used tar.gz file, so the full source must be downloaded. eg;

git clone git://git.code.sf.net/p/fldigi/fldigi fldigi.git

(This is the same command on the user documentation howto at https://sourceforge.net/p/fldigi/wiki/user_docs_howto)

Additionally, the tool ​cppcheck is run to check-for and report code issues. The cppcheck results are included on the Doxygen main-page. Currently these instructions only cover setup on Linux and OSX.

Please note: this code-analysis and documentation-generation time takes longer than compiling Fldigi and will require 2.0GB of free disk-space.

Installing Dependencies

To successfully execute the fldigi/scripts/doxygen/gen_doxygen_docs.sh script a few programs must first be installed on the local system:

doxygen
dot
mscgen
cppcheck

To check if these are installed run:
''$ which doxygen; which dot; which mscgen; which cppcheck''
This will return a list of where the binaries are installed:

/opt/local/bin/doxygen
/opt/local/bin/dot
/opt/local/bin/mscgen
/opt/local/bin/cppcheck

If all 4 required programs are in the returned list, skip to Running the Script.

Otherwise continue with Setup

Setup

Execute the command below in a terminal window to install the needed support programs on Debian, Ubuntu, and Debian derivatives.

sudo apt-get -y install doxygen graphviz mscgen cppcheck

For Apple OSX systems, easiest way to install the required support programs on OSX is by using ​MacPorts. Execute the command below in a terminal window to install the needed support programs OSX (after installing Macports)

sudo port install doxygen graphviz mscgen cppcheck gitstats

Running the Script

Once the support programs are installed run the script fldigi/scripts/doxygen/gen_doxygen_docs.sh This will generate the Doxygen docs in fldigi/scripts/doxygen/HTML

$ cd fldigi/scripts/srcdoc
$ ./gen_doxygen_docs.sh run

After Doxygen generation and cppcheck analysis is complete, the script will attempt to open the main HTML page in the systems default web-browser. If for some reason this does not work, manually open the main-page file at fldigi/scripts/doxygen/HTML/index.html

Cleaning Up

To delete all files generated by the gen_doxygen_docs.sh script execute the "clean action"

./gen_doxygen_docs.sh clean