Commit Graph

210 Commits

Author SHA1 Message Date
surajeet310
6ea83c8ef9 Bug 1714788 - Fixed more Sphinx warnings in 'mach doc' r=sylvestre DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D117419
2021-06-10 19:33:53 +00:00
Alexandre Lissy
30ae660e03 Bug 1714547 - Add cross-compile to linux build doc r=sylvestre,mhentges
Differential Revision: https://phabricator.services.mozilla.com/D116829
2021-06-04 21:35:25 +00:00
byron jones
1a494b6f2b Bug 1704426 - Document supported build hosts. r=glob
Define "build host" support tiers, and their relationship
to existing "target" tiers.

Differential Revision: https://phabricator.services.mozilla.com/D111578
2021-05-18 14:57:50 +00:00
Mitchell Hentges
cb92d64d4d Bug 1507272: Enable build telemetry for Mozilla devs by default r=firefox-build-system-reviewers,glandium
Check if a user is a Mozilla employee by checking their
Bugzilla groups, or checking if their VCS email ends
with "@mozilla.com".

When a user is setting up a new build environment, telemetry
will be automatically enabled for them if they are an
employee. If they're not an employee, they'll be asked
if they want to opt in.

Differential Revision: https://phabricator.services.mozilla.com/D106315
2021-04-20 13:58:51 +00:00
Alex Lopez
201a891006 Bug 1694646 - Remove old build telemetry. r=mhentges
Now that telemetry is gathered with glean, we can remove the old telemetry.

Differential Revision: https://phabricator.services.mozilla.com/D106735
2021-03-02 15:04:27 +00:00
Nick Alexander
3d0d39d82c Bug 1675848 - Part 2: Add "BackgroundTasksSelector" to static component category registration. r=mhentges,nika
For simplicity, this implements just on in `NO_TASKS` (the default) or
on in `ALL_TASKS` (opt-in).  This disables all category registrations
when in background task mode; we'll selectively re-enable things as
appropriate.

The flag constants were chosen to smoothly extend to a (16-)bit set in
the future, should we want to add a `JUST_TASKS("task", "other-task")`
option in the future.

This also adds ython tests for gen_static_components.py exercising
categories, simply 'cuz it's easiest to see what this adds in such
tests.  Functional tests will follow in patches that actually
implement the new background tasks functionality.

Differential Revision: https://phabricator.services.mozilla.com/D96654
2021-01-25 23:44:49 +00:00
Daniel Le
7f474f9d91 Bug 1684672 - Update mentions of macOS SDK v10.11 to v10.12. r=glandium DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D100591
2021-01-21 12:47:01 +00:00
Ryan VanderMeulen
7f6a58e1d3 Bug 1685788 - Add AArch64 as a supported architecture for macOS. r=sylvestre DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D101211
2021-01-08 20:05:03 +00:00
Markus Stange
504e820dc5 Bug 1685177 - Update sccache-dist documentation for new config file path. r=mhentges
The config file location on macOS recently changed from `~/Library/Preferences/Mozilla.sccache/config`
to `~/Library/Application Support/Mozilla.sccache/config`, see https://github.com/mozilla/sccache/issues/919.

Differential Revision: https://phabricator.services.mozilla.com/D100822
2021-01-05 22:15:14 +00:00
David Major
1fe4ed4c98 Bug 1682345 - Mention LLVM's build guide in toolchains.rst r=Gankro DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D99702
2020-12-14 18:30:22 +00:00
Markus Stange
14e860be47 Bug 1680557 - Suggest more concrete paths to .mozbuild on Windows. r=mhentges DONTBUILD
This matches the other paths further down in the same document.
I'm also adding some quotes because I was getting an "unknown target" error without them, but I'm not sure if the missing quotes were the reason or whether it just happened to succeed on the next try.

Depends on D98673

Differential Revision: https://phabricator.services.mozilla.com/D98674
2020-12-07 16:56:30 +00:00
Markus Stange
13075b5579 Bug 1680557 - Suggest SCCACHE_START_SERVER=1 instead of --start-server because --start-server spawns and detaches a separate server process. r=mhentges DONTBUILD
See https://github.com/mozilla/sccache/issues/772#issuecomment-639058251 .

Differential Revision: https://phabricator.services.mozilla.com/D98673
2020-12-07 16:56:26 +00:00
Alexis Beingessner
e2c5b3cbbe Bug 1680124 - Document Rust builds (and add some pointers/links for clang ones). r=dmajor
Differential Revision: https://phabricator.services.mozilla.com/D98386
2020-12-01 23:55:34 +00:00
Mitchell Hentges
967783d0db Bug 1676915: Add documentation page about Unified Builds r=firefox-build-system-reviewers,mstange,dmajor DONTBUILD
Describe what unified builds are and how they can cause innocuous
changes to cause unexpected compilation failures.

Differential Revision: https://phabricator.services.mozilla.com/D96907
2020-11-13 17:16:33 +00:00
Mitchell Hentges
eef15c6006 Bug 1676951: Improve "on Windows" * 2 sentence r=smacleod DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D96904
2020-11-12 20:39:19 +00:00
Andrew Halberstadt
331bc892dd Bug 1675319 - [manifestparser] Properly support multiline skip-if statements, r=jmaher,extension-reviewers,zombie
This supports one manifestparser expression per line in the 'skip-if',
'fail-if' and 'run-if' keys. As a side effect the:

    skip-if = foo ||
        bar

syntax is no longer supported. Instead it can be:

    skip-if =
        foo  # bug 123
        bar  # bug 456

Differential Revision: https://phabricator.services.mozilla.com/D95927
2020-11-05 19:55:08 +00:00
Sylvestre Ledru
9bce072e44 Bug 1588458 - Replace dxr by searchfox in the rst doc r=ahal DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D49140
2020-10-08 08:13:15 +00:00
Sylvestre Ledru
264cb8dba5 no bug - fx doc - Fix some rst warnings
Depends on D90832

Differential Revision: https://phabricator.services.mozilla.com/D90864
2020-09-22 06:26:42 +00:00
Andi-Bogdan Postelnicu
17c635393e no bug - Doc: add reference for Visual Studio Code the build documentation. r=sylvestre DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D90215
2020-09-15 14:32:17 +00:00
Mitchell Hentges
565f11ba0a Bug 1651424: Report build telemetry using Glean r=firefox-build-system-reviewers,Dexter,rstewart
In addition to the existing build telemetry, also gather the stats and
report with Glean. This new telemetry is reported in tandem with the existing
telemetry to allow testing and confidence before a full roll-out.

Additionally, Glean isn't compatible with Python 2, so the new telemetry only runs
on Python 3 mach commands.

Differential Revision: https://phabricator.services.mozilla.com/D83572
2020-09-09 23:51:57 +00:00
Nicholas Nethercote
0f7f399e93 Bug 1426269 - Change the slashslash filter in preprocessor.py. r=glandium
This commit does the following.

- Renames `slashslash` as `dumbComments`. As a result, it now comes before
  `emptyLines` in alphabetical ordering, which means that if you apply both
  `dumbComments` and `emptyLines`, lines that contain only comments will be
  fully removed.

  (I contemplated changing the filter ordering to match the order specified,
  rather than using alphabetical ordering, but that was more invasive and not
  obviously better.)

- Changes `dumbComments` so it only applies if the comment is at the start of
  the line (with optional leading whitespace). This is so it can be used with
  prefs files, which contain lines like `pref("foo", "https://mozilla.org");`
  where the `//` must not be treated as a comment.

Note that `slashslash` wasn't being used anywhere.

Depends on D88240

Differential Revision: https://phabricator.services.mozilla.com/D88242
2020-09-08 23:04:51 +00:00
Nicholas Nethercote
1aa3d23435 Bug 1426269 - Remove the spaces filter from preprocessor.py. r=glandium
It's not used, probably because it's pretty strange and hard to imagine using
safely. (Stripping leading and trailing space could be useful, but collapsing
sequences of spaces? Hmm.)

Differential Revision: https://phabricator.services.mozilla.com/D88240
2020-09-08 06:54:04 +00:00
Ricky Stewart
d14df1032e Bug 1660614 - Upgrade sccache to pick up more resilient behavior in the presence of cache read failures r=froydnj
This avoids a set of intermittent issues related to `zstd` decompression failures, which in the absence of these changes break the entire build.

This also requires [updating an environment variable](https://github.com/mozilla/sccache/pull/822), which we do in `client.mk` as well as documentation.

Differential Revision: https://phabricator.services.mozilla.com/D88184
2020-08-25 21:16:53 +00:00
Ricky Stewart
995ebcae1d Bug 1658483 - Remove references to the github repo that contains MacOSX-SDKs r=mhentges,dmajor
Differential Revision: https://phabricator.services.mozilla.com/D86727
2020-08-11 17:24:34 +00:00
Joshua Cranmer
45bfd75f59 Bug 1652354, part 𝋡: Support categories with generic values in static component registration. r=kmag
Differential Revision: https://phabricator.services.mozilla.com/D85656
2020-08-10 21:16:31 +00:00
Ryan VanderMeulen
c0977f07d3 Bug 1652075 - Update the minimum supported macOS version in the build docs. r=sylvestre
DONTBUILD

Differential Revision: https://phabricator.services.mozilla.com/D83696
2020-07-17 09:49:32 +00:00
Ricky Stewart
231a4686ff Bug 925350 - Remove dumbmake r=nalexander
After bug 1651806, we're trying to caution people against running `mach build $A_SPECIFIC_TARGET` because it's not generally supported. `dumbmake` is a piece of infrastructure that attempts to make this use case a little bit more useable, but it was always supposed to be a stopgap. There doesn't seem to be a need for it any more.

Differential Revision: https://phabricator.services.mozilla.com/D83136
2020-07-10 18:12:07 +00:00
Nicholas Nethercote
977d5b8a57 Bug 1648348 - Create "Writing Rust Code" docs. r=froydnj,zbraniecki,lina.
This patch includes content from the following places.

- Lina's "Getting Rusty: How to ship an XPCOM component in Firefox" slide deck.
- Zibi's "Rust <--> C/C++ FFI for newbies" gist.

It also links to Emilio's "FFI patterns #1 - Complex Rust data structures
exposed seamlessly to C++" blog post. I was going to include that content, but
it's very long, so I have omitted it for now.

Differential Revision: https://phabricator.services.mozilla.com/D81963
2020-07-07 07:38:27 +00:00
Nicholas Nethercote
40c0751083 Bug 1648348 - Some more tweaks to the Rust build docs. r=froydnj
Differential Revision: https://phabricator.services.mozilla.com/D81288
2020-07-07 07:38:02 +00:00
Mike Hommey
9c264b7cf2 Bug 1240930 - Move jar_maker to the misc tier. r=firefox-build-system-reviewers,geckoview-reviewers,rstewart,agi
Because jar_maker is not in the libs tier, we also rename the libs-%
targets for l10n repacks to l10n-%, which make it clearer what they are
for.

And because multilocale.txt is both a GeneratedFile and a file that is
generated (and installed) via manual build rules, keeping it in the misc
target actually breaks building in toolkit/locales during l10n repacks,
so move it to libs for now.

Differential Revision: https://phabricator.services.mozilla.com/D81766
2020-06-30 21:34:32 +00:00
Nicholas Nethercote
e671bf0673 Bug 1647987 - Create Rust testing docs. r=froydnj.
Some of the testing info is from the Oxidation wiki, and the logging info is
largely from a dev-platform email by Valentin. The other parts I wrote from
scratch.

The commit also makes some small improvements to the Rust build docs.

Differential Revision: https://phabricator.services.mozilla.com/D81017
2020-06-26 01:04:40 +00:00
Nicholas Nethercote
51c5270b67 Bug 1646280 - Improve Rust build docs. r=froydnj
The added material comes from the Oxidation wiki's FAQ and the "Building
Firefox with Rust code" MDN page:
https://wiki.developer.mozilla.org/en-US/docs/Mozilla/Firefox/Building_Firefox_with_Rust_code

Once this commit lands, I will (a) remove the wiki FAQ entries, and (b) replace
the contents of that MDN page with a link to these build docs. There's no point
having overlapping docs, and in-tree is the best place for this information.

This commit also makes the capitalization of sub-headings more consistent.

Differential Revision: https://phabricator.services.mozilla.com/D79956
2020-06-23 05:01:23 +00:00
Nick Alexander
571c7fd42e Bug 1644046 - Get Sonatype nexus with fetch task rather than when building android-build image. r=froydnj
This brings the `android-build` image very close to other build
images, paving the way for it to be folded in completely.  It also
makes us more resilient in the face of upstream service interruptions.

Differential Revision: https://phabricator.services.mozilla.com/D78945
2020-06-15 16:29:30 +00:00
Mitchell Hentges
079ded8c2d Bug 1636251: document mach error reporting r=rstewart
Differential Revision: https://phabricator.services.mozilla.com/D78409
2020-06-11 20:38:18 +00:00
Dorel Luca
27321e1f00 Backed out 3 changesets (bug 1636251) for phyton failures in python/mach/mach/test/test_conditions.py. CLOSED TREE
Backed out changeset a033282e742d (bug 1636251)
Backed out changeset ce8cb6373f88 (bug 1636251)
Backed out changeset ae78c0a50575 (bug 1636251)
2020-06-11 19:49:44 +03:00
Mitchell Hentges
34d2e43294 Bug 1636251: document mach error reporting r=rstewart
Differential Revision: https://phabricator.services.mozilla.com/D78409
2020-06-10 19:50:59 +00:00
Mitchell Hentges
ed90a04ad1 Bug 1632874: |mach bootstrap| should write mozconfig file if it doesn't exist r=rstewart
Rather than always printing instructions at the end of the bootstrap phase, we will now create a mozconfig
file if one doesn't exist and there's configuration to be written.

Differential Revision: https://phabricator.services.mozilla.com/D78417
2020-06-08 19:36:56 +00:00
Axel Hecht
1343d506c0 Bug 1641184, use only the merge dir for repacks, r=nalexander
l10n-merge creates a full merge dir for a while now, let's
simplify the build logic to only read from that directory
during repacks and langpacks.

Differential Revision: https://phabricator.services.mozilla.com/D77023
2020-05-27 17:04:06 +00:00
Sylvestre Ledru
e2db40c369 Bug 1636499 - tier build doc - improve the wording (thanks david)
Differential Revision: https://phabricator.services.mozilla.com/D74441
2020-05-08 17:36:49 +00:00
Sylvestre Ledru
3f6e5b5d16 Bug 1636499 - tier build doc - polish the doc after import r=froydnj
Differential Revision: https://phabricator.services.mozilla.com/D74429
2020-05-08 17:22:40 +00:00
Sylvestre Ledru
a2e9cfd308 Bug 1636499 - tier build doc - import the mdn page r=froydnj
https://developer.mozilla.org/docs/Mozilla/Supported_build_configurations

Depends on D74422

Differential Revision: https://phabricator.services.mozilla.com/D74427
2020-05-08 17:04:51 +00:00
Sylvestre Ledru
8455797365 Bug 1636499 - Remove a (very) outdated page r=froydnj
Differential Revision: https://phabricator.services.mozilla.com/D74422
2020-05-08 16:48:28 +00:00
Ricky Stewart
2ce561dd99 Bug 1635514 - Delete tup CI/configure stuff r=froydnj
This includes scripts that involve `tup`, jobs that build `tup` in automation, `tup.configure`, and related infrastructure and documentation.

Differential Revision: https://phabricator.services.mozilla.com/D73921
2020-05-05 18:34:16 +00:00
JulianWels
6e54cc8465 Bug 1616522 - Added mochitest documentation for https-tests. r=ahal DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D63628

--HG--
extra : moz-landing-system : lando
2020-02-21 14:32:05 +00:00
Chris Manchester
7335e6b9ad Bug 1578493 - Don't use ~ in doc examples where tilde expansion no longer occurs. r=dmajor
Differential Revision: https://phabricator.services.mozilla.com/D63357

--HG--
extra : moz-landing-system : lando
2020-02-19 18:24:25 +00:00
Chris Manchester
0daada8368 Bug 1611231 - Add a note about rewrite_includes_only to sccache-dist docs. r=froydnj
Differential Revision: https://phabricator.services.mozilla.com/D60879

--HG--
extra : moz-landing-system : lando
2020-01-23 21:58:52 +00:00
shindli
26374765cb Backed out 2 changesets (bug 1611231) for causing a linting falure in /builds/worker/checkouts/gecko/build/docs/sccache-dist.rst CLOSED TREE
Backed out changeset c38aab2ba30b (bug 1611231)
Backed out changeset 278f992ad76d (bug 1611231)
2020-01-23 23:02:38 +02:00
Chris Manchester
5b0fdb451b Bug 1611231 - Add a note about rewrite_includes_only to sccache-dist docs. r=froydnj
Differential Revision: https://phabricator.services.mozilla.com/D60879

--HG--
extra : moz-landing-system : lando
2020-01-23 20:46:42 +00:00
Mike Shal
25308d30a2 Bug 1563403 - Use 3-tier PGO for local MOZ_PGO=1 builds; r=firefox-build-system-reviewers,dmajor,chmanchester
Local PGO builds now use 3-tier machinery under the hood. Instead of a
single object directory that gets cleaned in between the instrumented
and profile-use builds, now the instrumented build uses a separate
'${objdir}/instrumented' directory. This makes it easier to handle
within mach since we can drive the two builds with environment variables
and keep all build artifacts separate, without needing to do manual
cleanup in between.

Differential Revision: https://phabricator.services.mozilla.com/D50098

--HG--
extra : moz-landing-system : lando
2019-12-06 01:07:32 +00:00
Axel Hecht
60e0566e34 Bug 1601249, update l10n-related build documentation, r=flod
This fixes quite a bit of historical baggage, and also goes
into a bit more details of what the l10n repacks actually do.

Differential Revision: https://phabricator.services.mozilla.com/D55807

--HG--
extra : moz-landing-system : lando
2019-12-05 13:44:22 +00:00