Issue 2599, 2940 - Fix the presence of correct ATL version

README.md

Index: README.md
diff --git a/README.md b/README.md
index d25ecf0853a3e57f83c044c2372862a02b963a35..945473a1e2788821eb2fc7120de4a968eb7dd952 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,42 @@ Adblock Plus for Internet Explorer
 This combines a Browser Helper Object with a singleton engine process to block
 ads in Internet Explorer. The engine process embeds libadblockplus.
 
+Requirements to work with the repository and the code
+-----------------------------------------------------
+
+### Python
+You need to have installed python 2+ (tested with python 2.7). It should be

[Oleksandr, 2015/12/02 20:24:28]

Since we are going with this verbose documentation we should also state that we
don't support python 3.

[sergei, 2015/12/02 21:14:12]

It seems we are say exactly python 2.7 in other "readme" files, I've changed it
to that variant.

+the version available by default from Visual Studio as well as in your
+command line environment. Simply put, make sure that path to `python.exe` is in
+your `PATH` environment variable.
+
+### Visual C++ toolset
+There should be available v110 and v110_xp toolsets. For instance, they are
+contained in freely available Visual Studio 2012 Express for Windows Desktop
+and in any paid edition of Visual Studio 2012. Take into account that you might
+need to get the recent updates of mentioned editions, more details about
+v110_xp https://msdn.microsoft.com/en-us/library/jj851139.aspx.
+
+### ATL versions
+It works with ATL shipped with any paid edition of Visual Studio 2012 as well
+as with ATL shipped with Visual Studio 2013 Community edition.
+If you use Visual Studio 2013 Community Edition as the source of ATL then set
+`ADBLOCKPLUS_ATL` environment variable to the directory of the corresponding

[Eric, 2015/12/02 15:10:49]

That's a much better environment variable name. Won't collide with anything
else.

+ATL (e.g, `C:\Program Files (x86)\Microsoft Visual Studio 12.0\VC\atlmfc`)
+Attention:
+- ATL is not shipped with Express edition of any Visual Studio.
+- ATL from Visual Studio 2015 is not supported.
+More information about libraies and headers in Visual Studios:
+2015 - https://msdn.microsoft.com/en-us/library/hs24szh9(v=vs.140).aspx
+2013 - https://msdn.microsoft.com/en-us/library/hs24szh9(v=vs.120).aspx
+2012 - https://msdn.microsoft.com/en-us/library/hs24szh9(v=vs.110).aspx
+
+### Visual Studio as an IDE
+Currently the project configured to work with MS Visual Studio 2012 as an IDE
+because the main development and release builds are in Visual Studio 2012.
+However one can also use any higher version of Visual Studio as and IDE, the
+caveat is to disable "Upgrade C++ Compilers and Libraries".

[Eric, 2015/12/02 15:10:49]

Strictly speaking, you can't disable the upgrade (or if there is I can't find
it). What you do is simply avoid upgrading them. It's a minor point, and it's
accurate enough for the time being.

+
 Getting/updating the dependencies
 ---------------------------------
 
@@ -16,9 +52,13 @@ you can also manually update them by running the following:
 Building
 --------
 
-You need Microsoft Visual C++ 2012 and Python 2.7. Make sure that `python.exe` 
-is on your `PATH`. Unfortunately until we move to Visual Studio 2013  you'll
-need to use Visual Studio 2012 version that comes with ATL (Proffessional etc). 
+Building is tested on the following configurations
+- [free for everybody] "Microsoft Visual Studio Express 2012 for Windows
+Desktop" as the source of toolset with "Microsoft Visual Studio Community 2013"
+as the source of ATL. Pay attention to the configuring of the environment
+described in "ATL versions" section.

[Eric, 2015/12/02 15:10:49]

Good. It matters here and not the ones below.

+- "Microsoft Visual Studio Professional 2012"
+- "Microsoft Visual Studio Ultimate 2012"
 
 * Execute `createsolution.bat` to retrieve dependencies and generate project
 files, this will create `build\ia32\adblockplus.sln` (solution for the 32 bit