diff options
Diffstat (limited to 'import-layers/yocto-poky/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml')
-rw-r--r-- | import-layers/yocto-poky/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml | 43 |
1 files changed, 20 insertions, 23 deletions
diff --git a/import-layers/yocto-poky/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml b/import-layers/yocto-poky/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml index 2a3340b39..d1ce43e23 100644 --- a/import-layers/yocto-poky/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml +++ b/import-layers/yocto-poky/bitbake/doc/bitbake-user-manual/bitbake-user-manual-fetching.xml @@ -38,7 +38,7 @@ The code to execute the first part of this process, a fetch, looks something like the following: <literallayout class='monospaced'> - src_uri = (d.getVar('SRC_URI', True) or "").split() + src_uri = (d.getVar('SRC_URI') or "").split() fetcher = bb.fetch2.Fetch(src_uri, d) fetcher.download() </literallayout> @@ -52,7 +52,7 @@ <para> The instantiation of the fetch class is usually followed by: <literallayout class='monospaced'> - rootdir = l.getVar('WORKDIR', True) + rootdir = l.getVar('WORKDIR') fetcher.unpack(rootdir) </literallayout> This code unpacks the downloaded files to the @@ -268,15 +268,6 @@ <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link> variable is used in the same way <filename>PATH</filename> is used to find executables. - Failing that, - <link linkend='var-FILESDIR'><filename>FILESDIR</filename></link> - is used to find the appropriate relative file. - <note> - <filename>FILESDIR</filename> is deprecated and can - be replaced with <filename>FILESPATH</filename>. - Because <filename>FILESDIR</filename> is likely to be - removed, you should not use this variable in any new code. - </note> If the file cannot be found, it is assumed that it is available in <link linkend='var-DL_DIR'><filename>DL_DIR</filename></link> by the time the <filename>download()</filename> method is called. @@ -385,7 +376,8 @@ The supported parameters are as follows: <itemizedlist> <listitem><para><emphasis>"method":</emphasis> - The protocol over which to communicate with the CVS server. + The protocol over which to communicate with the CVS + server. By default, this protocol is "pserver". If "method" is set to "ext", BitBake examines the "rsh" parameter and sets <filename>CVS_RSH</filename>. @@ -469,25 +461,29 @@ You can think of this parameter as the top-level directory of the repository data you want. </para></listitem> + <listitem><para><emphasis>"path_spec":</emphasis> + A specific directory in which to checkout the + specified svn module. + </para></listitem> <listitem><para><emphasis>"protocol":</emphasis> The protocol to use, which defaults to "svn". - Other options are "svn+ssh" and "rsh". - For "rsh", the "rsh" parameter is also used. + If "protocol" is set to "svn+ssh", the "ssh" + parameter is also used. </para></listitem> <listitem><para><emphasis>"rev":</emphasis> The revision of the source code to checkout. </para></listitem> - <listitem><para><emphasis>"date":</emphasis> - The date of the source code to checkout. - Specific revisions are generally much safer to checkout - rather than by date as they do not involve timezones - (e.g. they are much more deterministic). - </para></listitem> <listitem><para><emphasis>"scmdata":</emphasis> Causes the “.svn” directories to be available during compile-time when set to "keep". By default, these directories are removed. </para></listitem> + <listitem><para><emphasis>"ssh":</emphasis> + An optional parameter used when "protocol" is set + to "svn+ssh". + You can use this parameter to specify the ssh + program used by svn. + </para></listitem> <listitem><para><emphasis>"transportuser":</emphasis> When required, sets the username for the transport. By default, this parameter is empty. @@ -496,10 +492,11 @@ command. </para></listitem> </itemizedlist> - Following are two examples using svn: + Following are three examples using svn: <literallayout class='monospaced'> - SRC_URI = "svn://svn.oe.handhelds.org/svn;module=vip;proto=http;rev=667" - SRC_URI = "svn://svn.oe.handhelds.org/svn/;module=opie;proto=svn+ssh;date=20060126" + SRC_URI = "svn://myrepos/proj1;module=vip;protocol=http;rev=667" + SRC_URI = "svn://myrepos/proj1;module=opie;protocol=svn+ssh" + SRC_URI = "svn://myrepos/proj1;module=trunk;protocol=http;path_spec=${MY_DIR}/proj1" </literallayout> </para> </section> |