1 files changed, 39 insertions, 0 deletions
diff --git a/src/boost/libs/gil/example/cmake/README.md b/src/boost/libs/gil/example/cmake/README.md
new file mode 100644
index 000000000..d66758073
--- /dev/null
+++ b/src/boost/libs/gil/example/cmake/README.md
@@ -0,0 +1,39 @@
+# CMake Configuration Examples
+
+Examples of configuration files for CMake integrations in popular IDEs are provided
+for convenience of users and contributors who wish to build, run and debug
+Boost.GIL tests and examples in the IDEs of their choice.
+
+## Visual Studio
+
+Example [CMakeSettings.json](CMakeSettings.json) file is provided for
+the [CMake support in Visual Studio](https://go.microsoft.com//fwlink//?linkid=834763).
+
+Currently, the `CMakeSettings.json` provides configurations for the following
+CMake generators:
+- Ninja (default)
+- Visual Studio 2017 and 2019
+- `Unix Makefiles` targeting Windows Subsystem for Linux (WSL) - requires Visual Studio 2019 IDE.
+
+Usage:
+
+1. Copy [CMakeSettings.json](CMakeSettings.json) to `${BOOST_ROOT}/libs/gil`.
+2. In Visual Studio > File > Open > Folder... and select `${BOOST_ROOT}/libs/gil`.
+3. Follow the [CMake support in Visual Studio](https://go.microsoft.com//fwlink//?linkid=834763) documentation.
+4. [CMakeSettings.json schema reference](https://docs.microsoft.com/en-us/cpp/build/cmakesettings-reference?view=vs-2017)
+   to learn more about the configuration file itself.
+
+Optionally, edit [CMakeSettings.json](CMakeSettings.json) and tweak any options you require.
+
+## Visual Studio Code
+
+Example of [cmake-variants.yaml](cmake-variants.yaml) file is provided for
+the [CMake Tools](https://github.com/vector-of-bool/vscode-cmake-tools) extension.
+
+Usage:
+
+1. Copy [cmake-variants.yaml](cmake-variants.yaml) to `${BOOST_ROOT}/libs/gil`.
+2. Run `code ${BOOST_ROOT}/libs/gil` and the set of variants will be loaded.
+3. Follow the [CMake Tools documentation](https://vector-of-bool.github.io/docs/vscode-cmake-tools/index.html).
+
+Optionally, edit [cmake-variants.yaml](cmake-variants.yaml)and tweak any options you require.