aboutsummaryrefslogtreecommitdiff
path: root/docs/markdown/Comparisons.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/markdown/Comparisons.md')
-rw-r--r--docs/markdown/Comparisons.md26
1 files changed, 13 insertions, 13 deletions
diff --git a/docs/markdown/Comparisons.md b/docs/markdown/Comparisons.md
index 3c526ad..dcfefa9 100644
--- a/docs/markdown/Comparisons.md
+++ b/docs/markdown/Comparisons.md
@@ -2,7 +2,7 @@
title: Comparisons
...
-# Comparing Meson with other build systems #
+# Comparing Meson with other build systems
A common question is *Why should I choose Meson over a different build
system X?* There is no one true answer to this as it depends on the
@@ -11,37 +11,37 @@ to build medium-to-large projects so the decision is usually made on
other points. Here we list some pros and cons of various build systems
to help you do the decision yourself.
-## GNU Autotools ##
+## GNU Autotools
-### Pros ###
+### Pros
Excellent support for legacy Unix platforms, large selection of
existing modules.
-### Cons ###
+### Cons
Needlessly slow, complicated, hard to use correctly, unreliable,
painful to debug, incomprehensible for most people, poor support for
non-Unix platforms (especially Windows).
-## CMake ##
+## CMake
-### Pros ###
+### Pros
Great support for multiple backends (Visual Studio, XCode, etc).
-### Cons ###
+### Cons
The scripting language is cumbersome to work with. Some simple things
are more complicated than necessary.
-## SCons ##
+## SCons
-### Pros ###
+### Pros
Full power of Python available for defining your build.
-### Cons ###
+### Cons
Slow. Requires you to pass your configuration settings on every
invocation. That is, if you do `scons OPT1 OPT2` and then just
@@ -61,9 +61,9 @@ Implemented in Java. Poor Windows support. Heavily focused on Google's
way of doing things (which may be a good or a bad thing). Contributing
code requires [signing a CLA](https://bazel.build/contributing.html).
-## Meson ##
+## Meson
-### Pros ###
+### Pros
The fastest build system [see
measurements](Performance-comparison.md), user friendly, designed to
@@ -71,7 +71,7 @@ be as invisible to the developer as possible, native support for
modern tools (precompiled headers, coverage, Valgrind etc). Not Turing
complete so build definition files are easy to read and understand.
-### Cons ###
+### Cons
Relatively new so it does not have a large user base yet, and may thus
contain some unknown bugs. Visual Studio and XCode backends not as