gecko-dev/build/docs
Gregory Szorc c2d58c7edd Bug 1412932 - Set MOZ_PGO for configure; r=ted
The mechanism by which PGO builds are kicked off is kinda wonky.

The MOZ_PGO environment variable is recognized by configure and setting
it will result in MOZ_PGO being defined in substs. In addition, the
build backend (previously client.mk, now Makefile.in) also recognizes
MOZ_PGO (from mozconfig or environment) and takes appropriate action.

In-tree mozconfigs set MOZ_PGO via mk_add_options. mk_add_options
is intended as a mechanism to inject state into client.mk and the
make-based build system.

In addition, there is code in mozharness (unchanged by this commit)
that sets MOZ_PGO if appropriate.

A PGO build configuration is different from a non-PGO build
configuration. Therefore a make-centric environment variable to
control PGO is not ideal. Instead, this should be defined as a
configure-time flag and the build invocation should key off that.

This commit normalizes in-tree mozconfigs to set MOZ_PGO via
ac_add_options and updates the PGO documentation to recommend
this method.

MozReview-Commit-ID: k6AZyJuXjs

--HG--
extra : rebase_source : b1a6348611eba08dd67ec938cca5586fbe8e6910
extra : source : 25c7ebc7c44dd253f421b6de3d0337635d0c99d0
2017-11-07 15:13:02 -08:00
..
mozbuild
build-overview.rst
build-targets.rst
cppeclipse.rst Bug 1196367 - Remove AndroidEclipse build backend. r=gps 2017-05-02 21:39:03 -07:00
defining-binaries.rst Bug 1370695 - Remove build system code handling binary components. r=glandium 2017-06-13 16:01:45 -07:00
environment-variables.rst
files-metadata.rst
glossary.rst
index.rst Bug 1390700 - Documentation for sparse checkouts; r=me 2017-08-24 15:39:11 -07:00
jar-manifests.rst Bug 1240660 - Remove support for the "+" prefix in jar manifests. r=gps 2016-01-20 07:24:40 +09:00
locales.rst bug 1370506, update the docs, r=glandium 2017-06-16 13:14:28 +02:00
mozbuild-files.rst Bug 1378410 - 2a. Expose `set` to moz.build sandbox; r=gps 2017-09-01 14:02:30 -04:00
mozbuild-symbols.rst
mozconfigs.rst Bug 1412431 - Remove docs for removed ac_add_app_options; r=me 2017-10-30 11:46:03 -07:00
mozinfo.rst Bug 1401651 - Remove obsolete documentation entries. r=cpeterson 2017-09-20 14:07:43 -04:00
pgo.rst Bug 1412932 - Set MOZ_PGO for configure; r=ted 2017-11-07 15:13:02 -08:00
preprocessor.rst
python.rst
rust.rst Bug 1372743: Add updating Cargo.lock file in 'toolkit/library/rust' using 'cargo update' as step in the docs to add a rust crate. r=rillian 2017-06-13 16:35:06 -07:00
slow.rst
sparse.rst Bug 1394054: include try_task_config.json in sparse checkout; r=gps 2017-08-26 00:19:36 +00:00
supported-configurations.rst
test_manifests.rst Bug 1242051 - Install test files to the objdir lazily rather than with each invocation of mach. r=gps 2016-04-04 14:56:52 -07:00
toolchains.rst Bug 1407678 - Make windows_toolchain.py support VS2017. r=mshal DONTBUILD 2017-11-02 11:10:39 -04:00
visualstudio.rst