diff options
author | Scott Rifenbark <srifenbark@gmail.com> | 2018-10-24 16:11:03 -0700 |
---|---|---|
committer | Richard Purdie <richard.purdie@linuxfoundation.org> | 2018-10-29 16:54:48 +0000 |
commit | 2520246d6781f40e3d1aab13abb5a01dd09a7594 (patch) | |
tree | 4c073dacc411697ae61d1e7c107e89a02dc63dee /bitbake | |
parent | 8c0a94129e0e1699cd72fd965ac1cc6504b1269f (diff) | |
download | openembedded-core-contrib-2520246d6781f40e3d1aab13abb5a01dd09a7594.tar.gz |
bitbake: bitbake-user-manual: Updates to variable wildcard support.
Fixes [YOCTO #12390]
Applied some fixes to the variable wildcard support documentation
in the BitBake manual. Wording changes and changes to make links
referencing Python syntax go to version 3 rather than version 2.
(Bitbake rev: 0cfc71d1a342b82781b0ba547421e41f6340902a)
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'bitbake')
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml | 23 | ||||
-rw-r--r-- | bitbake/doc/bitbake-user-manual/bitbake-user-manual-ref-variables.xml | 17 |
2 files changed, 24 insertions, 16 deletions
diff --git a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml index df5364c299..8bfa32baa3 100644 --- a/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml +++ b/bitbake/doc/bitbake-user-manual/bitbake-user-manual-metadata.xml @@ -2752,27 +2752,28 @@ </para> </section> - <section id='wildcard-support'> - <title>Wildcard Support</title> + <section id='wildcard-support-in-variables'> + <title>Wildcard Support in Variables</title> <para> - Support for wildcard use varies depending on the context in - which it is used. + Support for wildcard use in variables varies depending on the + context in which it is used. For example, some variables and file names allow limited use of wildcards through the "<filename>%</filename>" and "<filename>*</filename>" characters. Other variables or names support Python's - <ulink url='https://docs.python.org/2/library/glob.html'><filename>glob</filename></ulink> + <ulink url='https://docs.python.org/3/library/glob.html'><filename>glob</filename></ulink> syntax, - <ulink url='https://docs.python.org/2/library/fnmatch.html#module-fnmatch'><filename>fnmatch</filename></ulink> - syntax, or Regular Expression (re) syntax. + <ulink url='https://docs.python.org/3/library/fnmatch.html#module-fnmatch'><filename>fnmatch</filename></ulink> + syntax, or + <ulink url='https://docs.python.org/3/library/re.html#re'><filename>Regular Expression (re)</filename></ulink> + syntax. </para> <para> - When a particular variable's list of filenames or filenames - in general used by BitBake or a build system - based on BitBake support the use of wildcards, the - documentation describes its use and limitations. + For variables that have wildcard suport, the + documentation describes which form of wildcard, its + use, and its limitations. </para> </section> 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 d480881a24..a84b2bc994 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 @@ -126,11 +126,18 @@ BB_ALLOWED_NETWORKS = "*.gnu.org" </literallayout> <note><title>Important</title> - The use of the "<filename>*</filename>" + <para>The use of the "<filename>*</filename>" character only works at the beginning of - a host name. + a host name and it must be isolated from + the remainder of the host name. You cannot use the wildcard character in any - other location of the name. + other location of the name or combined with + the front part of the name.</para> + + <para>For example, + <filename>*.foo.bar</filename> is supported, + while <filename>*aa.foo.bar</filename> is not. + </para> </note> </para></listitem> <listitem><para> @@ -1098,7 +1105,7 @@ <para> When specifying recipe files, you can pattern match using Python's - <ulink url='https://docs.python.org/2/library/glob.html'><filename>glob</filename></ulink> + <ulink url='https://docs.python.org/3/library/glob.html'><filename>glob</filename></ulink> syntax. For details on the syntax, see the documentation by following the previous link. @@ -1198,7 +1205,7 @@ the files. For complete syntax information, see Python's documentation at - <ulink url='http://docs.python.org/release/2.3/lib/re-syntax.html'></ulink>. + <ulink url='http://docs.python.org/3/library/re.html#re'></ulink>. </para> <para> |