c++11 rant
authorKonrad Rosenbaum <konrad@silmor.de>
Mon, 16 Jan 2012 21:24:29 +0000 (22:24 +0100)
committerKonrad Rosenbaum <konrad@silmor.de>
Mon, 16 Jan 2012 21:24:29 +0000 (22:24 +0100)
doc/build.html

index 29d730d..984f036 100644 (file)
@@ -7,25 +7,24 @@
 
 <h2>Supported Platforms</h2>
 
-<b>Linux</b> is supported for both client and server. It is originally developed on Debian, but should work out of the box on any other distribution that provides the necessary tools.<p>
+<b>Linux</b> is supported for both client and server. It is originally developed on Debian and Ubuntu, but should work out of the box on any other distribution that provides the necessary tools.<p>
 
-<b>Windows</b> is only supported for building the client. While I'm convinced that the server would be able to work on Windows, there is no automatic support for it - you're on your own here.<p>
+<b>Windows</b> is only supported for building the client. While I'm convinced that the server would be able to work on Windows, there is no automatic support for it and I never tested it - you're on your own here.<p>
 
-<b>MacOS/X</b> might be supported for building the client. As soon as C++11 is supported by it or someone figures out how to build a decent GCC on it (one that is both full GCC and has the special MAC options).<p>
+<b>MacOS/X</b> might be supported for building the client. As soon as C++11 is supported by it or someone figures out how to build a decent GCC on it (one that is both full GCC and has the special MacOS options).<p>
 
 <b>Other Unixoid systems</b> are untested, but should work just like Linux if you install the proper tools.<p>
 
 <h2>Prerequisites</h2>
 
 You need <a href="http://qt.nokia.com/downloads">Trolltech/Nokias Qt</a> Open Source edition
-version 4.7 or any newer. Qt is also needed to generate some code that the server relies upon - even though the server itself is written in PHP and does not need Qt at runtime.<p/>
+version 4.8 or any newer. Qt is also needed to generate some code that the server relies upon - even though the server itself is written in PHP and does not need Qt at runtime.<p/>
 
-You also need <a href="http://www.openssl.org/">OpenSSL</a> installed and Qt needs to be built with
-SSL-support. While the pure web-UI can run without SSL, it is highly recommended that you enable
-SSL for the complete server. The client insists on using SSL - it is not possible to connect the
-client to the server without it.<p/>
+You also need <a href="http://www.openssl.org/">OpenSSL</a> installed and Qt needs to be built with SSL-support. While the pure web-UI can run without SSL, it is highly recommended that you enable SSL for the complete server for security reasons. The client insists on using SSL - it is not possible to connect the client to the server without it.<p/>
 
-You need a C++ compiler that works with Qt and supports at least some features of C++11. I usually recommend GCC 4.5 or newer for Linux and other Unixoid systems and using the <a href="http://www.mingw.org/">MinGW</a> version that comes with the complete Qt SDK for Windows.  XCode will do fine for MacOS.<p/>
+You need a C++ compiler that works with Qt and supports at least some features of C++11. I usually recommend GCC 4.6 or newer for Linux and other Unixoid systems and using the newest stable version of <a href="http://www.mingw.org/">MinGW</a> for Windows.<p/>
+
+To make this point absolutely clear: I will not accept patches and ports that remove C++11 features, but I will accept patches that replace older constructs by cleaner ones that rely on C++11. My target compiler is the current stable version GCC. I do not test with LLVM, MSVC or any other compiler - so if your favorite compiler lacks C++11 features that GCC already implements: please let your compiler vendor know that you are disappointed. If I happen to use a feature that is not in the C++11 standard, let me know - I'll fix those.<p/>
 
 The source documentation needs <a href="http://www.doxygen.org/">Doxygen</a> in order to be built.