diff options
| author |   Scott Rifenbark <srifenbark@gmail.com> | 2018-11-09 14:38:23 -0800 |
|---|---|---|
| committer |   Richard Purdie <richard.purdie@linuxfoundation.org> | 2018-11-22 12:20:52 +0000 |
| commit | 184b4415800c9b2480efb3cf1830a50983edaddb (patch) | |
| tree | 0fc68b7edb846c43e7923e0ac0733f3b20b1b546 /documentation/ref-manual/migration.xml | |
| parent | 40433a02299a99e63ff552fbb713fa5616ac50d0 (diff) | |
| download | openembedded-core-contrib-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.xml | 33 |
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>. </para> </section> + <section id='migration-2.6-python-3-profile-guided-optimizations'> + <title>Python 3 Profile-Guided Optimization</title> + + <para> + The <filename>python3</filename> recipe now enables profile-guided + optimization. + Using this optimization requires a little extra build time in + exchange for improved performance on the target at runtime. + And, the optimization is only enabled if the current + <link linkend='var-MACHINE'><filename>MACHINE</filename></link> + has support for user-mode emulation in QEMU (i.e. "qemu-usermode" + is in + <link linkend='var-MACHINE_FEATURES'><filename>MACHINE_FEATURES</filename></link>, + which it is by default). + </para> + + <para> + If you wish to disable Python profile-guided optimization + regardless of the value of + <filename>MACHINE_FEATURES</filename>, then ensure that + <link linkend='var-PACKAGECONFIG'><filename>PACKAGECONFIG</filename></link> + for the <filename>python3</filename> recipe does not contain "pgo". + You could accomplish the latter using the following at the + configuration level: + <literallayout class='monospaced'> + PACKAGECONFIG_remove_pn-python3 = "pgo" + </literallayout> + Alternatively, you can set + <filename>PACKAGECONFIG</filename> using an append file for the + <filename>python3</filename> recipe. + </para> + </section> + <section id='migration-2.6-miscellaneous-changes'> <title>Miscellaneous Changes</title> |