summaryrefslogtreecommitdiffstats
path: root/bitbake
diff options
context:
space:
mode:
Diffstat (limited to 'bitbake')
-rw-r--r--bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml19
1 files changed, 19 insertions, 0 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
index b37b2ae42c..f168cfa686 100644
--- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
+++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml
@@ -325,6 +325,25 @@
325 SRC_URI = "ftp://you@oe.handhelds.org/home/you/secret.plan" 325 SRC_URI = "ftp://you@oe.handhelds.org/home/you/secret.plan"
326 </literallayout> 326 </literallayout>
327 </para> 327 </para>
328 <note>
329 Because URL parameters are delimited by semi-colons, this can
330 introduce ambiguity when parsing URLs that also contain semi-colons,
331 for example:
332 <literallayout class='monospaced'>
333 SRC_URI = "http://abc123.org/git/?p=gcc/gcc.git;a=snapshot;h=a5dd47"
334 </literallayout>
335 Such URLs should should be modified by replacing semi-colons with '&amp;' characters:
336 <literallayout class='monospaced'>
337 SRC_URI = "http://abc123.org/git/?p=gcc/gcc.git&amp;a=snapshot&amp;h=a5dd47"
338 </literallayout>
339 In most cases this should work. Treating semi-colons and '&amp;' in queries
340 identically is recommended by the World Wide Web Consortium (W3C).
341 Note that due to the nature of the URL, you may have to specify the name
342 of the downloaded file as well:
343 <literallayout class='monospaced'>
344 SRC_URI = "http://abc123.org/git/?p=gcc/gcc.git&amp;a=snapshot&amp;h=a5dd47;downloadfilename=myfile.bz2"
345 </literallayout>
346 </note>
328 </section> 347 </section>
329 348
330 <section id='cvs-fetcher'> 349 <section id='cvs-fetcher'>