From 1b38c736550004fba1b9712c1a5788b3eefa49be Mon Sep 17 00:00:00 2001
From: Mike Pall <mike>
Date: Sun, 10 Dec 2023 15:45:10 +0100
Subject: [PATCH] Document workaround for multilib vs. cross-compiler conflict.

Reported by igorpupkinable. #1126
---
 doc/install.html | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/doc/install.html b/doc/install.html
index 21866315..7f2e40e4 100644
--- a/doc/install.html
+++ b/doc/install.html
@@ -240,7 +240,10 @@ for any supported target, as long as both architectures have the same
 pointer size. If you want to cross-compile to any 32 bit target on an
 x64 OS, you need to install the multilib development package (e.g.
 <tt>libc6-dev-i386</tt> on Debian/Ubuntu) and build a 32 bit host part
-(<tt>HOST_CC="gcc -m32"</tt>).
+(<tt>HOST_CC="gcc -m32"</tt>). On some distro versions, multilib conflicts
+with cross-compilers. The workaround is to install the x86 cross-compiler
+package <tt>gcc-i686-linux-gnu</tt> and use it to build the host part
+(<tt>HOST_CC=i686-linux-gnu-gcc</tt>).
 </p>
 <p>
 You need to specify <tt>TARGET_SYS</tt> whenever the host OS and the