202 Commits

Author SHA1 Message Date
Bogdan Tara
da1098d4aa Backed out 10 changesets (bug 1654103, bug 1672023, bug 1518999) for PanZoomControllerTest.touchEventForResult gv-junit failures CLOSED TREE
Backed out changeset ff3fb0b4a512 (bug 1672023)
Backed out changeset e7834b600201 (bug 1654103)
Backed out changeset 807893ca8069 (bug 1518999)
Backed out changeset 13e6b92440e9 (bug 1518999)
Backed out changeset 8b2ac5a6c98a (bug 1518999)
Backed out changeset 575748295752 (bug 1518999)
Backed out changeset 65f07ce7b39b (bug 1518999)
Backed out changeset 4bb80556158d (bug 1518999)
Backed out changeset 8ac8461d7bd7 (bug 1518999)
Backed out changeset e8ba13ee17f5 (bug 1518999)
2020-10-24 03:36:18 +03:00
Ricky Stewart
c0cea3b0fa Bug 1654103: Standardize on Black for Python code in mozilla-central. r=remote-protocol-reviewers,marionette-reviewers,webdriver-reviewers,perftest-reviewers,devtools-backward-compat-reviewers,jgilbert,preferences-reviewers,sylvestre,maja_zf,webcompat-reviewers,denschub,ntim,whimboo,sparky
Allow-list all Python code in tree for use with the black linter, and re-format all code in-tree accordingly.

To produce this patch I did all of the following:

1. Make changes to tools/lint/black.yml to remove include: stanza and update list of source extensions.

2. Run ./mach lint --linter black --fix

3. Make some ad-hoc manual updates to python/mozbuild/mozbuild/test/configure/test_configure.py -- it has some hard-coded line numbers that the reformat breaks.

4. Make some ad-hoc manual updates to `testing/marionette/client/setup.py`, `testing/marionette/harness/setup.py`, and `testing/firefox-ui/harness/setup.py`, which have hard-coded regexes that break after the reformat.

5. Add a set of exclusions to black.yml. These will be deleted in a follow-up bug (1672023).

# ignore-this-changeset

Differential Revision: https://phabricator.services.mozilla.com/D94045
2020-10-23 20:40:42 +00:00
Dorel Luca
1ff59cb7a3 Backed out changeset 7558c8821a07 (bug 1654103) for multiple failures. CLOSED TREE 2020-10-22 03:51:06 +03:00
Ricky Stewart
50762dacab Bug 1654103: Standardize on Black for Python code in mozilla-central. r=remote-protocol-reviewers,marionette-reviewers,webdriver-reviewers,perftest-reviewers,devtools-backward-compat-reviewers,jgilbert,preferences-reviewers,sylvestre,maja_zf,webcompat-reviewers,denschub,ntim,whimboo,sparky
Allow-list all Python code in tree for use with the black linter, and re-format all code in-tree accordingly.

To produce this patch I did all of the following:

1. Make changes to tools/lint/black.yml to remove include: stanza and update list of source extensions.

2. Run ./mach lint --linter black --fix

3. Make some ad-hoc manual updates to python/mozbuild/mozbuild/test/configure/test_configure.py -- it has some hard-coded line numbers that the reformat breaks.

4. Add a set of exclusions to black.yml. These will be deleted in a follow-up bug (1672023).

# ignore-this-changeset

Differential Revision: https://phabricator.services.mozilla.com/D94045
2020-10-21 21:27:27 +00:00
Sylvestre Ledru
71abba1805 no bug - Remove old DXR references r=andi DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D94076
2020-10-20 11:59:25 +00:00
Stephen A Pohl
19bd39d8da Bug 1668941: Update build and debugging documentation for macOS. r=haik DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D92293
2020-10-13 17:58:50 +00:00
gsvelto
fbe0690bcd Bug 1460338 - Migrate symbol server docs from MDN to in-tree. r=sylvestre DONTBUILD
The links and instructions in the page have been updated to reflect the
changes in the symbol server and the old copy was removed. Images have been
recompressed to reduce size.

Differential Revision: https://phabricator.services.mozilla.com/D92878
2020-10-08 14:32:54 +00:00
Jasleen Kaur
e1939456ec Bug 1669946 - Fixed some documentation typos. r=emilio DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D92931
2020-10-08 13:44:34 +00:00
Dhairya Bahl
1a64cbb050 Bug 1669921 - Fixed a typo in windows_build.rst r=championshuttler,sylvestre DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D92896
2020-10-08 11:54:45 +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
Ricky Stewart
e6fd6a6aa7 Bug 1667436 - Merge content of docs/setup/mach.rst into existing documentation r=firefox-build-system-reviewers,mhentges DONTBUILD
This document was imported from MDN and contained very outdated/incorrect information, and much of the information here is duplicated from the existing `mach` documentation. For the little content that isn't already expressed in the existing documentation in a better way, merge it into `python/mach/docs`.

The unique content is mainly in the FAQ, so I added a new page for that.

Differential Revision: https://phabricator.services.mozilla.com/D91455
2020-10-05 16:51:41 +00:00
Sylvestre Ledru
31b3856da6 Bug 1667831 - doc: fix more pygments r=firefox-source-docs-reviewers,championshuttler DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D91868
2020-09-30 07:03:41 +00:00
Sylvestre Ledru
3c813005a1 Bug 1667831 - doc: fix more warnings r=firefox-source-docs-reviewers,ahal DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D91642
2020-09-29 18:48:17 +00:00
Sylvestre Ledru
6be67c14c4 Bug 1667831 - doc: refresh links as many pages moved in-tree r=firefox-source-docs-reviewers,ahal DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D91619
2020-09-29 17:53:54 +00:00
ruchikabgosain
5e3cc11a26 Bug 1587022 - Improve documentation for Mozilla specific ESLint rules. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D52626
2020-09-29 15:18:56 +00:00
Sylvestre Ledru
b875fbbac5 Bug 1667831 - fx doc: Include some recent changes from mdn r=ochameau
Differential Revision: https://phabricator.services.mozilla.com/D91618
2020-09-28 18:24:55 +00:00
Markus Stange
9aa3b6a184 Bug 1667463 - Fix two typos in using_cxx_in_firefox_code.rst. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D91472
2020-09-25 20:25:23 +00:00
Simon Giesecke
3abd6dca98 Bug 1648010 - Update coding style with respect to string literals. r=froydnj
Differential Revision: https://phabricator.services.mozilla.com/D81503
2020-07-21 11:24:06 +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
Sylvestre Ledru
102a0968b1 Bug 1665854 - fx doc: Various improvements + configuration + fixes in the doc r=firefox-build-system-reviewers,rstewart
Depends on D90831

Differential Revision: https://phabricator.services.mozilla.com/D90832
2020-09-22 06:26:17 +00:00
Sylvestre Ledru
cadbbb06d8 Bug 1666183 - Import the crash reporting doc from MDN r=gsvelto,dmajor
Differential Revision: https://phabricator.services.mozilla.com/D90831
2020-09-22 06:25:36 +00:00
Sylvestre Ledru
768d4782c8 Bug 1665854 - fx doc: Update the contributions docs from MDN r=firefox-build-system-reviewers,rstewart
Depends on D90664

Differential Revision: https://phabricator.services.mozilla.com/D90665
2020-09-21 19:31:16 +00:00
Sylvestre Ledru
c89bc81827 Bug 1665854 - Import more contributions docs from MDN r=firefox-build-system-reviewers,rstewart
Differential Revision: https://phabricator.services.mozilla.com/D90664
2020-09-21 17:57:22 +00:00
Sylvestre Ledru
ae62eb5a62 Bug 1666257 - fx doc: Limit the depth of autosection r=firefox-source-docs-reviewers,championshuttler
Only run autosection for the page title.
Otherwise, we have a huge number of duplicate links.
For example, the page https://firefox-source-docs.mozilla.org/code-quality/lint/
is called "Linting"
just like https://firefox-source-docs.mozilla.org/remote/CodeStyle.html

And creating a :ref:Linting point to the latter.

We have also a huge number of dup label as they are following the same template:
https://firefox-source-docs.mozilla.org/code-quality/lint/linters/codespell.html
https://firefox-source-docs.mozilla.org/code-quality/lint/linters/cpp-virtual-final.html

It also decreases the number of warnings (1463 to 637)

Differential Revision: https://phabricator.services.mozilla.com/D90857
2020-09-21 15:31:57 +00:00
Sylvestre Ledru
dba81844c2 Bug 1666244 - Update of the wording + url at the end of the build r=mhoye
Differential Revision: https://phabricator.services.mozilla.com/D90855
2020-09-21 13:43:52 +00:00
Botond Ballo
80d302db4e Bug 1665499 - Document clangd's 'switch header/source' command. r=andi DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D90482
2020-09-17 05:20:18 +00:00
Sylvestre Ledru
d0dd2b5efe no bug - doc: replace the mdn link by intree r=andi DONTBUILD
Depends on D90387

Differential Revision: https://phabricator.services.mozilla.com/D90388
2020-09-16 13:24:16 +00:00
Ricky Stewart
72d793d728 Bug 1664581 - Specifically recommend installing version control systems in documentation r=nalexander
This is a requirement anyway, and the bootstrap script will yell at you if it can't find `hg` (or `git`, if it's necessary), but we can be more specific about this requirement here so people don't waste any more time than necessary.

Differential Revision: https://phabricator.services.mozilla.com/D90172
2020-09-14 21:30:21 +00:00
Sylvestre Ledru
f23398e021 no bug - Update the pylint doc r=andi DONTBUILD
Also do that to verify reviewbot

Differential Revision: https://phabricator.services.mozilla.com/D90075
2020-09-14 10:34:37 +00:00
Brian Grinstead
4edb87a680 Bug 1664507 - Add documentation for testing policy r=Gijs DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D89941
2020-09-11 19:19:29 +00:00
Andi-Bogdan Postelnicu
4e61a84966 no bug - Doc: document vscode integration. r=sylvestre DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D89716
2020-09-10 13:56:26 +00:00
Ricky Stewart
e559d0c65b Bug 1663959 - Remove references to autoconf from build documentation r=dmajor
As of bug 1663863, we vendor this in-tree, so installing/configuring it is no longer necessary.

Differential Revision: https://phabricator.services.mozilla.com/D89614
2020-09-09 15:44:50 +00:00
Sylvestre Ledru
62f7f8390f Bug 1663916 - mdn to in-tree: Import some Windows & Debugging info r=firefox-build-system-reviewers,rstewart
Differential Revision: https://phabricator.services.mozilla.com/D89592
2020-09-09 15:37:20 +00:00
Ricky Stewart
f339ca9f42 Bug 1660831 - Reference the standalone bootstrap.py script in windows_build.rst and prefer mozilla-unified to mozilla-central where relevant r=mhentges,froydnj
Today the docs tell you to directly clone `mozilla-central`, which is a weird departure from what we do in the other per-platform documents for no real reason. Instead, reference the standalone `bootstrap.py` script as we do for Linux and macOS.

Also, do a little scan and replace references to `mozilla-central` with `mozilla-unified` where appropriate.

Differential Revision: https://phabricator.services.mozilla.com/D88051
2020-08-31 17:51:14 +00:00
Emil Farisan
3997e86c02 Bug 1661434 - added imported message banner to imported pages.
Differential Revision: https://phabricator.services.mozilla.com/D88733
2020-08-31 12:13:53 +00:00
Emil Farisan
affc18cdb6 Bug 1661434 - added mozilla symbol server and source server page to in-tree. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D88729
2020-08-31 11:51:58 +00:00
Emil Farisan
611d45c6ff Bug 1661434 - move some strings to an rst code block. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D88728
2020-08-31 11:52:06 +00:00
Emil Farisan
7a87d13818 Bug 1661434 - made content changes to some of the pages. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D88727
2020-08-31 11:50:47 +00:00
Emil Farisan
d68985630c Bug 1661434 - added debugging and taskcluster pages from MDN to in-tree. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D88580
2020-08-31 11:16:52 +00:00
Sylvestre Ledru
da28d33f60 no bug - Fx doc: Replace the record/replay doc by rr DONTBUILD
This is a simple import from:
https://github.com/mozilla/rr/wiki/Recording-Firefox

Differential Revision: https://phabricator.services.mozilla.com/D87946
2020-08-22 15:08:37 +00:00
Chris H-C
5493409c18 Bug 1654339 - Add Glean metrics autodocs to moztreedocs r=janerik,ahal
Also define a scheme for storing the index of Glean definitions files in a file
separate from the build system for consumption by
* mach build
* mach doc
* (future) mozilla/probe-scraper

Differential Revision: https://phabricator.services.mozilla.com/D87600
2020-08-21 16:30:45 +00:00
Emil Farisan
e5378efe38 Bug 1658505 - updated links and updated some code blocks. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D87443
2020-08-19 16:10:37 +00:00
Emil Farisan
1c3c4674f6 Bug 1658505 - added banner in migrated pages and added table. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D86812
2020-08-19 10:12:39 +00:00
Emil Farisan
f7f16794c9 Bug 1658505 - renamed files from mozilla to firefox. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D86811
2020-08-17 12:08:57 +00:00
Emil Farisan
bfa8dd8228 Bug 1658505 - fix codespell and rst errors and remove unused reference. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D86810
2020-08-17 12:07:49 +00:00
Emil Farisan
8d75cc29fb Bug 1658505 - added debugging and memory sanitizer pages from MDN to in-tree. r=sylvestre
Differential Revision: https://phabricator.services.mozilla.com/D86705
2020-08-17 12:07:18 +00:00
Bryce Seager van Dyk
0c45c50c1f Bug 1659726 - Fix mode line docs to use 2 space indents rather than 8. r=sylvestre DONTBUILD
Differential Revision: https://phabricator.services.mozilla.com/D87448
2020-08-19 07:51:42 +00:00
Sylvestre Ledru
5ea6c250c3 Bug 1657926 - firefox doc: fix some warnings r=championshuttler
Differential Revision: https://phabricator.services.mozilla.com/D86732
2020-08-11 23:20:25 +00:00
Mitchell Hentges
710be25312 Bug 1655361: Prints a warning if Windows Defender is watching the Firefox checkout directory r=firefox-build-system-reviewers,rstewart
There's a Windows Defender CLI (`Get-MpComputerStatus`) available, but MozillaBuild
can't (easily) access PowerShell. So, instead, we find Windows Defender status and path exclusions
by checking the registry at HKLM\SOFTWARE\Microsoft\Windows Defender.

Determining if Windows Defender is "on" or not is a surprisingly vague task.
Not only does it encompass a lot of components (of which Ricky and I believe "Real-time protection"
is the part slowing down the build), but there's (at least?) two different kinds of "disabled"
states that it can be in:
* If "disabled" via Settings, it will turn itself back on after a reboot
* If an antivirus is installed, it will turn itself off permanently

Unfortunately, disabling "Real-time protection" in Settings doesn't affect any registry keys, but
I'm opting to ignore this because I doubt many users are manually disabling this protection before
each build. The repercussion of this is that users may be incorrectly warned "your Firefox
directory isn't excluded from Windows Defender!".

Focusing on the antivirus use case and querying the registry I found that:
* Querying the `IsServiceRunning` value wasn't sufficient because new Windows installations didn't have that key
* Querying the `DisableRealtimeMonitoring` value was inconsistent - it can be missing, and not always because an antivirus removed it
* Querying the `DisableAntiVirus` value doesn't _sound_ accurate (we care about Real-time Protection), but it's consistently "off" for non-AV machines, and "on" for machines with an AV installed. So, this is our winner!

TL;DR: there may be some "false positive" warnings about excluding the Firefox srcdir, but they're
accurate for my test cases and workaround-able (just add the exclusion to Windows Defender).

Also, this patch updates our Windows Defender docs to make them:
* More easily link-able
* Have direct advice to resolve the issue

Differential Revision: https://phabricator.services.mozilla.com/D85952
2020-08-11 20:59:40 +00:00
Sylvestre Ledru
1bcabb9d34 Bug 1657926 - Move to sphinx 3.1.2 and sphinx-js 3.0.1 r=championshuttler
Hopefully, it will help with the intermittent issues.
And it seems that the warnings are better presented.

Differential Revision: https://phabricator.services.mozilla.com/D86361
2020-08-11 15:26:16 +00:00