diff --git a/3rdparty/README.md b/3rdparty/README.md
--- a/3rdparty/README.md
+++ b/3rdparty/README.md
@@ -1,234 +1,353 @@
-= CMake external projects to build krita's dependencies on Linux, Windows or OSX =
+# CMake external projects to build krita's dependencies on Linux, Windows or OSX
 
 If you need to build Krita's dependencies for the following reasons:
 
-* you develop on Windows and aren't using Emerge
-* you develop on OSX and aren't using Homebrew
-* you want to build a generic, distro-agnostic version of Krita for Linux
-* you develop on Linux, but some dependencies aren't available for your distribution
+* You develop on Windows and aren't using Emerge;
+* You develop on OSX and aren't using Homebrew;
+* You want to build a generic, distro-agnostic version of Krita for Linux;
+* You develop on Linux, but some dependencies aren't available for your
+  distribution;
 
-and you know what you're doing, you can use the following guide to build
-the dependencies that Krita needs.
+and you know what you're doing, you can use the following guide to build the
+dependencies that Krita needs.
 
 If you develop on Linux and your distribution has the dependencies available,
+__YOU DO NOT NEED THIS GUIDE AND YOU SHOULD STOP READING NOW__, otherwise you
+risk major confusion.
 
-YOU DO NOT NEED THIS GUIDE AND YOU SHOULD STOP READING NOW
+## Prerequisites
 
-Otherwise you risk major confusion.
+Note: on all operating systems the entire procedure is done in a terminal
+window.
 
-== Prerequisites ==
-
-Note: on all operating systems the entire procedure is done in a terminal window.
-
-1. git: https://git-scm.com/downloads. Make sure git is in your path
-2. cmake 3.3.2: https://cmake.org/download/. Make sure cmake is in your path.
+1. [Git](https://git-scm.com/downloads). Make sure `git` is in your path;
+2. [CMake 3.3.2](https://cmake.org/download/). Make sure `cmake` is in your
+   path;
 3. Make sure you have a compiler:
-    * Linux: gcc, minimum version 4.8
-    * OSX: clang, you need to install xcode for this
-    * Windows: (http://tdm-gcc.tdragon.net/, version 5.1). MSVC cannot build G'Mic correctly. Remember to install the OpenMP plugin in tdm-gcc. Make sure mingw's bin folder is in your path.
-4. If you compile Qt on Windows, you will also need Python: https://www.python.org. Make sure to have python.exe in your path.
-
-== Setup your environment ==
-
-
-== Prepare your directory layout ==
-
-1. Make a toplevel build directory, say $HOME/dev or c:\dev. We'll refer to this directory as BUILDROOT. You can use a variable for this, on WINDOWS %BUILDROOT%, on OSX and Linux $BUILDROOT. You will have to replace BUILDROOT with $BUILDROOT or %BUILDROOT whenever you copy and paste a command, depending on your operating system.
-
-2. Checkout krita in BUILDROOT
-    cd BUILDROOT
-    git clone git://anongit.kde.org/krita.git
-3. Create the build directory
-    mkdir BUILDROOT/b
-4. Create the downloads directory
-    mkdir BUILDROOT/d
-5. Create the install directory
-    mkdir BUILDROOT/i
-
-== Prepare the externals build ==
-
-1. enter the BUILDROOT/b directory
-2. run cmake:
-
-    * Linux:
-    export PATH=$BUILDROOT/i/bin
-    cmake ../krita/3rdparty \
-        -DINSTALL_ROOT=$BUILDROOT/i \
-        -DEXTERNALS_DOWNLOAD_DIR=$BUILDROOT/d \
-        -DCMAKE_INSTALL_PREFIX=BUILDROOT/i
-
-    * OSX:
-    
-    export PATH=$BUILDROOT/i/bin
-    cmake ../krita/3rdparty/  \
-        -DCMAKE_INSTALL_PREFIX=$BUILDROOT/i \
-        -DEXTERNALS_DOWNLOAD_DIR=$BUILDROOT/d  \
-        -DINSTALL_ROOT=$BUILDROOT/i 
-
-
-    * Windows 32 bits:
-    
-    TODO
-
-    * Windows 64 bits:
-
-Note that the cmake command needs to point to your BUILDROOT like /dev/d, not c:\dev\d.
-
-    set PATH=BUILDROOT\i\bin\;BUILDROOT\i\lib;%PATH%
-    cmake ..\krita\3rdparty -DEXTERNALS_DOWNLOAD_DIR=/dev/d -DINSTALL_ROOT=/dev/i  -G "MinGW Makefiles"
-
-3. build the packages:
-
-With a judicious application of DEPENDS statements, it's possible to build it all in one go, but in my experience that fails always, so it's better to build the dependencies independently.
-
-On Windows:
-
-    cmake --build . --config RelWithDebInfo --target ext_patch
-    cmake --build . --config RelWithDebInfo --target ext_png2ico
-    cmake --build . --config RelWithDebInfo --target ext_gettext
-    
-On all operating systems:
-
-    cmake --build . --config RelWithDebInfo --target ext_qt
-    cmake --build . --config RelWithDebInfo --target ext_zlib
-    cmake --build . --config RelWithDebInfo --target ext_boost
-
-	Note about boost: check if the headers are installed into i/include/boost, but not into i/include/boost-1.61/boost
-
-    cmake --build . --config RelWithDebInfo --target ext_eigen3
-    cmake --build . --config RelWithDebInfo --target ext_exiv2
-    cmake --build . --config RelWithDebInfo --target ext_fftw3
-    
-On Windows:
-
-    set FFTW_LIB_DIR=%BUILDROOT%\i\lib
-    dlltool.exe -k --output-lib %FFTW_LIB_DIR%\libfftw3-3.a --input-def %FFTW_LIB_DIR%\libfftw3-3.def
-    dlltool.exe -k --output-lib %FFTW_LIB_DIR%\libfftw3f-3.a --input-def %FFTW_LIB_DIR%\libfftw3f-3.def
-    dlltool.exe -k --output-lib %FFTW_LIB_DIR%\libfftw3l-3.a --input-def %FFTW_LIB_DIR%\libfftw3l-3.def
-
-On all operating systems
-    
-    cmake --build . --config RelWithDebInfo --target ext_ilmbase
-    cmake --build . --config RelWithDebInfo --target ext_jpeg
-    cmake --build . --config RelWithDebInfo --target ext_lcms2
-    cmake --build . --config RelWithDebInfo --target ext_ocio
-    cmake --build . --config RelWithDebInfo --target ext_openexr
-
-Note for OSX:
-
-On OSX, you need to first build openexr; that will fail; then you need to set the rpath for the two utilities correctly, then try to build openexr again.
-
-    install_name_tool -add_rpath $BUILD_ROOT/i/lib $BUILD_ROOT/b/ext_openexr/ext_openexr-prefix/src/ext_openexr-build/IlmImf/./b44ExpLogTable
-    install_name_tool -add_rpath $BUILD_ROOT/i/lib $BUILD_ROOT/b/ext_openexr/ext_openexr-prefix/src/ext_openexr-build/IlmImf/./dwaLookups
-
-On All operating systems:
-
-    cmake --build . --config RelWithDebInfo --target ext_png
-    cmake --build . --config RelWithDebInfo --target ext_tiff
-    cmake --build . --config RelWithDebInfo --target ext_gsl
-    cmake --build . --config RelWithDebInfo --target ext_vc
-    cmake --build . --config RelWithDebInfo --target ext_libraw
-
-On Windows
-
-    cmake --build . --config RelWithDebInfo --target ext_freetype
-    cmake --build . --config RelWithDebInfo --target ext_poppler
-
-On Linux
-
-    cmake --build . --config RelWithDebInfo --target ext_kcrash
-
-Everywhere else:
-
-    cmake --build . --config RelWithDebInfo --target ext_kwindowsystem
-
-On Windows, if you want to include DrMingw for dumping backtrace on crash:
-
-    cmake --build . --config RelWithDebInfo --target ext_drmingw
-
-Note: poppler should be buildable on Linux as well with a home-built freetype
-and fontconfig, but I don't know how to make fontconfig find freetype, and on
-Linux, fontconfig is needed for poppler. Poppler is needed for PDF import.
 
-Note 2: libcurl still isn't available.
-
-Note 3: if you want to build a release, you need to get the binary gettext
-archives from files.kde.org/krita/build/dependencies:
-
-  http://files.kde.org/krita/build/dependencies/gettext0.19.8.1-iconv1.14-shared-32.zip
-  http://files.kde.org/krita/build/dependencies/gettext0.19.8.1-iconv1.14-shared-64.zip
-
-Take care, these zips contain a libstdc++-6.dll that you don't want in your path when building.
-
-== Build Krita ==
+   * Linux: gcc, minimum version 4.8
+   * OSX: clang, you need to install Xcode for this
+   * Windows: [tdm-gcc](http://tdm-gcc.tdragon.net/), version 5.1. MSVC cannot
+     build G'Mic correctly. Remember to install the OpenMP plugin in tdm-gcc.
+     Make sure mingw's bin folder is in your path.
+4. If you compile Qt on Windows, you will also need
+   [Python](https://www.python.org). Make sure to have `python.exe` in your
+   path.
+
+## Linux
+
+### Prepare your directory layout
+
+Make a toplevel build directory, say `$HOME/dev`. We'll refer to this directory
+as `BUILD_ROOT`. The simplest way to handle this is to create an environment
+variable
+```
+export BUILD_ROOT=path/to/your/build/directory
+```
+
+Then clone krita in `$BUILD_ROOT`:
+```
+cd $BUILD_ROOT
+git clone git://anongit.kde.org/krita.git
+```
+
+Finally, create three folders:
+```
+mkdir $BUILD_ROOT/b $BUILD_ROOT/d $BUILD_ROOT/i
+```
+which will contain the build, downloads and install files respectively.
+
+### Prepare the externals build
+
+Next run CMake
+```
+cd $BUILD_ROOT/b
+export PATH=$BUILD_ROOT/i/bin
+cmake ../krita/3rdparty \
+    -DINSTALL_ROOT=$BUILD_ROOT/i \
+    -DEXTERNALS_DOWNLOAD_DIR=$BUILD_ROOT/d \
+    -DCMAKE_INSTALL_PREFIX=$BUILD_ROOT/i
+```
+
+### Build the packages
+
+Note that this step can take some time, depending on your environment. Also, if
+you obtain a problem, make sure to take a look at the remarks below:
+```
+cmake --build . --config RelWithDebInfo --target ext_qt
+cmake --build . --config RelWithDebInfo --target ext_zlib
+cmake --build . --config RelWithDebInfo --target ext_boost
+cmake --build . --config RelWithDebInfo --target ext_eigen3
+cmake --build . --config RelWithDebInfo --target ext_exiv2
+cmake --build . --config RelWithDebInfo --target ext_fftw3
+cmake --build . --config RelWithDebInfo --target ext_ilmbase
+cmake --build . --config RelWithDebInfo --target ext_jpeg
+cmake --build . --config RelWithDebInfo --target ext_lcms2
+cmake --build . --config RelWithDebInfo --target ext_ocio
+cmake --build . --config RelWithDebInfo --target ext_openexr
+cmake --build . --config RelWithDebInfo --target ext_png
+cmake --build . --config RelWithDebInfo --target ext_tiff
+cmake --build . --config RelWithDebInfo --target ext_gsl
+cmake --build . --config RelWithDebInfo --target ext_vc
+cmake --build . --config RelWithDebInfo --target ext_libraw
+cmake --build . --config RelWithDebInfo --target ext_kcrash
+cmake --build . --config RelWithDebInfo --target ext_kwindowsystem
+```
+
+#### Remarks
+
+1. boost: check if the headers are installed into `i/include/boost`, but
+   not into `i/include/boost-1.61/boost`.
+2. poppler: it should be buildable as well with a home-built freetype and
+   fontconfig:
+   ```
+   cmake --build . --config RelWithDebInfo --target ext_poppler
+   ```
+   However, I don't know how to make fontconfig find freetype, and on Linux,
+   fontconfig is needed for poppler. Poppler is needed for PDF import.
+3. libcurl: still isn't available.
+
+### Building Krita
  
-1. Make a krita build directory: 
-    mkdir BUILDROOT/build
-2. Enter the BUILDROOT/build
-3. Run 
-
-On Windows
+Make a directory for the build:
+```
+mkdir $BUILD_ROOT/build
+cd $BUILD_ROOT/build
+```
+
+Then:
+```
+cmake ../krita -DCMAKE_INSTALL_PREFIX=$BUILD_ROOT/i -DDEFINE_NO_DEPRECATED=1 -DPACKAGERS_BUILD=ON -DBUILD_TESTING=OFF -DKDE4_BUILD_TESTS=OFF -DCMAKE_BUILD_TYPE=RelWithDebInfobg
+make
+make install
+```
+
+### Running Krita
+
+The executable can be found in
+```
+$BUILD_ROOT/i/bin/krita
+```
+   
+## Windows
+
+### Prepare your directory layout
+
+Make a toplevel build directory, say `c:\dev`. We'll refer to this directory as
+`BUILD_ROOT`. The simplest way to handle this is to create an environment
+variable
+```
+set BUILD_ROOT=path/to/your/build/directory
+```
+
+Then clone krita in `%BUILD_ROOT%`:
+```
+cd %BUILD_ROOT%
+git clone git://anongit.kde.org/krita.git
+```
+
+Finally, create three folders:
+```
+mkdir %BUILD_ROOT%/b %BUILD_ROOT%/d %BUILD_ROOT%/i
+```
+which will contain the build, downloads and install files respectively.
+
+### Prepare the externals build
+
+Next run CMake
+```
+cd %BUILD_ROOT%/b
+set PATH=%BUILD_ROOT%\i\bin\;%BUILD_ROOT%\i\lib;%PATH%
+cmake ..\krita\3rdparty -DEXTERNALS_DOWNLOAD_DIR=%BUILD_ROOT%/d -DINSTALL_ROOT=%BUILD_ROOT%/i  -G "MinGW Makefiles"
+```
+
+### Build the packages
+
+Note that this step can take some time, depending on your environment. Also, if
+you obtain a problem, make sure to take a look at the remarks below:
+```
+cmake --build . --config RelWithDebInfo --target ext_patch
+cmake --build . --config RelWithDebInfo --target ext_png2ico
+cmake --build . --config RelWithDebInfo --target ext_gettext
+cmake --build . --config RelWithDebInfo --target ext_qt
+cmake --build . --config RelWithDebInfo --target ext_zlib
+cmake --build . --config RelWithDebInfo --target ext_boost
+cmake --build . --config RelWithDebInfo --target ext_eigen3
+cmake --build . --config RelWithDebInfo --target ext_exiv2
+cmake --build . --config RelWithDebInfo --target ext_fftw3
+set FFTW_LIB_DIR=%BUILD_ROOT%\i\lib
+dlltool.exe -k --output-lib %FFTW_LIB_DIR%\libfftw3-3.a --input-def %FFTW_LIB_DIR%\libfftw3-3.def
+dlltool.exe -k --output-lib %FFTW_LIB_DIR%\libfftw3f-3.a --input-def %FFTW_LIB_DIR%\libfftw3f-3.def
+dlltool.exe -k --output-lib %FFTW_LIB_DIR%\libfftw3l-3.a --input-def %FFTW_LIB_DIR%\libfftw3l-3.def
+cmake --build . --config RelWithDebInfo --target ext_ilmbase
+cmake --build . --config RelWithDebInfo --target ext_jpeg
+cmake --build . --config RelWithDebInfo --target ext_lcms2
+cmake --build . --config RelWithDebInfo --target ext_ocio
+cmake --build . --config RelWithDebInfo --target ext_openexr
+cmake --build . --config RelWithDebInfo --target ext_png
+cmake --build . --config RelWithDebInfo --target ext_tiff
+cmake --build . --config RelWithDebInfo --target ext_gsl
+cmake --build . --config RelWithDebInfo --target ext_vc
+cmake --build . --config RelWithDebInfo --target ext_libraw
+cmake --build . --config RelWithDebInfo --target ext_freetype
+cmake --build . --config RelWithDebInfo --target ext_poppler
+cmake --build . --config RelWithDebInfo --target ext_kwindowsystem
+cmake --build . --config RelWithDebInfo --target ext_drmingw
+```
+
+#### Remarks
+
+1. boost: check if the headers are installed into `i/include/boost`, but
+   not into `i/include/boost-1.61/boost`.
+2. libcurl: still isn't available.
+
+### Building Krita
+ 
+Make a directory for the build:
+```
+mkdir %BUILD_ROOT%/build
+cd %BUILD_ROOT%/build
+```
 
 Depending on what you want to use, run this command for MSBuild: 
+```
+cmake ..\krita -G "MinGW Makefiles" -DBoost_DEBUG=OFF -DBOOST_INCLUDEDIR=%BUILD_ROOT%\i\include -DBOOST_DEBUG=ON -DBOOST_ROOT=%BUILD_ROOT%\i -DBOOST_LIBRARYDIR=%BUILD_ROOT%\i\lib -DCMAKE_INSTALL_PREFIX=%BUILD_ROOT%\i -DCMAKE_PREFIX_PATH=%BUILD_ROOT%\i -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_TESTING=OFF -DKDE4_BUILD_TESTS=OFF -DHAVE_MEMORY_LEAK_TRACKER=OFF -DPACKAGERS_BUILD=ON -Wno-dev -DDEFINE_NO_DEPRECATED=1
+cmake --build . --config RelWithDebInfo --target INSTALL -- /m
+```
+or this to use jom (faster compiling, uses all cores, ships with
+QtCreator/pre-built Qt binaries, but you might have to replace jom's path with
+another one according to your installation):
+```
+cmake ..\krita -G "MinGW Makefiles" -DBoost_DEBUG=OFF -DBOOST_INCLUDEDIR=%BUILD_ROOT%\i\include -DBOOST_DEBUG=ON -DBOOST_ROOT=%BUILD_ROOT%\i -DBOOST_LIBRARYDIR=%BUILD_ROOT%\i\lib -DCMAKE_INSTALL_PREFIX=%BUILD_ROOT%\i -DCMAKE_PREFIX_PATH=%BUILD_ROOT%\i -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_TESTING=OFF -DKDE4_BUILD_TESTS=OFF -DHAVE_MEMORY_LEAK_TRACKER=OFF -DPACKAGERS_BUILD=ON -Wno-dev -DDEFINE_NO_DEPRECATED=1
+"C:\Qt\Qt5.6.0\Tools\QtCreator\bin\jom.exe" install
+```
+
+If you want to create a stripped down version of Krita to distribute, after
+building everything just copy the `makepkg.bat` file from the `windows` folder
+inside krita root source folder to `%BUILD_ROOT%` and run it. That will copy
+the necessary files into the specified folder and leave behind developer
+related files, so the resulting folder will be a smaller install folder.
+
+Also, if you want to build a release, you need to get the binary gettext
+archives from files.kde.org/krita/build/dependencies:
 
-    cmake ..\krita -G "MinGW Makefiles" -DBoost_DEBUG=OFF -DBOOST_INCLUDEDIR=c:\dev\i\include -DBOOST_DEBUG=ON -DBOOST_ROOT=c:\dev\i -DBOOST_LIBRARYDIR=c:\dev\i\lib -DCMAKE_INSTALL_PREFIX=c:\dev\i -DCMAKE_PREFIX_PATH=c:\dev\i -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_TESTING=OFF -DKDE4_BUILD_TESTS=OFF -DHAVE_MEMORY_LEAK_TRACKER=OFF -DPACKAGERS_BUILD=ON -Wno-dev -DDEFINE_NO_DEPRECATED=1
-
-Or this to use jom (faster compiling, uses all cores, ships with QtCreator/pre-built Qt binaries):
-
-    cmake ..\krita -G "MinGW Makefiles" -DBoost_DEBUG=OFF -DBOOST_INCLUDEDIR=c:\dev\i\include -DBOOST_DEBUG=ON -DBOOST_ROOT=c:\dev\i -DBOOST_LIBRARYDIR=c:\dev\i\lib -DCMAKE_INSTALL_PREFIX=c:\dev\i -DCMAKE_PREFIX_PATH=c:\dev\i -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_TESTING=OFF -DKDE4_BUILD_TESTS=OFF -DHAVE_MEMORY_LEAK_TRACKER=OFF -DPACKAGERS_BUILD=ON -Wno-dev -DDEFINE_NO_DEPRECATED=1
-
-On Linux
-
-    cmake ../krita -DCMAKE_INSTALL_PREFIX=BUILDROOT/i -DDEFINE_NO_DEPRECATED=1 -DPACKAGERS_BUILD=ON -DBUILD_TESTING=OFF -DKDE4_BUILD_TESTS=OFF -DCMAKE_BUILD_TYPE=RelWithDebInfobg
-
-On OSX
-
-    cmake ../krita -DCMAKE_INSTALL_PREFIX=$BUILDROOT/i -DDEFINE_NO_DEPRECATED=1 -DBUILD_TESTING=OFF -DKDE4_BUILD_TESTS=OFF -DPACKAGERS_BUILD=ON  -DBUNDLE_INSTALL_DIR=$BUILDROOT/i/bin -DCMAKE_BUILD_TYPE=RelWithDebInfo
-
-
-4. Run 
-
-On Linux and OSX
-
-    make
-    make install
-
-On Windows
-
-    Either use MSBuild to build (-- /m tells msbuild to use all your cores):
-
-    cmake --build . --config RelWithDebInfo --target INSTALL -- /m
-
-    Or use jom which should be in a path similar to C:\Qt\Qt5.6.0\Tools\QtCreator\bin\jom.exe.
-    So, from the same folder, instead of running cmake run:
-
-    "C:\Qt\Qt5.6.0\Tools\QtCreator\bin\jom.exe" install
-
-6. Run krita:
-
-On Linux
-
-    BUILDROOT/i/bin/krita
-
-On Windows
-
-    BUILDROOT\i\bin\krita.exe
-
-On OSX
-
-    BUILDROOT/i/bin/krita.app/Contents/MacOS/krita
-
-== Packaging a Windows Build ==
-
-If you want to create a stripped down version of Krita to distribute, after building everything just copy the makepkg.bat file from the "windows" folder inside krita root source folder to BUILDROOT and run it.
-
-That will copy the necessary files into the specified folder and leave behind developer related files, so the resulting folder will be a smaller install folder.
-
-== Common Issues ==
-
-- On Windows, if you get a 'mspdb140.dll' missing alert window, it means you did not run the bat file. Make sure to include the quotes in the command:
+- http://files.kde.org/krita/build/dependencies/gettext0.19.8.1-iconv1.14-shared-32.zip
+- http://files.kde.org/krita/build/dependencies/gettext0.19.8.1-iconv1.14-shared-64.zip
+
+Be careful, these zips contain a `libstdc++-6.dll` that you don't want in your
+path when building.
+
+### Running Krita
+
+The executable can be found in
+```
+%BUILD_ROOT%\i\bin\krita.exe
+```
+
+## OSX
+
+### Prepare your directory layout
+
+Make a toplevel build directory, say `$HOME/dev`. We'll refer to this directory
+as `BUILD_ROOT`. The simplest way to handle this is to create an environment
+variable
+```
+export BUILD_ROOT=path/to/your/build/directory
+```
+
+Then clone krita in `$BUILD_ROOT`:
+```
+cd $BUILD_ROOT
+git clone git://anongit.kde.org/krita.git
+```
+
+Finally, create three folders:
+```
+mkdir $BUILD_ROOT/b $BUILD_ROOT/d $BUILD_ROOT/i
+```
+which will contain the build, downloads and install files respectively.
+
+### Prepare the externals build
+
+Next run CMake
+```
+cd $BUILD_ROOT/b
+export PATH=$BUILD_ROOT/i/bin
+cmake ../krita/3rdparty/  \
+    -DCMAKE_INSTALL_PREFIX=$BUILD_ROOT/i \
+    -DEXTERNALS_DOWNLOAD_DIR=$BUILD_ROOT/d  \
+    -DINSTALL_ROOT=$BUILD_ROOT/i 
+```
+
+### Build the packages
+
+Note that this step can take some time, depending on your environment. Also, if
+you obtain a problem, make sure to take a look at the remarks below:
+```
+cmake --build . --config RelWithDebInfo --target ext_qt
+cmake --build . --config RelWithDebInfo --target ext_zlib
+cmake --build . --config RelWithDebInfo --target ext_boost
+cmake --build . --config RelWithDebInfo --target ext_eigen3
+cmake --build . --config RelWithDebInfo --target ext_exiv2
+cmake --build . --config RelWithDebInfo --target ext_fftw3
+cmake --build . --config RelWithDebInfo --target ext_ilmbase
+cmake --build . --config RelWithDebInfo --target ext_jpeg
+cmake --build . --config RelWithDebInfo --target ext_lcms2
+cmake --build . --config RelWithDebInfo --target ext_ocio
+cmake --build . --config RelWithDebInfo --target ext_openexr
+cmake --build . --config RelWithDebInfo --target ext_png
+cmake --build . --config RelWithDebInfo --target ext_tiff
+cmake --build . --config RelWithDebInfo --target ext_gsl
+cmake --build . --config RelWithDebInfo --target ext_vc
+cmake --build . --config RelWithDebInfo --target ext_libraw
+cmake --build . --config RelWithDebInfo --target ext_kwindowsystem
+```
+
+#### Remarks
+
+1. boost: check if the headers are installed into `i/include/boost`, but not
+   into `i/include/boost-1.61/boost`.
+2. openexr: sometimes, the build fails. If it is the case, then you might try
+   setting the rpath for the two utilities correctly, then try to build openexr
+   again:
+   ```
+   install_name_tool -add_rpath $BUILD_ROOT/i/lib $BUILD_ROOT/b/ext_openexr/ext_openexr-prefix/src/ext_openexr-build/IlmImf/./b44ExpLogTable
+   install_name_tool -add_rpath $BUILD_ROOT/i/lib $BUILD_ROOT/b/ext_openexr/ext_openexr-prefix/src/ext_openexr-build/IlmImf/./dwaLookups
+   ```
+3. libcurl: still isn't available.
+
+### Building Krita
+ 
+Make a directory for the build:
+```
+mkdir $BUILD_ROOT/build
+cd $BUILD_ROOT/build
+```
+
+Then:
+```
+cmake ../krita -DCMAKE_INSTALL_PREFIX=$BUILD_ROOT/i -DDEFINE_NO_DEPRECATED=1 -DBUILD_TESTING=OFF -DKDE4_BUILD_TESTS=OFF -DPACKAGERS_BUILD=ON -DBUNDLE_INSTALL_DIR=$BUILD_ROOT/i/bin -DCMAKE_BUILD_TYPE=RelWithDebInfo
+make
+make install
+```
+
+### Running Krita
+
+The executable can be found in
+```
+$BUILD_ROOT/i/bin/krita.app/Contents/MacOS/krita
+```
+## Common Issues
+
+- On Windows, if you get a `mspdb140.dll` missing alert window, it means you
+  did not run the bat file. Make sure to include the quotes in the command:
+  ```
   "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\bin\amd64\vcvars64.bat"
-
-- On Windows, if you get an error about Qt5Core.dll missing/not found or nmake exit with an error that mention QT_PLUGIN_PATH, you have to copy a couple of dlls in the Qt build directory, look for the N.B. in the Qt instructions at the start of the Readme.
-
-- If you receive an error while compiling about "missing QtCore5.cmake", or something similar, check to make sure qmake is in your PATH. Restart your command line after any changes are made.
+  ```
+- On Windows, if you get an error about `Qt5Core.dll` missing/not found or
+  nmake exit with an error that mention `QT_PLUGIN_PATH`, you have to copy a
+  couple of dlls in the Qt build directory, look for the N.B. in the Qt
+  instructions at the start of the Readme.
+- If you receive an error while compiling about `missing QtCore5.cmake`, or
+  something similar, check to make sure qmake is in your `PATH`. Restart your
+  command line after any changes are made.