add osx/windows documents

2 files changed, 39 insertions, 0 deletions

diff --git a/docs/hacking/osx.rst b/docs/hacking/osx.rst
new file mode 100644
index 00000000..7accfc19
--- /dev/null
+++ b/docs/hacking/osx.rst
@@ -0,0 +1,24 @@
+.. _osx-dev:
+
+Setting up a development environment in OSX™
+============================================
+
+(work in progress)
+
+Make sure you're using a new enough version of pip (1.8 or newest).
+
+* Use ``brew`` to install ``OpenSSL``.
+
+* Use ``brew`` to install pyqt5::
+
+  brew install pyqt5 --with-python --without-python3
+
+  TODO:: --with-qt-webkit <<<< WORKS?
+
+  TODO:: Use PySide instead??
+
+Running OSX on KVM
+==================
+
+* https://github.com/kholia/OSX-KVM
+
diff --git a/docs/hacking/windows.rst b/docs/hacking/windows.rst
new file mode 100644
index 00000000..f9e2f8fe
--- /dev/null
+++ b/docs/hacking/windows.rst
@@ -0,0 +1,15 @@
+.. _win-dev:
+
+Setting up a development environment in Windows™
+================================================
+
+This document gathers notes to setup a development environment inside a virtual
+machine or a metal one. Tested with Windows 7.
+
+There is some work in progress, that was done initially by Paixu, for building
+the windows installers from within several docker containers running linux (see
+``pkg/windows/Readme.rst``.
+
+* Install ``git``
+* Install Microsoft Visual C++ Compiler for Python 2.7 https://aka.ms/vcpython27
+