Commit graph

83 commits

Author SHA1 Message Date
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
Gijs Kruitbosch
dab991dda3 Bug 1702526 - suggest people use wget instead of curl for downloading the bootstrap script on Windows DONTBUILD r=glob
Differential Revision: https://phabricator.services.mozilla.com/D110568
2021-04-01 17:23:05 +00:00
Jan Odvarko
f62cae8410 Bug 1658876 - [devtools] Avoid including its own cloning and build instructions in docs. r=nchevobbe
Removing DevTools specific build instructions in favor of https://firefox-source-docs.mozilla.org/setup/index.html

Differential Revision: https://phabricator.services.mozilla.com/D108182
2021-03-15 11:41:14 +00:00
Nikita Sen
692373c939 Bug 1696813 - Path of mach changed from mozilla-unified to project repository, i.e. mozilla-central. r=gsvelto DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D107887
2021-03-11 13:36:35 +00:00
Mitchell Hentges
63b2da5135 Bug 1696225: Remove "Processor" requirement in Mac quick-start r=firefox-build-system-reviewers,glandium
The linked ARM wiki docs are obsolete, and will soon be unnecessary.
Additionally, the "processor" requirement is entirely redundant since we
support all processors compatible with macOS 10.12 or later.

Differential Revision: https://phabricator.services.mozilla.com/D107098
2021-03-09 16:27:03 +00:00
Mitchell Hentges
e44df456bd Bug 1687980: Remove obsolete Fedora 19/20 32bit setup docs r=sylvestre
Fedora 19 and 20 were released in 2013. If these docs haven't been
adjusted for modern Fedora, they're probably out-of-date.

Differential Revision: https://phabricator.services.mozilla.com/D104733
2021-02-16 17:48:12 +00:00
Mitchell Hentges
8ce816f512 Bug 1687980: Simplify "Getting Set Up" page r=mhoye,firefox-build-system-reviewers,glandium,sylvestre,andi
When a user is at the top-level "Getting Set Up" page, they should be
shown which path to take (Windows/Mac/Linux) without redundantly showing
the platform-specific technicalities.

Differential Revision: https://phabricator.services.mozilla.com/D104099
2021-02-16 17:48:12 +00:00
Mitchell Hentges
35a65cf626 Bug 1687980: Make Linux quickstart docs more concise r=mhoye,sylvestre
* Removes duplicated information
* Removes unnecessary extra details (e.g.: how pyenv works - that's
  documented in pyenv docs)
* Recommends the standalone bootstrap script
* Removes unnecessary mozconfig instructions
* Removes unnecessary per-distro information

Differential Revision: https://phabricator.services.mozilla.com/D102975
2021-02-16 17:48:12 +00:00
Mitchell Hentges
08b3a902ec Bug 1687980: Make Windows quickstart docs more concise r=mhoye,sylvestre,andi
* Puts the docs in order, so that contributors aren't jumping to the
  middle of the page to install system tools, then back to the top to
  clone Firefox.
* Removes docs on MacPorts since it's being removed in bug 1688263.
* Removes step to manually install brew packages since that happens
   automatically in bootstrap now.
* Simplifies mercurial installation docs
* Removes unnecessary mozconfig-tweaking instructions
* Removes almost-always-unnecessary DEFINE and troubleshooting
  information.

Differential Revision: https://phabricator.services.mozilla.com/D102974
2021-02-16 17:48:11 +00:00
Mitchell Hentges
a3eb85e571 Bug 1687980: Make macOS quickstart docs more concise r=sylvestre,mhoye
* Puts the docs in order, so that contributors aren't jumping to the
  middle of the page to install system tools, then back to the top to
  clone Firefox.
* Removes docs on MacPorts since it's being removed in bug 1688263.
* Removes step to manually install brew packages since that happens
   automatically in bootstrap now.
* Simplifies mercurial installation docs
* Removes unnecessary mozconfig-tweaking instructions
* Removes almost-always-unnecessary DEFINE and troubleshooting
  information.

Differential Revision: https://phabricator.services.mozilla.com/D102973
2021-02-16 17:48:11 +00:00