Commit graph

92 commits

Author SHA1 Message Date
Sylvestre Ledru
82db67a6be Bug 1860157 - Fix typos found by codespell 2.2.6 r=webdriver-reviewers,zeid,search-reviewers,perftest-reviewers,devtools-reviewers,releng-reviewers,gbrown,sparky,jteow
Differential Revision: https://phabricator.services.mozilla.com/D191480
2023-10-19 20:52:10 +00:00
Robert Longson
485e9fb73c Bug 1859193 - replace link that's been taken over by its new location r=sylvestre,firefox-source-docs-reviewers DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D191041
2023-10-16 07:13:04 +00:00
Connor Sheehan
74d5b3ffcf Bug 1855069: Remove note about specific required Mercurial version from macOS build docs r=ahochheiden DONTBUILD
Bug 1786419 added a note about using a specific version of Mercurial on macOS due to a
bug in upstream Mercurial and fsmonitor. Since then the bug has been fixed and users should
update their Mercurial to the latest. We should remove the note about using a specific older
Mercurial version from the docs.

Differential Revision: https://phabricator.services.mozilla.com/D189169
2023-09-26 18:41:06 +00:00
Sylvestre Ledru
4c03bbe394 no bug - doc: also promote git as a repo r=glob DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D188393
2023-09-18 07:54:20 +00:00
Mike Hommey
368daa89f8 Bug 1849273 - Remove the explicit --enable-crashreporter in mozconfig.common. r=firefox-build-system-reviewers,ahochheiden
It has been enabled by default on the relevant platforms essentially
forever, so it doesn't need to be explicitly enabled.

As such, since --enable-crashreporter is not really a useful thing to
point at to wrt build options, we remove its mention from the
configuring build options doc.

Differential Revision: https://phabricator.services.mozilla.com/D186513
2023-08-23 19:07:08 +00:00
Kagami Sascha Rosylight
d97b1ea4f6 Bug 1844802 - Restore links to GeckoView Contributor Guide r=firefox-source-docs-reviewers,sylvestre,geckoview-reviewers,m_kato DONTBUILD
D150200 broke this when changing the title and missed it, probably because breaking links only emits warnings instead of errors.

Differential Revision: https://phabricator.services.mozilla.com/D184245
2023-07-24 12:28:49 +00:00
Ray Kraesig
72acfa071a Bug 1842918 - normalize away spaces in $(PYTHON3) r=firefox-build-system-reviewers,glandium
As of bug 1838763, Python virtualenvs are now located in a subdirectory
of `$MOZBUILD_STATE_PATH`. This, in turn, defaults to a subdirectory of
the home directory, which on Windows often contains spaces.

The Windows build instructions were updated to add a requirement that
`MOZBUILD_STATE_PATH` not contain spaces, under the assumption that this
was merely a clarification of an existing restriction; but this is
indeed a new requirement and breaks existing setups.

Instead, allow makefiles to safely invoke `$(PYTHON3)` without quoting
it everywhere (as they do) by ensuring that its value contains no
spaces, by using the DOS-style (8.3) short path to the Python
executable.

Additionally, clarify in the documentation exactly which paths are
required not to contain spaces.

Differential Revision: https://phabricator.services.mozilla.com/D183305
2023-07-13 13:29:57 +00:00
ahochheiden
1082f133a8 Bug 1838763 - Move the location of site/command virtualenvs out of the objdir and into the state dir r=firefox-build-system-reviewers,glandium
This is necessary for activating the site/command virtualenvs earlier,
since we can't determine what the objdir will be very early on in the
mach process intialization. We do know where the state dir is, and how
to get to the state dir for a specific topsrcdir, so we can use that
instead. This is already where the `mach` virtualenv lives anyway.

Differential Revision: https://phabricator.services.mozilla.com/D181029
2023-06-27 07:05:20 +00:00
Sylvestre Ledru
00f911fd1f no bug - remove some specific point of contact r=overholt DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D178090
2023-05-15 21:10:32 +00:00
Mike Hommey
c82691a556 Bug 1829011 - Remove section about installing Visual Studio. r=sylvestre DONTBUILD
This is now taken care of by `mach bootstrap`/auto-bootstrap.

Differential Revision: https://phabricator.services.mozilla.com/D175957
2023-04-21 07:03:59 +00:00
Mike Hommey
0f963ac8dc Bug 1829011 - Remove obsolete parts of the documentation to build Firefox on Windows. r=sylvestre DONTBUILD
Both removed sections are about issues with link.exe, which we haven't
been using ever since we switched to building with clang-cl/lld-link.

Differential Revision: https://phabricator.services.mozilla.com/D175956
2023-04-20 09:54:48 +00:00
ahochheiden
80339c628f Bug 1825755 - Only create the mozharness venv using --without-pip on Windows r=firefox-build-system-reviewers,glandium
- On Debian/Ubuntu, the base distribution of Python does not come with `ensurepip` (which is still called during `venv` creation). The benefit of not calling `ensurepip` explicitly in a separate command (like we now do for Windows) is that the error message you get when creating the `venv` is very clear and instructs the user to run `apt install python3.x-venv` to fix the problem. (`python3.x-venv` is what contains `ensurepip`). If we did not do this, it would just tell the user that there is `no ensurepip module` and it would hard to figure out that the solution is to run `apt install python3.x-venv`. This isn't an issue for us in CI, but it can be for end users, since that package may not be installed, and some commands (like talos tests) go through mozharness and invoke this code.

- Also removed some Python dependencies in the Linux build docs that are no longer needed.

Differential Revision: https://phabricator.services.mozilla.com/D174525
2023-04-11 18:49:03 +00:00
Sylvestre Ledru
854d40a127 no bug - contrib doc: update a bit the content r=firefox-source-docs-reviewers,marco DONTBUILD
Depends on D173639

Differential Revision: https://phabricator.services.mozilla.com/D173640
2023-04-01 13:27:26 +00:00
Mark Striemer
203d032485 Bug 1820237 - Mention the start-shell.bat script in code block r=glandium
Differential Revision: https://phabricator.services.mozilla.com/D171600
2023-03-30 21:24:12 +00:00
Sylvestre Ledru
499533ce90 no bug - doc: fix a typo DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D173639
2023-03-25 21:50:33 +00:00
Mike Hommey
a26e08027d Bug 1721477 - Fix documentation suggestion for PATH augmentation. r=firefox-build-system-reviewers,andi
Differential Revision: https://phabricator.services.mozilla.com/D168534
2023-02-01 16:37:03 +00:00
Mike Hommey
17b3f43531 Bug 1522986 - Allow to auto-bootstrap the macos SDK. r=firefox-build-system-reviewers,ahochheiden
Differential Revision: https://phabricator.services.mozilla.com/D167772
2023-02-01 09:45:11 +00:00
Ryan VanderMeulen
d75060d305 Bug 1809725 - doc: Instruct users to update to central before trying to build mozilla-unified. DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D166590
2023-01-11 21:38:41 +00:00
Sylvestre Ledru
367e1d8513 Bug 1806714 - doc: add python3-pip in the list of packages for fedora DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D165551
2022-12-27 15:46:25 +00:00
Mike Hommey
f5b95abfc2 Bug 1801738 - Use --enable-project instead of --enable-application. r=firefox-build-system-reviewers,geckoview-reviewers,calu,ahochheiden
--enable-application is the historic flag, and --enable-project was
added to handle the non-application things we build, while encompassing
the meaning of --enable-application. --enable-project has been preferred
for a while and we should reflect that more consistently in mozconfigs,
documentation, etc.

Differential Revision: https://phabricator.services.mozilla.com/D162625
2022-11-22 02:09:26 +00:00
Sylvestre Ledru
9d0a34f94c Bug 1787656 - build doc: remove the necessary step about rm bootstrap.py r=firefox-build-system-reviewers,nalexander DONTBUILD
As it is proposed by the tooling

Differential Revision: https://phabricator.services.mozilla.com/D162544
2022-11-21 17:36:18 +00:00
Jonathan Watt
99120c46dd Bug 1798159 - Fix broken links to MozillaBuild in the Windows documentation. r=sylvestre,firefox-source-docs-reviewers DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D160717
2022-10-29 19:49:14 +00:00
Mike Hommey
46e4b776b5 Bug 1793550 - Make the homebrew python 3.10 problem immediately visible. r=firefox-build-system-reviewers,andi
The problem only happens with homebrew (python.org's build doesn't have
the problem). Many people are hitting it, and we might as well avoid
them the trouble to have to find the documentation and just fail
directly.

Differential Revision: https://phabricator.services.mozilla.com/D158546
2022-10-04 06:50:17 +00:00
Marian-Vasile Laza
e9caca8307 Bug 1785311 - lint fix r=fix CLOSED TREE 2022-08-23 03:15:08 +03:00
Chris Martin
454fbbd0c0 Bug 1786419 - Fix macOS X build doc to workaround bad versions of tools r=ahochheiden DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D155291
2022-08-22 22:53:07 +00:00
Mathew Hodson
3d04063622 Bug 1782855 - Add MSVC to required list for Windows build docs. r=glandium DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D153545
2022-08-03 09:43:32 +00:00
ahochheiden
cbc0ef9b60 Bug 1276019 - Additional doc changes to include a definition for UAC and replaced a static url link with a :ref: link r=sylvestre DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D149461
2022-06-20 10:03:03 +00:00
ahochheiden
66564fb0f0 Bug 1276019 - Add Microsoft Defender Antivirus exclusions automatically during source bootstrap r=glob
I also added `%USERPROFILE%/.mozbuild` to the exclusion list and updated the windows_build docs to reflect the changes made.

Differential Revision: https://phabricator.services.mozilla.com/D149199
2022-06-15 01:37:11 +00:00
Stephen A Pohl
d777cdbc58 Bug 1696513: Require macOS 11 SDK at configure time and update docs. r=mstange
Differential Revision: https://phabricator.services.mozilla.com/D148933
2022-06-13 17:44:51 +00:00
criss
537f7f6e84 Backed out changeset e186162443a6 (bug 1696513) for causing bustages. CLOSED TREE 2022-06-11 05:31:53 +03:00
Stephen A Pohl
b40f4b0786 Bug 1696513: Require macOS 11 SDK at configure time and update docs. r=mstange
Differential Revision: https://phabricator.services.mozilla.com/D148933
2022-06-11 01:05:31 +00:00
criss
ed1236630c Backed out 2 changesets (bug 1773752, bug 1696513) for causing build bustages. CLOSED TREE
Backed out changeset 6628f146ad0b (bug 1773752)
Backed out changeset f636b7e35d0c (bug 1696513)
2022-06-11 02:35:43 +03:00
Stephen A Pohl
a26f93425e Bug 1696513: Require macOS 11 SDK at configure time and update docs. r=mstange
Differential Revision: https://phabricator.services.mozilla.com/D148933
2022-06-10 23:08:34 +00:00
Emilio Cobos Álvarez
0308b0a05c No bug - Fix configure help command. r=dholbert
Differential Revision: https://phabricator.services.mozilla.com/D148064
2022-06-01 19:37:37 +00:00
pankaj28988
d1becba15c Bug 1762795 - Removed dead links in contribution doc. r=sylvestre DONTBUILD
Updated links to Bugzilla and added links to Developer Guide

Differential Revision: https://phabricator.services.mozilla.com/D143998
2022-05-03 13:19:54 +00:00
Sylvestre Ledru
c6ad81bd80 no bug - fx docs: reference the quick reference doc from the setup pages r=marco DONTBUILD
The setup page is referenced from:

https://www.mozilla.org/en-US/about/governance/policies/commit/

Differential Revision: https://phabricator.services.mozilla.com/D139296
2022-02-21 15:57:35 +00:00
Sylvestre Ledru
caaedeee98 Bug 1753413 - fx doc: Remove whitespaces, trailing lines & windows CR r=andi,perftest-reviewers,sparky
Differential Revision: https://phabricator.services.mozilla.com/D137741
2022-02-03 18:34:58 +00:00
Mitchell Hentges
92a19e0eb9 Bug 1740123: Allow invoking Mach outside of MozillaBuild r=glandium
Assuming that the `MOZILLABUILD` environment variable is set, allow
invoking Mach from non-MozillaBuild terminals.

Note that MozillaBuild still needs to be installed, and the
`MOZILLABUILD` environment variable will have to be set.

For future reference: when I tried setting this up with Windows
Store's Python 3.9, I encountered issues when running binaries installed
via `pip`: it would fail with `abort: failed to load Python DLL
python3x.dll`.

Differential Revision: https://phabricator.services.mozilla.com/D133936
2022-01-06 06:49:47 +00:00
Sylvestre Ledru
0078fdfb98 Bug 1721475 - Linux setup doc: add python3-pip in the list of packages r=firefox-build-system-reviewers,mhentges DONTBUILD
Depends on D134954

Differential Revision: https://phabricator.services.mozilla.com/D134955
2022-01-03 20:03:04 +00:00
Sylvestre Ledru
1662821416 Bug 1721478 - Linux setup doc: add curl in the list of packages r=firefox-build-system-reviewers,mhentges DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D134954
2022-01-03 20:03:04 +00:00
Mitchell Hentges
90694028ba Bug 1740167: Update Windows setup docs to use VS 2022 r=glandium
* Recommend the Build Tools over the full Community IDE install
* Bump Windows 10 SDK, C++ ATL version
* Remove "Game development with C++" workload, because it doesn't seem
  to be required anymore - I'm leaning on review and natural
  developer-testing to confirm this assumption.

Differential Revision: https://phabricator.services.mozilla.com/D130773
2021-11-15 22:49:42 +00:00
Nils
3c79233da8 Bug 1740294: Fix typo "then then" -> "then" r=mhentges
Instances of the typo that have been imported from other repositories have been left unchanged.

Differential Revision: https://phabricator.services.mozilla.com/D130561
2021-11-09 17:36:40 +00:00
Tooru Fujisawa
411190c9c7 Bug 1735058 - Use absolute path to mozilla-unified after possible restart of shell. r=mhentges,glandium
bootstrap.py may ask the restart of shell to reflect the change to login script.
Given the step 2 lets user to move to c:/mozilla-source instead of home,
the document should explicitly specify the absolute path in step 3.

Differential Revision: https://phabricator.services.mozilla.com/D128024
2021-10-13 06:42:08 +00:00
Tooru Fujisawa
2a69e3d3d6 Bug 1735307 - Move "rm bootstrap.py" into bootstrap step. r=glandium,mhentges
Differential Revision: https://phabricator.services.mozilla.com/D128184
2021-10-13 06:42:07 +00:00
Tooru Fujisawa
665bb4ba2e Bug 1734983 - Use mozilla-unified in Building Firefox On Windows doc. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D128010
2021-10-09 10:43:15 +00:00
Mike Hommey
4e47a99c0d Bug 1729383 - Advertize MOZ_PARALLEL_BUILD=n rather than MOZ_MAKE_FLAGS=-jn in docs. r=firefox-build-system-reviewers,mhentges
Both work, but the former is preferred. Also remove MOZ_MAKE_FLAGS
in the mozconfig example for msan, because it's irrelevant.

Differential Revision: https://phabricator.services.mozilla.com/D124726
2021-09-08 00:10:21 +00:00
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
Sylvestre Ledru
abaad00ab4 Bug 1714434 - Doc/contribution: Rename the file about Mozilla contributions r=gsvelto DONTBUILD
and set up a redirect

Differential Revision: https://phabricator.services.mozilla.com/D116820
2021-06-06 14:36:52 +00:00
Pier-Luc Thériault
4a86f78a7f Bug 1711824 - Removing documentation on MOZ_BUILD_PROJECTS because it is obsolete r=firefox-build-system-reviewers,mhentges
Differential Revision: https://phabricator.services.mozilla.com/D115440
2021-05-19 14:17: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