diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2015-09-30 12:55:13 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2015-10-21 23:06:33 +0100 |
commit | 2e7d650a2ab3ced7688fb550f55798dd55381367 (patch) | |
tree | 580a30f7a07c647d0c80a559a084bc5ea5a7b895 /documentation/ref-manual/ref-classes.xml | |
parent | 7facee681a07f3a9e39e958dc156ecae52d4880d (diff) | |
download | poky-2e7d650a2ab3ced7688fb550f55798dd55381367.tar.gz |
ref-manual: Updates to clarify Fetcher URL directory parameters
Updated the SRC_URI variable description to cross-reference
the "Fetchers" section in the BitBake User Manual and added
some more Fetcher URL parameters specific to certain fetchers.
This was done to help clarify how to put fetched code into
specific directories.
Also updated the bin_packages.bbclass description to have a
better example. Used a git:// fetcher example and provided
some specific URL parameters.
(From yocto-docs rev: 7133b49092096c253ffce99f39d4fa6db7810061)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/ref-classes.xml')
-rw-r--r-- | documentation/ref-manual/ref-classes.xml | 12 |
1 files changed, 10 insertions, 2 deletions
diff --git a/documentation/ref-manual/ref-classes.xml b/documentation/ref-manual/ref-classes.xml index ba7c3f79f6..30d0e5de06 100644 --- a/documentation/ref-manual/ref-classes.xml +++ b/documentation/ref-manual/ref-classes.xml | |||
@@ -211,14 +211,22 @@ | |||
211 | use for this class. | 211 | use for this class. |
212 | <note> | 212 | <note> |
213 | For RPMs and other packages that do not contain a subdirectory, | 213 | For RPMs and other packages that do not contain a subdirectory, |
214 | you should specify a "subdir" parameter. | 214 | you should specify an appropriate fetcher parameter to point to |
215 | the subdirectory. | ||
216 | For example, if BitBake is using the Git fetcher | ||
217 | (<filename>git://</filename>), the "subpath" parameter limits | ||
218 | the checkout to a specific subpath of the tree. | ||
215 | Here is an example where <filename>${BP}</filename> is used so that | 219 | Here is an example where <filename>${BP}</filename> is used so that |
216 | the files are extracted into the subdirectory expected by the | 220 | the files are extracted into the subdirectory expected by the |
217 | default value of | 221 | default value of |
218 | <link linkend='var-S'><filename>S</filename></link>: | 222 | <link linkend='var-S'><filename>S</filename></link>: |
219 | <literallayout class='monospaced'> | 223 | <literallayout class='monospaced'> |
220 | SRC_URI = "http://example.com/downloads/somepackage.rpm;subdir=${BP}" | 224 | SRC_URI = "git://example.com/downloads/somepackage.rpm;subpath=${BP}" |
221 | </literallayout> | 225 | </literallayout> |
226 | See the | ||
227 | "<ulink url='&YOCTO_DOCS_BB_URL;#bb-fetchers'>Fetchers</ulink>" | ||
228 | section in the BitBake User Manual for more information on | ||
229 | supported BitBake Fetchers. | ||
222 | </note> | 230 | </note> |
223 | </para> | 231 | </para> |
224 | </section> | 232 | </section> |