ref-manual: add DISABLE_STATIC

This was added all the way back in krogoth.

(From yocto-docs rev: 932870c5746718fb6ac3073bb4c79f4e085b089f)

Signed-off-by: Paul Eggleton <paul.eggleton@microsoft.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Paul Eggleton
2022-10-10 14:05:29 +13:00
committed by Richard Purdie
parent 83495559d9
commit 500d5bc5c9

View File

@@ -1812,6 +1812,18 @@ system and gives an overview of their function and contents.
:term:`DESCRIPTION` takes the value of the :term:`SUMMARY`
variable.
:term:`DISABLE_STATIC`
Used in order to disable static linking by default (in order to save
space, since static libraries are often unused in embedded systems.)
The default value is " --disable-static", however it can be set to ""
in order to enable static linking if desired. Certain recipes do this
individually, and also there is a
``meta/conf/distro/include/no-static-libs.inc`` include file that
disables static linking for a number of recipes. Some software
packages or build tools (such as CMake) have explicit support for
enabling / disabling static linking, and in those cases
:term:`DISABLE_STATIC` is not used.
:term:`DISTRO`
The short name of the distribution. For information on the long name
of the distribution, see the :term:`DISTRO_NAME`