[oe-commits] Holger Hans Peter Freyther : usermanual: Only advertize using shlibs for external toolchains

[git version control]

Module: openembedded.git
Branch: org.openembedded.dev
Commit: 3b920ca03db2392b542c1fc80505228ae43b14fb
URL:    http://gitweb.openembedded.net/?p=openembedded.git&a=commit;h=3b920ca03db2392b542c1fc80505228ae43b14fb

Author: Holger Hans Peter Freyther <zecke at selfish.org>
Date:   Tue Aug 11 05:29:06 2009 +0200

usermanual: Only advertize using shlibs for external toolchains

Using shlibs and ASSUME_SHLIBS should be everything we need to
get proper dependencies into packages. This section should get
more work and the external-poky-toolchain approach should be
copied to simplify this task.

---

 docs/usermanual/chapters/common_use_cases.xml |   24 ++++++++++--------------
 1 files changed, 10 insertions(+), 14 deletions(-)

diff --git a/docs/usermanual/chapters/common_use_cases.xml b/docs/usermanual/chapters/common_use_cases.xml
index 8000f5f..241eb53 100644
--- a/docs/usermanual/chapters/common_use_cases.xml
+++ b/docs/usermanual/chapters/common_use_cases.xml
@@ -379,20 +379,16 @@ NOTE: Couldn't find shared library provider for libm.so.6
 </screen>
 
       <para>OpenEmbedded tries to automatically add run-time dependencies
-      (RDEPENDS) to the package. It uses the <emphasis><link
-      linkend="shlibs">shlibs</link></emphasis> system to do add them, in this
-      case it was not able to find packages providing these libraries as they
-      are prebuilt. This means they will not be added to the RDEPENDS of the
-      just created package. The result can be fatal. If you use OpenEmbedded
-      to create images you will end up with a image without a libc being
-      installed. This will lead to a fatal failure. To workaround this issue
-      you could create a package for the metadata to install every needed
-      library and use ${BOOTSTRAP_EXTRA_RDEPENDS} to make sure this package is
-      installed when creating images.</para>
-      
-      <para>However, the correct way to resolve this is to provide explicit 
-      mapping using ASSUME_SHLIBS variable. For example, for the libraries 
-      above (partial):
+      (RDEPENDS) to generated packages. It is inspecting binaries and
+      libraries and uses the <emphasis><link linkend="shlibs">shlibs</link>
+      </emphasis> system to do add dependencies for the linked libaries,
+      however in this case it was not able to find packages providing these
+      libraries as they were prebuilt.
+      </para>
+
+      <para>One way to resolve this problem is to provide an explicit mapping
+      using the ASSUME_SHLIBS variable in a config file <filename>local.conf</filename>.
+      For example, for the libraries above (partial):
       <screen>
 ASSUME_SHLIBS = "libqtopia2.so.2:qtopia2_2.4 libc.so.6:libc"
 </screen>