[PATCH][RESEND] dev-manual: Explain unpacking archives without a top-level directory

[PATCH][RESEND] dev-manual: Explain unpacking archives without a top-level directory

[Tanu Kaskinen]

Signed-off-by: Tanu Kaskinen <tanuk@iki.fi>
---

I originally sent this to yocto@lists.yoctoproject.org on 2020-01-14.

 documentation/dev-manual/dev-manual-common-tasks.xml | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 1e6addde4..525ec1830 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -2085,7 +2085,15 @@
                 However, if <filename>SRC_URI</filename> specifies to fetch
                 source from an archive that does not use this convention,
                 or from an SCM like Git or Subversion, your recipe needs to
-                define <filename>S</filename>.
+                define <filename>S</filename>, except if the archive doesn't
+                use any top-level subdirectory. In that case you need to tell
+                Bitbake to do the unpacking in a subdirectory, this example is
+                from the
+                <filename>meta/recipes-multimedia/alsa/alsa-ucm-conf_1.2.1.2.bb</filename>
+                recipe:
+                <literallayout class='monospaced'>
+     SRC_URI = "https://www.alsa-project.org/files/pub/lib/${BP}.tar.bz2;subdir=${BP}"
+                </literallayout>
             </para>
 
             <para>
-- 
2.20.1