From e6f52cc02b602b3d8ac035e5030edd5363433158 Mon Sep 17 00:00:00 2001 From: Isabella Date: Tue, 12 Nov 2024 12:25:31 -0700 Subject: [PATCH] Document gfx.webrender.disable workaround Signed-off-by: Isabella --- README.md | 7 +++++++ docs/img/black_caption_buttons.png | Bin 0 -> 7362 bytes 2 files changed, 7 insertions(+) create mode 100644 docs/img/black_caption_buttons.png diff --git a/README.md b/README.md index 528fe3d..b1a9ad3 100644 --- a/README.md +++ b/README.md @@ -37,6 +37,13 @@ Step-by-step: **Note:** Unfortunately, it's not possible to create one distribution that works across patches. This is because the XUL version check is baked into `firefox.exe` rather than `xul.dll`. +## Common problems + +- I get a black box over the system minimise/maximise/close buttons when reporting the OS version as Windows 7 or 8, like in the following image. + + ![Preview image](docs/img/black_caption_buttons.png) + - This is a problem with Firefox's WebRender engine. I'm not entirely sure why this occurs, or how to fix it, but the only workaround that I could find is using WebRender software rendering mode. So, open `about:config` and set `gfx.webrender.software` to true. + ## Building from source [Clone Firefox for yourself](https://firefox-source-docs.mozilla.org/setup/index.html), and then mix in the patches as needed. Note that when you clone, it will put in the `mozilla-central` branch. You probably don't want this as these correspond to the latest Nightly builds, which will mean that the produced `xul.dll` binary will likely be incompatible with the current build environment. diff --git a/docs/img/black_caption_buttons.png b/docs/img/black_caption_buttons.png new file mode 100644 index 0000000000000000000000000000000000000000..8f94a5e95097d4ba5f7fa9fcf5229e566bb3d313 GIT binary patch literal 7362 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 literal 0 HcmV?d00001