diff options
Diffstat (limited to 'bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml | 50 |
1 files changed, 43 insertions, 7 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml index c327af52a9..d480881a24 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml | |||
@@ -115,7 +115,8 @@ | |||
115 | is either not set or set to "0". | 115 | is either not set or set to "0". |
116 | </para></listitem> | 116 | </para></listitem> |
117 | <listitem><para> | 117 | <listitem><para> |
118 | Limited support for wildcard matching against the | 118 | Limited support for the "<filename>*</filename>" |
119 | wildcard character for matching against the | ||
119 | beginning of host names exists. | 120 | beginning of host names exists. |
120 | For example, the following setting matches | 121 | For example, the following setting matches |
121 | <filename>git.gnu.org</filename>, | 122 | <filename>git.gnu.org</filename>, |
@@ -124,6 +125,13 @@ | |||
124 | <literallayout class='monospaced'> | 125 | <literallayout class='monospaced'> |
125 | BB_ALLOWED_NETWORKS = "*.gnu.org" | 126 | BB_ALLOWED_NETWORKS = "*.gnu.org" |
126 | </literallayout> | 127 | </literallayout> |
128 | <note><title>Important</title> | ||
129 | The use of the "<filename>*</filename>" | ||
130 | character only works at the beginning of | ||
131 | a host name. | ||
132 | You cannot use the wildcard character in any | ||
133 | other location of the name. | ||
134 | </note> | ||
127 | </para></listitem> | 135 | </para></listitem> |
128 | <listitem><para> | 136 | <listitem><para> |
129 | Mirrors not in the host list are skipped and | 137 | Mirrors not in the host list are skipped and |
@@ -1082,7 +1090,19 @@ | |||
1082 | 1090 | ||
1083 | <glossentry id='var-BBFILES'><glossterm>BBFILES</glossterm> | 1091 | <glossentry id='var-BBFILES'><glossterm>BBFILES</glossterm> |
1084 | <glossdef> | 1092 | <glossdef> |
1085 | <para>List of recipe files BitBake uses to build software.</para> | 1093 | <para> |
1094 | A space-separated list of recipe files BitBake uses to | ||
1095 | build software. | ||
1096 | </para> | ||
1097 | |||
1098 | <para> | ||
1099 | When specifying recipe files, you can pattern match using | ||
1100 | Python's | ||
1101 | <ulink url='https://docs.python.org/2/library/glob.html'><filename>glob</filename></ulink> | ||
1102 | syntax. | ||
1103 | For details on the syntax, see the documentation by | ||
1104 | following the previous link. | ||
1105 | </para> | ||
1086 | </glossdef> | 1106 | </glossdef> |
1087 | </glossentry> | 1107 | </glossentry> |
1088 | 1108 | ||
@@ -1166,10 +1186,14 @@ | |||
1166 | match any of the expressions. | 1186 | match any of the expressions. |
1167 | It is as if BitBake does not see them at all. | 1187 | It is as if BitBake does not see them at all. |
1168 | Consequently, matching files are not parsed or otherwise | 1188 | Consequently, matching files are not parsed or otherwise |
1169 | used by BitBake.</para> | 1189 | used by BitBake. |
1190 | </para> | ||
1191 | |||
1170 | <para> | 1192 | <para> |
1171 | The values you provide are passed to Python's regular | 1193 | The values you provide are passed to Python's regular |
1172 | expression compiler. | 1194 | expression compiler. |
1195 | Consequently, the syntax follows Python's Regular | ||
1196 | Expression (re) syntax. | ||
1173 | The expressions are compared against the full paths to | 1197 | The expressions are compared against the full paths to |
1174 | the files. | 1198 | the files. |
1175 | For complete syntax information, see Python's | 1199 | For complete syntax information, see Python's |
@@ -1933,15 +1957,27 @@ | |||
1933 | you want to select, and you should set | 1957 | you want to select, and you should set |
1934 | <link linkend='var-PV'><filename>PV</filename></link> | 1958 | <link linkend='var-PV'><filename>PV</filename></link> |
1935 | accordingly for precedence. | 1959 | accordingly for precedence. |
1936 | You can use the "<filename>%</filename>" character as a | 1960 | </para> |
1937 | wildcard to match any number of characters, which can be | 1961 | |
1938 | useful when specifying versions that contain long revision | 1962 | <para> |
1939 | numbers that could potentially change. | 1963 | The <filename>PREFERRED_VERSION</filename> variable |
1964 | supports limited wildcard use through the | ||
1965 | "<filename>%</filename>" character. | ||
1966 | You can use the character to match any number of | ||
1967 | characters, which can be useful when specifying versions | ||
1968 | that contain long revision numbers that potentially change. | ||
1940 | Here are two examples: | 1969 | Here are two examples: |
1941 | <literallayout class='monospaced'> | 1970 | <literallayout class='monospaced'> |
1942 | PREFERRED_VERSION_python = "2.7.3" | 1971 | PREFERRED_VERSION_python = "2.7.3" |
1943 | PREFERRED_VERSION_linux-yocto = "4.12%" | 1972 | PREFERRED_VERSION_linux-yocto = "4.12%" |
1944 | </literallayout> | 1973 | </literallayout> |
1974 | <note><title>Important</title> | ||
1975 | The use of the "<filename>%</filename>" character | ||
1976 | is limited in that it only works at the end of the | ||
1977 | string. | ||
1978 | You cannot use the wildcard character in any other | ||
1979 | location of the string. | ||
1980 | </note> | ||
1945 | </para> | 1981 | </para> |
1946 | </glossdef> | 1982 | </glossdef> |
1947 | </glossentry> | 1983 | </glossentry> |