Docs: Decouple from CMAKE and enable sphynx-build.
This patch is reducing the dependency of the documentation to
the TrustedFirmware-M build environment. Currently CMake will
copy over files from platforms, render the configuration files,
sort design documents and invoke the corresponding tools to
build the documentation.
This patch introduces an environment communicating interface file,
which CMAKE will need to populate, before calling the build command.
The file copy operation has been moved over to the sphynx-build logic,
and the design document’s classification is no longer required by the
new user interface.
The new implemenatation allows:
* Documentation can be built in an identical way through the build system,
retaining compatibility with existing tools, such as the CI.
* It is now possible to build documentation, by just invoking sphynx-build
from the build-docs directory.
* Third party tools/services like readthedocs.org can now render
the TF-M documentation.
* Reduced CMake code size.
* Documentation generating logic invokes ‘git describe’ in order to determine
a version. The order of precedence is set as:
Git Describe Version-> CMake hardcoded version -> Template version.
* CMake logic can still toggle parts of the new logic on and off if required.
* The full set of TF-M build dependencies are not longer required in order
to build documentation. Just the documentation dependencies would suffice.
Change-Id: I12e7bbffe9d1adb756329c46da13905e95096381
Signed-off-by: Minos Galanakis <minos.galanakis@arm.com>
diff --git a/doxygen/Doxyfile.in b/doxygen/Doxyfile.in
index 9a1e475..ccfa60c 100644
--- a/doxygen/Doxyfile.in
+++ b/doxygen/Doxyfile.in
@@ -1,5 +1,5 @@
#-------------------------------------------------------------------------------
-# Copyright (c) 2018-2019, Arm Limited. All rights reserved.
+# Copyright (c) 2018-2020, Arm Limited. All rights reserved.
#
# SPDX-License-Identifier: BSD-3-Clause
#
@@ -58,7 +58,7 @@
# pixels and the maximum width should not exceed 200 pixels. Doxygen will copy
# the logo to the output directory.
-PROJECT_LOGO = ./doxygen/TrustedFirmware-Logo_icon.png
+PROJECT_LOGO = @TFM_ROOT_DIR@/doxygen/TrustedFirmware-Logo_icon.png
# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) path
# into which the generated documentation will be written. If a relative path is