Doc: Update supported platforms and build requirements

- Synchronize required versions of tools with Qt Creator 4.4, where
  applicable.
- List currently tested platforms.
- Move the instructions from the README to the Qbs Manual and add the
  URL to product documentation.

Task-number: QBS-1071
Change-Id: I5d710972bd6b686b18f02a1bd7db5e8356e09b7a
Reviewed-by: Jake Petroules <jake.petroules@qt.io>
Reviewed-by: Kai Koehne <kai.koehne@qt.io>

2 files changed, 40 insertions, 33 deletions

diff --git a/README b/README
index 54352a956..5c11c8465 100644
--- a/README
+++ b/README
@@ -2,35 +2,7 @@ Qbs
 ===
 Qbs is a cross-platform build tool.
 The project's homepage is http://wiki.qt.io/qbs
+Qbs product documentation is available at: http://doc.qt.io/qbs/index.html
 
-Supported Platforms
-===================
-
-Windows XP SP2 or later
-macOS 10.7 or later
-Linux (tested on Debian 6/7 and Ubuntu 13)
-
-Building the sources requires Qt 5.6.0 or later.
-
-Build Instructions
-==================
-Prerequisites:
-   * Qt 5.6.0 or later
-   * On Windows:
-     -  MinGW or Visual Studio
-   * On macOS: Xcode
-
-The installed toolchains have to match the one Qt was compiled with.
-
-You can build Qbs with
-
-    cd $SOURCE_DIRECTORY
-    qmake -r
-    make (or mingw32-make or nmake or jom, depending on your platform)
-
-Installation ("make install") is not needed. It is however possible, using
-
-    make install INSTALL_ROOT=$INSTALL_DIRECTORY
-
-You can also build and develop Qbs using Docker. For more information,
-see "Appendix A: Building Qbs" in the Qbs Manual.
+For more information about building Qbs from sources, see
+"Appendix A: Building Qbs" at: http://doc.qt.io/qbs/building-qbs.html.
diff --git a/doc/qbs.qdoc b/doc/qbs.qdoc
index 3185053ca..73d2e6929 100644
--- a/doc/qbs.qdoc
+++ b/doc/qbs.qdoc
@@ -339,9 +339,34 @@
 
     \title Appendix A: Building Qbs
 
+    \QBS can be \l{Installing}{installed from binary packages} or built from
+    sources, as described in this appendix. In addition, this appendix describes
+    how to use Docker images for developing \QBS.
+
+    \section1 Supported Platforms
+
+    \QBS can be installed and run on the following platforms:
+
+    \list
+        \li Windows 7, or later
+        \li Linux (tested on Debian 8 and 9, Ubuntu 16.04, OpenSuSE 13.2, and
+            Arch Linux)
+        \li macOS 10.7, or later
+    \endlist
+
     \section1 System Requirements
 
-    To build \QBS from the source, you need Qt 5.6.0, or later
+    To build \QBS from the source, you need:
+
+    \list
+        \li Qt 5.6.2, or later
+        \li Windows: MinGW with GCC 4.9 or Microsoft Visual Studio 2015,
+            or later
+        \li Linux: GCC 4.9, or later, or Clang 3.9.0, or later
+        \li macOS: Xcode 6.2, or later
+    \endlist
+
+    An installed toolchain has to match the one that Qt was compiled with.
 
     \section1 Building
 
@@ -351,6 +376,16 @@
         qmake -r qbs.pro && make
     \endcode
 
+    Depending on your platform, you might use \c mingw32-make, \c nmake, or
+    \c jom instead of \c make.
+
+    Installation by using \c {make install} is usually not needed. It is however
+    possible, by entering the following command.
+
+    \code
+        make install INSTALL_ROOT=$INSTALL_DIRECTORY
+    \endcode
+
     \section1 Configure Options
 
     \QBS recognizes the following qmake CONFIG options to customize the build:
@@ -368,7 +403,7 @@
                                         implies a dependency to the Qt GUI module.
     \endtable
 
-    \section1 Docker
+    \section1 Using Docker
 
     A set of Docker images for developing \QBS (which are maintained by the \QBS team) is available
     \l{https://hub.docker.com/u/qbsbuild/}{on Docker Hub}.