From 8dd16259287f58f9273002717ec4d27e97127719 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Wed, 12 Jun 2024 07:43:14 +0200 Subject: Merging upstream version 127.0. Signed-off-by: Daniel Baumann --- docs/setup/common_build_errors.md | 34 ++++++++++++++++++++++++++++++++++ docs/setup/index.rst | 1 + docs/setup/macos_build.rst | 2 +- 3 files changed, 36 insertions(+), 1 deletion(-) create mode 100644 docs/setup/common_build_errors.md (limited to 'docs/setup') diff --git a/docs/setup/common_build_errors.md b/docs/setup/common_build_errors.md new file mode 100644 index 0000000000..3267c96937 --- /dev/null +++ b/docs/setup/common_build_errors.md @@ -0,0 +1,34 @@ +# Common Build Errors + +When setting up Firefox, you may encounter some other build errors or +warnings that are not fatal. This document is to help you determine +if the error you're running into is a fatal one or not. + +## Watchman unavailable + +This is a warning and can be ignored. +[Watchman is a file watching service](https://facebook.github.io/watchman/) +that can speed up some interactions with Git and Mercurial. + +## VSCode Java extension + +If you happen to have the Java extension installed in VSCode, there's +a chance that the "Problems" tab in the integrated terminal will +display an error about `Cannot run program [...]/mozilla-unified/mach`. +This is because the extension does not know how to parse the mozilla-central +repository and specifically the `mach` command runner. +This will not prevent you from building and running Firefox. + +## ERROR glean_core + +This is a non-fatal error and will not prevent you from building and +running Firefox. You might see this text in the console after running +`./mach run`. The specific text might appear as: +`Error setting metrics feature config: [...]`. + +## Region.sys.mjs + +This is a non-fatal error, this will not prevent you from building and +running Firefox. You might see this text in the console after running +`./mach run` and the specific text might look like: +`console.error: Region.sys.mjs: Error fetching region`. diff --git a/docs/setup/index.rst b/docs/setup/index.rst index eb0c68aa4e..3cd6d3f229 100644 --- a/docs/setup/index.rst +++ b/docs/setup/index.rst @@ -18,6 +18,7 @@ Don't hesitate to look at the :ref:`Firefox Contributors Quick Reference