Documentation generation

Two documents are available for generation:

• Reference Manual (HTML, PDF)

• User Guide (HTML, PDF)

The documentation build is independent from building the binary artifacts.

Tools and building environment

These tools are used to generate TF-M documentation:

• Doxygen v1.8.0 or later

• Graphviz dot v2.38.0 or later

• PlantUML v1.2018.11 or later

• Java runtime environment v1.8 or later (for running PlantUML)

• Sphinx and other python modules, listed in docs/requirements.txt

Additionally, for PDFs format:

• LaTeX

• PdfLaTeX

There are two ways of building TF-M reference manual:

1. As a custom target of TF-M CMake build system

2. Directly, using the command line tools

To prepare your building environment execute the following steps:

LinuxWindows

Install the required tools:

sudo apt-get install -y doxygen graphviz default-jre
mkdir ~/plantuml
curl -L http://sourceforge.net/projects/plantuml/files/plantuml.jar/download --output ~/plantuml/plantuml.jar

# For PDF generation
sudo apt-get install -y doxygen-latex librsvg2-bin

# Install the required Python modules
pip3 install --upgrade pip
cd <TF-M base folder>
pip3 install -r docs/requirements.txt

Set the environment variables:

export PLANTUML_JAR_PATH=~/plantuml/plantuml.jar

Build TF-M Reference Manual

The Reference Manual will be generated in the build_docs/reference_manual.

LinuxWindows

cd <TF-M base folder>
cmake -S docs -B build_docs
cmake --build build_docs -- tfm_docs_refman_html tfm_docs_refman_pdf

Build TF-M User Guide

The User Manual will be available under the directory build_docs/user_guide.

LinuxWindows

cd <TF-M base folder>
cmake -S docs -B build_docs
cmake --build build_docs -- tfm_docs_userguide_html tfm_docs_userguide_pdf

Direct build using a command line tools

The direct build will build both user_guide and reference_manual.

LinuxWindows

# Build the documentation from build_docs directory
cd <TF-M base folder>
mkdir build_docs
cp docs/conf.py build_docs/conf.py
cd build_docs
sphinx-build ./ user_guide

Dependencies

---

Copyright (c) 2017-2024, Arm Limited. All rights reserved.