diff options
| -rw-r--r-- | bitbake/doc/user-manual/user-manual-fetching.xml | 76 |
1 files changed, 37 insertions, 39 deletions
diff --git a/bitbake/doc/user-manual/user-manual-fetching.xml b/bitbake/doc/user-manual/user-manual-fetching.xml index 23ff3482dc..18c0214c02 100644 --- a/bitbake/doc/user-manual/user-manual-fetching.xml +++ b/bitbake/doc/user-manual/user-manual-fetching.xml | |||
| @@ -41,23 +41,22 @@ | |||
| 41 | a git repository on an http server as a tarball for example. | 41 | a git repository on an http server as a tarball for example. |
| 42 | Some example commonly used mirror | 42 | Some example commonly used mirror |
| 43 | definitions are: | 43 | definitions are: |
| 44 | </para> | 44 | <literallayout class='monospaced'> |
| 45 | PREMIRRORS ?= "\ | ||
| 46 | bzr://.*/.* http://somemirror.org/sources/ \n \ | ||
| 47 | cvs://.*/.* http://somemirror.org/sources/ \n \ | ||
| 48 | git://.*/.* http://somemirror.org/sources/ \n \ | ||
| 49 | hg://.*/.* http://somemirror.org/sources/ \n \ | ||
| 50 | osc://.*/.* http://somemirror.org/sources/ \n \ | ||
| 51 | p4://.*/.* http://somemirror.org/sources/ \n \ | ||
| 52 | svk://.*/.* http://somemirror.org/sources/ \n \ | ||
| 53 | svn://.*/.* http://somemirror.org/sources/ \n" | ||
| 45 | 54 | ||
| 46 | <para> | 55 | MIRRORS =+ "\ |
| 47 | <screen><varname>PREMIRRORS</varname> ?= "\ | 56 | ftp://.*/.* http://somemirror.org/sources/ \n \ |
| 48 | bzr://.*/.* http://somemirror.org/sources/ \n \ | 57 | http://.*/.* http://somemirror.org/sources/ \n \ |
| 49 | cvs://.*/.* http://somemirror.org/sources/ \n \ | 58 | https://.*/.* http://somemirror.org/sources/ \n" |
| 50 | git://.*/.* http://somemirror.org/sources/ \n \ | 59 | </literallayout> |
| 51 | hg://.*/.* http://somemirror.org/sources/ \n \ | ||
| 52 | osc://.*/.* http://somemirror.org/sources/ \n \ | ||
| 53 | p4://.*/.* http://somemirror.org/sources/ \n \ | ||
| 54 | svk://.*/.* http://somemirror.org/sources/ \n \ | ||
| 55 | svn://.*/.* http://somemirror.org/sources/ \n" | ||
| 56 | |||
| 57 | <varname>MIRRORS</varname> =+ "\ | ||
| 58 | ftp://.*/.* http://somemirror.org/sources/ \n \ | ||
| 59 | http://.*/.* http://somemirror.org/sources/ \n \ | ||
| 60 | https://.*/.* http://somemirror.org/sources/ \n"</screen> | ||
| 61 | </para> | 60 | </para> |
| 62 | 61 | ||
| 63 | <para> | 62 | <para> |
| @@ -96,10 +95,11 @@ https://.*/.* http://somemirror.org/sources/ \n"</screen> | |||
| 96 | The metadata usually extend these variables to include | 95 | The metadata usually extend these variables to include |
| 97 | variations of the values in <varname>OVERRIDES</varname>. | 96 | variations of the values in <varname>OVERRIDES</varname>. |
| 98 | Single files and complete directories can be specified. | 97 | Single files and complete directories can be specified. |
| 99 | <screen><varname>SRC_URI</varname>= "file://relativefile.patch" | 98 | <literallayout class='monospaced'> |
| 100 | <varname>SRC_URI</varname>= "file://relativefile.patch;this=ignored" | 99 | SRC_URI = "file://relativefile.patch" |
| 101 | <varname>SRC_URI</varname>= "file:///Users/ich/very_important_software" | 100 | SRC_URI = "file://relativefile.patch;this=ignored" |
| 102 | </screen> | 101 | SRC_URI = "file:///Users/ich/very_important_software" |
| 102 | </literallayout> | ||
| 103 | </para> | 103 | </para> |
| 104 | </section> | 104 | </section> |
| 105 | 105 | ||
| @@ -138,9 +138,10 @@ https://.*/.* http://somemirror.org/sources/ \n"</screen> | |||
| 138 | and <varname>CVS_RSH</varname> will be set. | 138 | and <varname>CVS_RSH</varname> will be set. |
| 139 | Finally, <varname>localdir</varname> is used to checkout into a special | 139 | Finally, <varname>localdir</varname> is used to checkout into a special |
| 140 | directory relative to <varname>CVSDIR</varname>. | 140 | directory relative to <varname>CVSDIR</varname>. |
| 141 | <screen><varname>SRC_URI</varname> = "cvs://CVSROOT;module=mymodule;tag=some-version;method=ext" | 141 | <literallayout class='monospaced'> |
| 142 | <varname>SRC_URI</varname> = "cvs://CVSROOT;module=mymodule;date=20060126;localdir=usethat" | 142 | SRC_URI = "cvs://CVSROOT;module=mymodule;tag=some-version;method=ext" |
| 143 | </screen> | 143 | SRC_URI = "cvs://CVSROOT;module=mymodule;date=20060126;localdir=usethat" |
| 144 | </literallayout> | ||
| 144 | </para> | 145 | </para> |
| 145 | </section> | 146 | </section> |
| 146 | 147 | ||
| @@ -155,12 +156,11 @@ https://.*/.* http://somemirror.org/sources/ \n"</screen> | |||
| 155 | for fetching. | 156 | for fetching. |
| 156 | <quote>${URI}</quote> and <quote>${FILES}</quote> will be replaced by the URI and | 157 | <quote>${URI}</quote> and <quote>${FILES}</quote> will be replaced by the URI and |
| 157 | basename of the file to be fetched. | 158 | basename of the file to be fetched. |
| 158 | </para> | 159 | <literallayout class='monospaced'> |
| 159 | <para> | 160 | SRC_URI = "http://oe.handhelds.org/not_there.aac" |
| 160 | <screen><varname>SRC_URI</varname> = "http://oe.handhelds.org/not_there.aac" | 161 | SRC_URI = "ftp://oe.handhelds.org/not_there_as_well.aac" |
| 161 | <varname>SRC_URI</varname> = "ftp://oe.handhelds.org/not_there_as_well.aac" | 162 | SRC_URI = "ftp://you@oe.handheld.sorg/home/you/secret.plan" |
| 162 | <varname>SRC_URI</varname> = "ftp://you@oe.handheld.sorg/home/you/secret.plan" | 163 | </literallayout> |
| 163 | </screen> | ||
| 164 | </para> | 164 | </para> |
| 165 | </section> | 165 | </section> |
| 166 | 166 | ||
| @@ -187,11 +187,10 @@ https://.*/.* http://somemirror.org/sources/ \n"</screen> | |||
| 187 | Subversion revision. | 187 | Subversion revision. |
| 188 | If <varname>scmdata</varname> is set to <quote>keep</quote>, the <quote>.svn</quote> directories will | 188 | If <varname>scmdata</varname> is set to <quote>keep</quote>, the <quote>.svn</quote> directories will |
| 189 | be available during compile-time. | 189 | be available during compile-time. |
| 190 | </para> | 190 | <literallayout class='monospaced'> |
| 191 | <para> | 191 | SRC_URI = "svn://svn.oe.handhelds.org/svn;module=vip;proto=http;rev=667" |
| 192 | <screen><varname>SRC_URI</varname> = "svn://svn.oe.handhelds.org/svn;module=vip;proto=http;rev=667" | 192 | SRC_URI = "svn://svn.oe.handhelds.org/svn/;module=opie;proto=svn+ssh;date=20060126" |
| 193 | <varname>SRC_URI</varname> = "svn://svn.oe.handhelds.org/svn/;module=opie;proto=svn+ssh;date=20060126" | 193 | </literallayout> |
| 194 | </screen> | ||
| 195 | </para> | 194 | </para> |
| 196 | </section> | 195 | </section> |
| 197 | 196 | ||
| @@ -213,11 +212,10 @@ https://.*/.* http://somemirror.org/sources/ \n"</screen> | |||
| 213 | if a hostname is set, otherwise its <quote>file</quote>. | 212 | if a hostname is set, otherwise its <quote>file</quote>. |
| 214 | If <emphasis>scmdata</emphasis> is set to <quote>keep</quote>, the <quote>.git</quote> directory will be available | 213 | If <emphasis>scmdata</emphasis> is set to <quote>keep</quote>, the <quote>.git</quote> directory will be available |
| 215 | during compile-time. | 214 | during compile-time. |
| 216 | </para> | 215 | <literallayout class='monospaced'> |
| 217 | <para> | 216 | SRC_URI = "git://git.oe.handhelds.org/git/vip.git;tag=version-1" |
| 218 | <screen><varname>SRC_URI</varname> = "git://git.oe.handhelds.org/git/vip.git;tag=version-1" | 217 | SRC_URI = "git://git.oe.handhelds.org/git/vip.git;protocol=http" |
| 219 | <varname>SRC_URI</varname> = "git://git.oe.handhelds.org/git/vip.git;protocol=http" | 218 | </literallayout> |
| 220 | </screen> | ||
| 221 | </para> | 219 | </para> |
| 222 | </section> | 220 | </section> |
| 223 | </chapter> | 221 | </chapter> |
