-# Older CMake (< 2.8.12)
-# SimGrid_INCLUDE_DIR - the SimGrid include directories
-# SimGrid_LIBRARY - link your simulator against it to use SimGrid
+# If this file does not find SimGrid, define SimGrid_PATH:
+# cmake -DSimGrid_PATH=/path/to/simgrid .
+
+#
+# DEVELOPERS OF PROGRAMS USING SIMGRID
+# ------------------------------------
+#
+# 1. Include this file in your own CMakeLists.txt (before defining any target)
+# Either by copying it in your tree, or (recommended) by using the
+# version automatically installed by SimGrid.
+#
+# 2. This will define a target called 'SimGrid::Simgrid'. Use it as:
+# target_link_libraries(your-simulator SimGrid::SimGrid)
+#
+# It also defines a SimGrid_VERSION macro, that you can use to deal with API
+# evolutions as follows: