Fixed gitignore and added building.md (#737)

.gitignore

@@ -30,8 +30,8 @@ moc_*.cpp
 qrc_*.cpp
 moc_*.h
 ui_*.h
-build*
-cmake-build-*
+build*/
+cmake-build-*/
 
 # QtCreator
 *.autosave

docs/.gitignore

@@ -1,4 +1,4 @@
-_site
+_site/
 .sass-cache
 .jekyll-metadata
 Gemfile.lock

docs/building.md

@@ -0,0 +1,116 @@
+# Building
+
+The "official" way to build Cutter is by using qmake, but there are two alternatives, such as cmake and meson.
+In any case, there are obviously some requirements:
+* Radare2 installed from submodule, see [README.md](https://github.com/radareorg/cutter#requirements)
+* Qt 5.9 or above
+* Python3.6
+
+**Before compiling, note that we also provide binaries available for windows/linux/MacOS X [here](https://github.com/radareorg/cutter/releases).**
+
+## Building options
+
+Note that there are two major building options available:
+* `CUTTER_ENABLE_JUPYTER` is used to compile Cutter with bundled Python and Jupyter module
+* `CUTTER_ENABLE_QTWEBENGINE` is used to compile Cutter with bundled QtWebEngine (to ease jupyter console usage)
+
+# Building with Qmake
+
+## Requirements
+
+### Compiling on Linux / OsX
+
+The easy way is to simply run `./build.sh` from the root directory, and let the magic happen. The script will use qmake to build Cutter.
+
+If you want to manually use qmake, follow this steps:
+```sh
+mkdir build; cd build
+qmake ../src/Cutter.pro
+make
+cd ..
+```
+# Building with Cmake
+
+## Requirements
+* CMake >= 3.1
+
+## Building on Linux
+
+The root for CMake is in src/. In-source builds are **not allowed**, so you **must** run CMake from a separate directory:
+```
+cd src
+mkdir build
+cd build
+cmake ..
+```
+
+If all went well, you should now have a working Makefile in your build directory:
+```
+make
+```
+
+## Building on Windows
+
+Alternatively, on Windows you can run something like this (depending on your Cmake installation)
+```batch
+set CMAKE_PREFIX_PATH=c:\Qt\qt-5.6.2-msvc2013-x86\5.6\msvc2013\lib\cmake
+cd src
+mkdir build
+cd build
+cmake-gui ..
+```
+
+Click `Configure` and select `Visual Studio 14 2015` from the list. After configuration is done, click `Generate` and you can open `Cutter.sln` to compile the code as usual.
+
+## Troubleshooting
+
+> Cmake: qt development package not found
+
+Depending on how Qt installed (Distribution packages or using the Qt installer application), CMake may not be able to find it by itself if it is not in a common place. If that is the case, double check that the correct Qt version is installed. Locate its prefix (a directory containing bin/, lib/, include/, etc.) and specify it to CMake using `CMAKE_PREFIX_PATH` in the above process, e.g.:
+```
+rm CMakeCache.txt # the cache may be polluted with unwanted libraries found before
+cmake -DCMAKE_PREFIX_PATH=/opt/Qt/5.9.1/gcc_64 ..
+```
+
+> `ModuleNotFoundError` upon starting Cutter.
+
+This can be resolved by either:
+1. Disabling the optional jupyter support during building by modifying `build.sh` as follows:
+
+   * Uncomment `#QMAKE_CONF="CUTTER_ENABLE_JUPYTER=false CUTTER_ENABLE_QTWEBENGINE=false"`
+   * Comment out the prior empty `QMAKE_CONF=""`
+
+2. Or alternatively by installing the two python dependencies manually afterwards via:
+```
+pip3 install notebook jupyter_client
+```
+
+# Building with Meson (Windows)
+
+Additional requirements:
+
+* Visual Studio 2015 or Visual Studio 2017
+* Ninja build system
+* Meson build system
+
+Download and unpack [Ninja](https://github.com/ninja-build/ninja/releases) to the Cutter source root directory.
+
+Environment settings (example for x64 version):
+```batch
+:: Export MSVC variables
+CALL "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" x64
+:: Add qmake to PATH
+SET "PATH=C:\Qt\5.10.1\msvc2015_64\bin;%PATH%"
+:: Add Python to PATH
+SET "PATH=C:\Program Files\Python36;%PATH%" ``` 
+Install Meson:
+```batch
+python -m pip install meson
+```
+
+To compile Cutter run:
+```batch
+CALL prepare_r2.bat
+CALL build.bat
+```
+