summaryrefslogtreecommitdiffstats
path: root/documentation
diff options
context:
space:
mode:
authorScott Rifenbark <scott.m.rifenbark@intel.com>2013-03-28 12:13:02 -0700
committerRichard Purdie <richard.purdie@linuxfoundation.org>2013-04-04 14:13:41 +0100
commit98d10eb86b9be701c2270afb4c8ad9b6ec56e888 (patch)
treedc7058e63eb8bb5771b3e429be42aa20b36fd9b6 /documentation
parentf66e7ffddd9262fd19d82dbaa177d92b9f36753c (diff)
downloadpoky-98d10eb86b9be701c2270afb4c8ad9b6ec56e888.tar.gz
ref-manual: Edits to SRC_URI variable.
(From yocto-docs rev: f76f5d5a3cb30d72dc45fb50cf6c14b5ef64c605) Signed-off-by: Scott Rifenbark <scott.m.rifenbark@intel.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation')
-rw-r--r--documentation/ref-manual/ref-variables.xml58
1 files changed, 34 insertions, 24 deletions
diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index 1a4d9e639a..5c91fa6809 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -2942,7 +2942,9 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
2942 <para>The following list explains the available URI protocols: 2942 <para>The following list explains the available URI protocols:
2943 <itemizedlist> 2943 <itemizedlist>
2944 <listitem><para><emphasis><filename>file://</filename> -</emphasis> Fetches files, which is usually 2944 <listitem><para><emphasis><filename>file://</filename> -</emphasis> Fetches files, which is usually
2945 a file shipped with the metadata, from the local machine. 2945 a file shipped with the
2946 <ulink url='&YOCTO_DOCS_DEV_URL;#metadata'>Metadata</ulink>,
2947 from the local machine.
2946 The path is relative to the 2948 The path is relative to the
2947 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link> 2949 <link linkend='var-FILESPATH'><filename>FILESPATH</filename></link>
2948 variable. 2950 variable.
@@ -2955,11 +2957,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
2955 For example, using <filename>bash</filename> to build for the native 2957 For example, using <filename>bash</filename> to build for the native
2956 machine, <filename>PN</filename> is <filename>bash-native</filename>. 2958 machine, <filename>PN</filename> is <filename>bash-native</filename>.
2957 Using <filename>bash</filename> to build for the target and for Multilib, 2959 Using <filename>bash</filename> to build for the target and for Multilib,
2958 <filename>PN</filename> would be <filename>bash</filename> and 2960 <link linkend='var-PN'><filename>PN</filename></link>
2961 would be <filename>bash</filename> and
2959 <filename>lib64-bash</filename>, respectively. 2962 <filename>lib64-bash</filename>, respectively.
2960 </para></listitem> 2963 </para></listitem>
2961 <listitem><para><emphasis><filename>${PF}</filename> - </emphasis> 2964 <listitem><para><emphasis><filename>${PF}</filename> - </emphasis>
2962 <filename>${PN}-${EXTENDPE}${PV}-${PR}</filename>. 2965 <filename>${PN}-${EXTENDPE}${<link linkend='var-PV'>PV</link>}-${<link linkend='var-PR'>PR</link>}</filename>.
2963 The recipe name including all version and revision numbers 2966 The recipe name including all version and revision numbers
2964 (i.e. <filename>eglibc-2.13-r20+svnr15508/</filename> and 2967 (i.e. <filename>eglibc-2.13-r20+svnr15508/</filename> and
2965 <filename>bash-4.2-r1/</filename>).</para></listitem> 2968 <filename>bash-4.2-r1/</filename>).</para></listitem>
@@ -2971,7 +2974,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
2971 base recipe name without any special suffix or version numbers. 2974 base recipe name without any special suffix or version numbers.
2972 </para></listitem> 2975 </para></listitem>
2973 <listitem><para><emphasis><filename>${BP}</filename> -</emphasis> 2976 <listitem><para><emphasis><filename>${BP}</filename> -</emphasis>
2974 <filename>${BPN}-${PV}</filename>. 2977 <filename>${<link linkend='var-BPN'>BPN</link>}-${PV}</filename>.
2975 The base recipe name and version but without any special 2978 The base recipe name and version but without any special
2976 package name suffix.</para></listitem> 2979 package name suffix.</para></listitem>
2977 <listitem><para><emphasis>Files -</emphasis> Files beneath the directory in which the recipe 2980 <listitem><para><emphasis>Files -</emphasis> Files beneath the directory in which the recipe
@@ -2984,7 +2987,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
2984 <listitem><para><emphasis><filename>git://</filename> -</emphasis> Fetches files from a 2987 <listitem><para><emphasis><filename>git://</filename> -</emphasis> Fetches files from a
2985 Git revision control repository.</para></listitem> 2988 Git revision control repository.</para></listitem>
2986 <listitem><para><emphasis><filename>osc://</filename> -</emphasis> Fetches files from 2989 <listitem><para><emphasis><filename>osc://</filename> -</emphasis> Fetches files from
2987 an OSC (OpenSuse Build service) revision control repository.</para></listitem> 2990 an OSC (OpenSUSE Build service) revision control repository.</para></listitem>
2988 <listitem><para><emphasis><filename>repo://</filename> -</emphasis> Fetches files from 2991 <listitem><para><emphasis><filename>repo://</filename> -</emphasis> Fetches files from
2989 a repo (Git) repository.</para></listitem> 2992 a repo (Git) repository.</para></listitem>
2990 <listitem><para><emphasis><filename>svk://</filename> -</emphasis> Fetches files from 2993 <listitem><para><emphasis><filename>svk://</filename> -</emphasis> Fetches files from
@@ -3020,24 +3023,31 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3020 </para> 3023 </para>
3021 <para>Here are options specific to recipes building code from a revision control system: 3024 <para>Here are options specific to recipes building code from a revision control system:
3022 <itemizedlist> 3025 <itemizedlist>
3023 <listitem><para><emphasis><filename>mindate</filename> -</emphasis> Only applies 3026 <listitem><para><emphasis><filename>mindate</filename> -</emphasis>
3024 the patch if <link linkend='var-SRCDATE'><filename>SRCDATE</filename></link> 3027 Apply the patch only if
3025 is equal to or greater than <filename>mindate</filename>.</para></listitem> 3028 <link linkend='var-SRCDATE'><filename>SRCDATE</filename></link>
3026 <listitem><para><emphasis><filename>maxdate</filename> -</emphasis> Only applies 3029 is equal to or greater than <filename>mindate</filename>.
3027 the patch if <link linkend='var-SRCDATE'><filename>SRCDATE</filename></link> 3030 </para></listitem>
3028 is not later than <filename>mindate</filename>.</para></listitem> 3031 <listitem><para><emphasis><filename>maxdate</filename> -</emphasis>
3029 <listitem><para><emphasis><filename>minrev</filename> -</emphasis> Only applies 3032 Apply the patch only if <filename>SRCDATE</filename>
3030 the patch if <link linkend='var-SRCREV'><filename>SRCREV</filename></link> 3033 is not later than <filename>mindate</filename>.
3031 is equal to or greater than <filename>minrev</filename>.</para></listitem> 3034 </para></listitem>
3032 <listitem><para><emphasis><filename>maxrev</filename> -</emphasis> Only applies 3035 <listitem><para><emphasis><filename>minrev</filename> -</emphasis>
3033 the patch if <link linkend='var-SRCREV'><filename>SRCREV</filename></link> 3036 Apply the patch only if <filename>SRCREV</filename>
3034 is not later than <filename>maxrev</filename>.</para></listitem> 3037 is equal to or greater than <filename>minrev</filename>.
3035 <listitem><para><emphasis><filename>rev</filename> -</emphasis> Only applies the 3038 </para></listitem>
3036 patch if <link linkend='var-SRCREV'><filename>SRCREV</filename></link> 3039 <listitem><para><emphasis><filename>maxrev</filename> -</emphasis>
3037 is equal to <filename>rev</filename>.</para></listitem> 3040 Apply the patch only if <filename>SRCREV</filename>
3038 <listitem><para><emphasis><filename>notrev</filename> -</emphasis> Only applies 3041 is not later than <filename>maxrev</filename>.
3039 the patch if <link linkend='var-SRCREV'><filename>SRCREV</filename></link> 3042 </para></listitem>
3040 is not equal to <filename>rev</filename>.</para></listitem> 3043 <listitem><para><emphasis><filename>rev</filename> -</emphasis>
3044 Apply the patch only if <filename>SRCREV</filename>
3045 is equal to <filename>rev</filename>.
3046 </para></listitem>
3047 <listitem><para><emphasis><filename>notrev</filename> -</emphasis>
3048 Apply the patch only if <filename>SRCREV</filename>
3049 is not equal to <filename>rev</filename>.
3050 </para></listitem>
3041 </itemizedlist> 3051 </itemizedlist>
3042 </para> 3052 </para>
3043 <para>Here are some additional options worth mentioning: 3053 <para>Here are some additional options worth mentioning:
@@ -3049,7 +3059,7 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
3049 (or extracts its contents) into the specified 3059 (or extracts its contents) into the specified
3050 subdirectory of <link linkend='var-WORKDIR'><filename>WORKDIR</filename></link>. 3060 subdirectory of <link linkend='var-WORKDIR'><filename>WORKDIR</filename></link>.
3051 This option is useful for unusual tarballs or other archives that 3061 This option is useful for unusual tarballs or other archives that
3052 don't have their files already in a subdirectory within the archive. 3062 do not have their files already in a subdirectory within the archive.
3053 </para></listitem> 3063 </para></listitem>
3054 <listitem><para><emphasis><filename>name</filename> -</emphasis> Specifies a 3064 <listitem><para><emphasis><filename>name</filename> -</emphasis> Specifies a
3055 name to be used for association with <filename>SRC_URI</filename> checksums 3065 name to be used for association with <filename>SRC_URI</filename> checksums