Merge branch 'bugfix/ldgen_surround_docs_correction' into 'master'

docs: fix error on ldgen generated symbol with SURROUND

See merge request espressif/esp-idf!12732
This commit is contained in:
Angus Gratton
2021-03-24 23:53:26 +00:00

View File

@@ -511,18 +511,18 @@ generates an output on the linker script:
.. code-block:: none
. = ALIGN(8)
__my_sym_start = ABSOLUTE(.)
_my_sym_start = ABSOLUTE(.)
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. Therefore, if for the same mapping fragment these two are switched, the following is generated instead:
.. code-block:: none
__my_sym_start = ABSOLUTE(.)
_my_sym_start = ABSOLUTE(.)
. = ALIGN(8)
KEEP(lib1.a:obj1.*( SORT(.rodata) SORT(.rodata.*) ))
__my_sym_end = ABSOLUTE(.)
_my_sym_end = ABSOLUTE(.)
.. _ldgen-symbol-granularity-placements :