From 1c8b7ea32490846f8a3188e4e9689463a5e99798 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?R=C3=A9mi=20Verschelde?= <rverschelde@gmail.com>
Date: Mon, 23 Oct 2017 20:49:04 +0200
Subject: [PATCH] Document cross-compilation caveat on Ubuntu

Fixes https://github.com/godotengine/godot/issues/9258.
---
 .../compiling/compiling_for_windows.rst       | 25 +++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/development/compiling/compiling_for_windows.rst b/development/compiling/compiling_for_windows.rst
index 0e3238f31..84e47608d 100644
--- a/development/compiling/compiling_for_windows.rst
+++ b/development/compiling/compiling_for_windows.rst
@@ -397,6 +397,31 @@ differ based on your system):
     user@host:~$ ${MINGW32_PREFIX}gcc --version
     i686-w64-mingw32-gcc (GCC) 6.1.0 20160427 (Mageia MinGW 6.1.0-1.mga6)
 
+Troubleshooting
+~~~~~~~~~~~~~~~
+
+Cross-compiling from some versions of Ubuntu may lead to `this bug <https://github.com/godotengine/godot/issues/9258>`_,
+due to a default configuration lacking support for POSIX threading.
+
+You can change that configuration following those instructions,
+for 32-bit:
+
+::
+
+    sudo update-alternatives --config i686-w64-mingw32-gcc
+    <choose i686-w64-mingw32-gcc-posix from the list>
+    sudo update-alternatives --config i686-w64-mingw32-g++
+    <choose i686-w64-mingw32-g++-posix from the list>
+
+And for 64-bit:
+
+::
+
+    sudo update-alternatives --config x86_64-w64-mingw32-gcc
+    <choose x86_64-w64-mingw32-gcc-posix from the list>
+    sudo update-alternatives --config x86_64-w64-mingw32-g++
+    <choose x86_64-w64-mingw32-g++-posix from the list>
+
 Creating Windows export templates
 ---------------------------------