diff options
| author | Sandrine Bailleux <sandrine.bailleux@arm.com> | 2020-01-31 07:35:30 +0000 |
|---|---|---|
| committer | TrustedFirmware Code Review <review@review.trustedfirmware.org> | 2020-01-31 07:35:30 +0000 |
| commit | 989429e8726e55bac78292ead4400649350c4565 (patch) | |
| tree | 3ce4181dbb0289ee85ed810a6b4ee58ce6cffb50 /docs | |
| parent | f69a5828b74ca27bd3872de9c8c6c5a107915c49 (diff) | |
| parent | 6de32378f67f9a1368000a94defa8956c3c7319d (diff) | |
| download | platform_external_arm-trusted-firmware-989429e8726e55bac78292ead4400649350c4565.tar.gz platform_external_arm-trusted-firmware-989429e8726e55bac78292ead4400649350c4565.tar.bz2 platform_external_arm-trusted-firmware-989429e8726e55bac78292ead4400649350c4565.zip | |
Merge "Add support for documentation build as a target in Makefile" into integration
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/change-log-upcoming.rst | 2 | ||||
| -rw-r--r-- | docs/getting_started/docs-build.rst | 21 |
2 files changed, 15 insertions, 8 deletions
diff --git a/docs/change-log-upcoming.rst b/docs/change-log-upcoming.rst index 3d7d5094d..14280cbf7 100644 --- a/docs/change-log-upcoming.rst +++ b/docs/change-log-upcoming.rst @@ -23,7 +23,7 @@ New Features - Example: "Add support for Branch Target Identification (BTI)" - Build System - - Example: "Add support for default stack-protector flag" + - Add support for documentation build as a target in Makefile - CPU Support - Example: "cortex-a55: Workaround for erratum 1221012" diff --git a/docs/getting_started/docs-build.rst b/docs/getting_started/docs-build.rst index c5625e98d..91b1b3a39 100644 --- a/docs/getting_started/docs-build.rst +++ b/docs/getting_started/docs-build.rst @@ -56,21 +56,28 @@ as root or using ``sudo``. Building rendered documentation ------------------------------- -From the ``docs`` directory of the project, run the following commands. It is -important to note that you will not get the correct result if the commands are -run from the project root directory, as that would invoke the top-level Makefile -for |TF-A| itself. +Documents can be built into HTML-formatted pages from project root directory by +running the following command. .. code:: shell - make clean - make html + make doc Output from the build process will be placed in: :: - <tf-a root>/docs/build/html/ + docs/build/html/ + +We also support building documentation in other formats. From the ``docs`` +directory of the project, run the following command to see the supported +formats. It is important to note that you will not get the correct result if +the command is run from the project root directory, as that would invoke the +top-level Makefile for |TF-A| itself. + +.. code:: shell + + make help -------------- |