initial commit

1 files changed, 37 insertions, 0 deletions

diff --git a/doc/compile-fixes.md b/doc/compile-fixes.md
new file mode 100644
index 0000000..0e7593a
--- /dev/null
+++ b/doc/compile-fixes.md
@@ -0,0 +1,37 @@
+Visual studio unsupported platform toolset
+---------------------
+To fix the ```Error MSB8036 The Windows SDK version 5.1 was not found. Install the required version of Windows SDK or change the SDK version in the project property pages or by right-clicking the solution and selecting "Retarget solution"```
+* Right click **ClassiCube** project (it's under the *Solution 'ClassiCube'* in the *Solution Explorer* pane)
+* Click **Properties**
+* Make sure you are in **General** tab under **Configuration Properties**
+* You should see a dropdown named **Platform Toolset**. Click on it.
+* Change it to one of the toolsets in the list that pops up.
+* Click **OK**. You should be able to compile now
+
+![image](https://user-images.githubusercontent.com/6509348/60266950-727e4780-992c-11e9-98fb-85eb34959e93.png)
+
+Common compilation errors
+---------------------
+#### Undefined reference to 'clock_gettime'
+Add ```-lrt``` when compiling. Occurs when using glibc versions before 2.17.
+
+#### fatal error: execinfo.h: No such file or directory
+Define `CC_BACKTRACE_BUILTIN` when compiling. Usually occurs when using musl.
+
+#### Undefined reference to 'backtrace'
+Define `CC_BACKTRACE_BUILTIN` when compiling. Usually occurs when using musl.
+
+Webclient patches
+---------------------
+#### Mouse scrolling not properly prevented
+With recent chrome/firefox versions, page is still scrolled and console is spammed with\
+```"[Intervention] Unable to preventDefault inside passive event listener due to target being treated as passive."```
+
+You need to to register events as a passive handler. Look for something like:
+```
+eventHandler.target.addEventListener(eventHandler.eventTypeString, jsEventHandler, eventHandler.useCapture);
+```
+and change to 
+```
+eventHandler.target.addEventListener(eventHandler.eventTypeString, jsEventHandler, { useCapture: eventHandler.useCapture, passive: false });
+```