tree b7d1f354d0a33d533b74f7bcdc3b9865b360504e
parent 7b95029a5864ce834e9535ce96da92be3f418a54
author Minos Galanakis <minos.galanakis@arm.com> 1591195083 +0100
committer Tamas Ban <tamas.ban@arm.com> 1600951794 +0000

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>