[oe-commits] org.oe.documentation usermanual.xml: Describe ASSUME_SHLIBS.

[pfalcon commit]

usermanual.xml: Describe ASSUME_SHLIBS.

Author: pfalcon at openembedded.org
Branch: org.openembedded.documentation
Revision: ac66206920ea0b3666a229ed2258e8dc65effebb
ViewMTN: http://monotone.openembedded.org/revision/info/ac66206920ea0b3666a229ed2258e8dc65effebb
Files:
1
usermanual/usermanual.xml
Diffs:

#
# mt diff -rf86810bc2260236e1dce59191357642e5bad7c9f -rac66206920ea0b3666a229ed2258e8dc65effebb
#
# 
# 
# patch "usermanual/usermanual.xml"
#  from [e2032d6fa60dbd31b2eb1249b58de3e2685a8d17]
#    to [fcccf00efe21aa5e430f7a0ec22cc085e3882359]
# 
============================================================
--- usermanual/usermanual.xml	e2032d6fa60dbd31b2eb1249b58de3e2685a8d17
+++ usermanual/usermanual.xml	fcccf00efe21aa5e430f7a0ec22cc085e3882359
@@ -456,8 +456,16 @@ created package. The result can cause va
 <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 cause various issues. 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
+installed. This will lead to a fatal failure. As a quick workaround, 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):
+<screen>
+ASSUME_SHLIBS = "libqtopia2.so.2:qtopia2_2.4 libc.so.6:libc"
+</screen>
+The format is shlib_file_name:package[_version]. If a version is specified it will be
+used as the minimal (>=) version for the dependency.
+</para>
             </section>
 
         </section>