summaryrefslogtreecommitdiffstats
path: root/documentation/ref-manual/migration.xml
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2018-11-09 14:38:23 -0800
committerRichard Purdie <richard.purdie@linuxfoundation.org>2018-11-22 12:20:52 +0000
commit184b4415800c9b2480efb3cf1830a50983edaddb (patch)
tree0fc68b7edb846c43e7923e0ac0733f3b20b1b546 /documentation/ref-manual/migration.xml
parent40433a02299a99e63ff552fbb713fa5616ac50d0 (diff)
downloadpoky-184b4415800c9b2480efb3cf1830a50983edaddb.tar.gz
ref-manual: Added new python3 profile-optimization migration topic
(From yocto-docs rev: 2d0960d9282ffcb843ed9956a0e49183b22f11f2) Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Diffstat (limited to 'documentation/ref-manual/migration.xml')
-rw-r--r--documentation/ref-manual/migration.xml33
1 files changed, 33 insertions, 0 deletions
diff --git a/documentation/ref-manual/migration.xml b/documentation/ref-manual/migration.xml
index 7a98b821c7..877b70017f 100644
--- a/documentation/ref-manual/migration.xml
+++ b/documentation/ref-manual/migration.xml
@@ -6203,6 +6203,39 @@ id=f4d4f99cfbc2396e49c1613a7d237b9e57f06f81'>commit message</ulink>.
6203 </para> 6203 </para>
6204 </section> 6204 </section>
6205 6205
6206 <section id='migration-2.6-python-3-profile-guided-optimizations'>
6207 <title>Python 3 Profile-Guided Optimization</title>
6208
6209 <para>
6210 The <filename>python3</filename> recipe now enables profile-guided
6211 optimization.
6212 Using this optimization requires a little extra build time in
6213 exchange for improved performance on the target at runtime.
6214 And, the optimization is only enabled if the current
6215 <link linkend='var-MACHINE'><filename>MACHINE</filename></link>
6216 has support for user-mode emulation in QEMU (i.e. "qemu-usermode"
6217 is in
6218 <link linkend='var-MACHINE_FEATURES'><filename>MACHINE_FEATURES</filename></link>,
6219 which it is by default).
6220 </para>
6221
6222 <para>
6223 If you wish to disable Python profile-guided optimization
6224 regardless of the value of
6225 <filename>MACHINE_FEATURES</filename>, then ensure that
6226 <link linkend='var-PACKAGECONFIG'><filename>PACKAGECONFIG</filename></link>
6227 for the <filename>python3</filename> recipe does not contain "pgo".
6228 You could accomplish the latter using the following at the
6229 configuration level:
6230 <literallayout class='monospaced'>
6231 PACKAGECONFIG_remove_pn-python3 = "pgo"
6232 </literallayout>
6233 Alternatively, you can set
6234 <filename>PACKAGECONFIG</filename> using an append file for the
6235 <filename>python3</filename> recipe.
6236 </para>
6237 </section>
6238
6206 <section id='migration-2.6-miscellaneous-changes'> 6239 <section id='migration-2.6-miscellaneous-changes'>
6207 <title>Miscellaneous Changes</title> 6240 <title>Miscellaneous Changes</title>
6208 6241