1 files changed, 27 insertions, 0 deletions
diff --git a/meson/docs/markdown/Build-system-converters.md b/meson/docs/markdown/Build-system-converters.md
new file mode 100644
index 000000000..1c0b4fc50
--- /dev/null
+++ b/meson/docs/markdown/Build-system-converters.md
@@ -0,0 +1,27 @@
+---
+short-description: Converting other build systems to Meson
+...
+
+# Build system converters
+
+Moving from one build system into another includes a fair bit of
+work. To make things easier, Meson provides scripts to convert other
+build systems into Meson. At the time of writing, scripts for CMake
+and autotools exist. It can be found in the `tools` subdirectory in
+Meson's source tree.
+
+The scripts do not try to do a perfect conversion. This would be
+extremely difficult because the data models of other build systems are
+very different. The goal of the converter script is to convert as much
+of the low level drudgery as possible. Using the scripts is
+straightforward. We'll use the CMake one as an example but the
+Autotools one works exactly the same way.
+
+    cmake2meson.py path/to/CMake/project/root
+
+This command generates a skeleton Meson project definition that tries
+to mirror CMake's setup as close as possible. Once this is done, you
+need to go through these files manually and finalize the
+conversion. To make this task as simple as possible, the converter
+script will transfer all comments from the CMake definition into Meson
+definition.