From bab9b33c490a9f21db9c994a619a93ad01ceb48e Mon Sep 17 00:00:00 2001
From: Boris Kolpackov <boris@codesynthesis.com>
Date: Fri, 24 Jun 2016 20:51:05 +0200
Subject: Document wineserver voodoo dance

---
 INSTALL | 39 ++++++++++++++++++++++++++++++++++++---
 1 file changed, 36 insertions(+), 3 deletions(-)

diff --git a/INSTALL b/INSTALL
index d3359ab..38b51b4 100644
--- a/INSTALL
+++ b/INSTALL
@@ -165,7 +165,40 @@ following line to your .bashrc or similar:
 
 export WINEDEBUG=fixme-all
 
-Keeping wineserver running seems to help with performance (especially
-for /E and /EP modes for some reason):
-
+Certain executions of the cl compiler (e.g., /EP /showIncludes) are very
+slow unless wineserver is started and a special voodoo dance is performed:
+
+# Kill existing Wine processes if any.
+#
+$ pkill wineserver
+$ pkill .exe
+
+# Verify no Wine processes are running.
+#
+$ pgrep wineserver
+$ pgrep .exe
+
+# Prepare test file.
+#
+cat > test.cpp
+#include <iostream>
+^D
+
+# Get time without wineserver.
+#
+$ time cl-NN /EP /showIncludes test.cpp >/dev/null
+
+# Start wineserver.
+#
 $ wineserver -p
+$ pgrep wineserver
+
+# The voodoo part: the first execution after starting wineserver will
+# hang, but all subsequent ones should be much faster.
+#
+$ cl-NN /EP /showIncludes test.cpp >/dev/null
+^C
+
+# Get time with wineserver.
+#
+$ time cl-NN /EP /showIncludes test.cpp >/dev/null
-- 
cgit v1.1