docs: fix error on ldgen generated symbol with SURROUND

This commit is contained in:
Renz Bagaporo
2021-03-13 19:37:04 +08:00
parent c49d03b8eb
commit 0cbf662ca3

View File

@@ -568,9 +568,9 @@ generates an output on the linker script:
.. code-block:: none .. code-block:: none
. = ALIGN(8) . = ALIGN(8)
__my_sym_start = ABSOLUTE(.) _my_sym_start = ABSOLUTE(.)
KEEP(lib1.a:obj1.*( SORT(.rodata) SORT(.rodata.*) )) KEEP(lib1.a:obj1.*( SORT(.rodata) SORT(.rodata.*) ))
__my_sym_end = ABSOLUTE(.) _my_sym_end = ABSOLUTE(.)
Note that ALIGN and SURROUND, as mentioned in the flag descriptions, are order sensitive. Note that ALIGN and SURROUND, as mentioned in the flag descriptions, are order sensitive.
Therefore, if for the same mapping fragment these two are switched, the following Therefore, if for the same mapping fragment these two are switched, the following
@@ -578,10 +578,10 @@ is generated instead:
.. code-block:: none .. code-block:: none
__my_sym_start = ABSOLUTE(.) _my_sym_start = ABSOLUTE(.)
. = ALIGN(8) . = ALIGN(8)
KEEP(lib1.a:obj1.*( SORT(.rodata) SORT(.rodata.*) )) KEEP(lib1.a:obj1.*( SORT(.rodata) SORT(.rodata.*) ))
__my_sym_end = ABSOLUTE(.) _my_sym_end = ABSOLUTE(.)
.. _ldgen-symbol-granularity-placements : .. _ldgen-symbol-granularity-placements :