ref-manual: Added new EXCLUDE_FROM_SHLIB variable

Fixes [YOCTO #8066]

Added a new description to the variable glossary.

(From yocto-docs rev: ccb23c5a318f1640718ed41dc7ea2fd1bb8a43a1)

Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
This commit is contained in:
Scott Rifenbark 2015-09-17 10:24:46 -07:00 committed by Richard Purdie
parent 316d432642
commit 05d8101990
1 changed files with 37 additions and 0 deletions

View File

@ -3533,6 +3533,43 @@
</glossdef>
</glossentry>
<glossentry id='var-EXCLUDE_FROM_SHLIB'><glossterm>EXCLUDE_FROM_SHLIB</glossterm>
<info>
EXCLUDE_FROM_SHLIB[doc] = "Prevents exposure of a package to all of the package's libraries."
</info>
<glossdef>
<para role="glossdeffirst">
<!-- <para role="glossdeffirst"><imagedata fileref="figures/define-generic.png" /> -->
Prevents exposing a package to all of the package's
libraries.
The <filename>EXCLUDE_FROM_SHLIB</filename> variable is
useful for prebuilt packages that should not be exposed
to any of the package's libraries.
In other words, you want to skip the
<filename>shlib</filename> procedure for the package.
</para>
<para>
Use the variable by setting it to "1" for a particular
package:
<literallayout class='monospaced'>
EXCLUDE_FROM_SHLIB = "1"
</literallayout>
</para>
<para>
You can achieve similar results by using the
<link linkend='var-PRIVATE_LIBS'><filename>PRIVATE_LIBS</filename></link>
variable.
However, with the <filename>PRIVATE_LIBS</filename>
variable, you must specifically list all of a package's
libraries.
Using the <filename>EXCLUDE_FROM_SHLIB</filename> variable,
allows you to quickly prevent exposure to all the libraries.
</para>
</glossdef>
</glossentry>
<glossentry id='var-EXCLUDE_FROM_WORLD'><glossterm>EXCLUDE_FROM_WORLD</glossterm>
<info>
EXCLUDE_FROM_WORLD[doc] = "Directs BitBake to exclude a recipe from world builds (i.e. bitbake world)."