Add documentation for naming scheme.

1 files changed, 16 insertions, 0 deletions

diff --git a/docs/markdown/snippets/naming_option.md b/docs/markdown/snippets/naming_option.md
new file mode 100644
index 000000000..a1c1cdaf1
--- /dev/null
+++ b/docs/markdown/snippets/naming_option.md
@@ -0,0 +1,16 @@
+## Added new `namingscheme` option
+
+Traditionally Meson has named output targets so that they don't clash
+with each other. This has meant, among other things, that on Windows
+Meson uses a nonstandard `.a` suffix for static libraries because both
+static libraries and import libraries have the suffix `.lib`.
+
+There is now an option `namingscheme` that can be set to
+`platform`. This new platform native naming scheme that replicates
+what Rust does. That is, shared libraries on Windows get a suffix
+`.dll`, static libraries get `.lib` and import libraries have the name
+`.dll.lib`.
+
+We expect to change the default value of this option to `platform` in
+a future major version. Until that happens we reserve the right to
+alter how `platform` actually names its output files.