Fix RST rendering typos and broken links
Change-Id: I40631d9c1d99e24311d158cec5a47b433d6fe328
Signed-off-by: John Tsichritzis <john.tsichritzis@arm.com>
diff --git a/contributing.rst b/contributing.rst
index e2c7019..b2fc3d4 100644
--- a/contributing.rst
+++ b/contributing.rst
@@ -82,8 +82,8 @@
.. _maintainers: maintainers.rst
.. _license.rst: license.rst
.. _Developer Certificate of Origin (DCO): dco.txt
-.. _Checking source code style: ../docs/user-guide.rst#checking-source-code-style
-.. _Running the TF-A Tests: ../docs/user-guide.rst#running-the-tf-a-tests
+.. _Checking source code style: docs/user-guide.rst#checking-source-code-style
+.. _Running the TF-A Tests: docs/user-guide.rst#running-the-tf-a-tests
.. _Git guidelines: http://git-scm.com/book/ch5-2.html
.. _Linux coding style: https://www.kernel.org/doc/html/latest/process/coding-style.html
diff --git a/docs/design.rst b/docs/design.rst
index a59c1d7..e10b553 100644
--- a/docs/design.rst
+++ b/docs/design.rst
@@ -76,8 +76,10 @@
- **Library code.**
- Some examples of APIs provided in ``include/lib/`` follow, this list might
- not be exhaustive.
+ Firstly, there is ``include/stdlib/`` which provides standard C library
+ functions like ``memcpy()``, ``printf()`` and so on.
+ Additionally, various other APIs are provided under ``include/lib/``. The
+ below list gives some examples but might not be exhaustive.
- ``aarch64/``
@@ -129,9 +131,6 @@
directly. They should use higher-level APIs like ``tftf_nvm_read()``
and ``tftf_nvm_write()``.
- ``include/stdlib/`` provides standard C library functions (``memcpy()``,
- ``printf()``, and so on).
-
- **Platform specific.**
Note that ``include/plat/common/plat_topology.h`` provides the interfaces
@@ -262,5 +261,5 @@
*Copyright (c) 2018, Arm Limited. All rights reserved.*
-.. _Summary of build options: user-guide.html#summary-of-build-options
+.. _Summary of build options: user-guide.rst#summary-of-build-options
.. _Firmware Update: https://github.com/ARM-software/arm-trusted-firmware/blob/master/docs/firmware-update.rst
diff --git a/docs/user-guide.rst b/docs/user-guide.rst
index e989a56..efc9acb 100644
--- a/docs/user-guide.rst
+++ b/docs/user-guide.rst
@@ -218,22 +218,22 @@
To sum up, 3 images must be built out of the TF-A Tests repository in order to
test the TF-A Firmware Update feature:
- - ``ns_bl1u.bin``
- - ``ns_bl2u.bin``
- - ``tftf.bin``
+- ``ns_bl1u.bin``
+- ``ns_bl2u.bin``
+- ``tftf.bin``
Once that's done, they must be combined in the right way.
- - ``ns_bl1u.bin`` is a standalone image and does not require any further
- processing.
+- ``ns_bl1u.bin`` is a standalone image and does not require any further
+ processing.
- - ``ns_bl2u.bin`` must be injected into the ``FWU_FIP`` image. This might be
- achieved by setting ``NS_BL2U=ns_bl2u.bin`` when building the ``FWU_FIP``
- image out of the TF-A repository. Please refer to the section `Building FIP
- images with support for Trusted Board Boot`_ in the TF-A User Guide.
+- ``ns_bl2u.bin`` must be injected into the ``FWU_FIP`` image. This might be
+ achieved by setting ``NS_BL2U=ns_bl2u.bin`` when building the ``FWU_FIP``
+ image out of the TF-A repository. Please refer to the section `Building FIP
+ images with support for Trusted Board Boot`_ in the TF-A User Guide.
- - ``tftf.bin`` must be injected in the standard FIP image, as explained
- in section `TFTF test image`_.
+- ``tftf.bin`` must be injected in the standard FIP image, as explained
+ in section `TFTF test image`_.
Additionally, on Juno platform, the FWU FIP must contain a ``SCP_BL2U`` image.
This image can simply be a copy of the standard ``SCP_BL2`` image if no specific
@@ -327,14 +327,14 @@
- ``ENABLE_ASSERTIONS``: This option controls whether calls to ``assert()`` are
compiled out.
- - For debug builds, this option defaults to 1, and calls to ``assert()`` are
- compiled in.
- - For release builds, this option defaults to 0 and calls to ``assert()``
- are compiled out.
+ - For debug builds, this option defaults to 1, and calls to ``assert()`` are
+ compiled in.
+ - For release builds, this option defaults to 0 and calls to ``assert()``
+ are compiled out.
- This option can be set independently of ``DEBUG``. It can also be used to
- hide any auxiliary code that is only required for the assertion and does not
- fit in the assertion itself.
+ This option can be set independently of ``DEBUG``. It can also be used to
+ hide any auxiliary code that is only required for the assertion and does not
+ fit in the assertion itself.
- ``LOG_LEVEL``: Chooses the log level, which controls the amount of console log
output compiled into the build. This should be one of the following:
@@ -453,11 +453,12 @@
- ``BL1`` firmware image;
- ``FIP`` image containing the following images:
- - ``BL2``;
- - ``SCP_BL2`` if required by the platform (e.g. Juno);
- - ``BL31``;
- - ``BL32`` (optional);
- - ``tftf.bin`` (standing as the BL33 image).
+
+ - ``BL2``;
+ - ``SCP_BL2`` if required by the platform (e.g. Juno);
+ - ``BL31``;
+ - ``BL32`` (optional);
+ - ``tftf.bin`` (standing as the BL33 image).
Running the FWU tests
`````````````````````