Rust: Deprecate staticlib, rlib, cdylib and dylib crate types

Meson already knows if it's a shared or static library, user only need
to specify the ABI (Rust or C).

Author: xclaesse

docs/markdown/snippets/rust_crate_type.md

@@ -1,4 +1,9 @@
 ## New `clib` value for `rust_crate_type`
 
-Similar to `lib` value but for building a C ABI static or shared library
-depending on the value of `default_library` when using `library()`.
+Similar to the `lib` value that was already accepted, but for building a C ABI
+static or shared library depending on the value of `default_library` when using
+`library()`.
+
+`staticlib`, `rlib`, `cdylib` and `dylib` values are now deprecated because
+Meson already knows if it's a shared or static library, user only need to specify
+the ABI (Rust or C).

docs/yaml/functions/_build_target_base.yaml

@@ -292,17 +292,16 @@ kwargs:
       If the target is an [[executable]] this defaults to "bin", the only
       allowed value.
 
-      If it is a [[static_library]] it defaults to "lib", and may be "lib", "clib"
-      "staticlib", or "rlib". "clib" and "staticlib" means a C ABI library,
-      "lib" and "rlib" means a Rust ABI.
-
-      If it is a [[shared_library]] it defaults to "lib", and may be "lib", "clib",
-      "dylib", "cdylib", or "proc-macro". "clib" and "cdylib" means a C ABI library,
-      "lib" and "dylib" means a Rust ABI, and "proc-macro" is a special rust
-      procedural macro crate.
-
-      "proc-macro" is new in 0.62.0.
-      "clib" is new in 1.2.0.
+      If it is a [[static_library]] it defaults to "lib" which builds a Rust ABI
+      library (rlib), "clib" builds a C ABI library (staticlib).
+      *Since 1.2.0* "clib" value has been added, "staticlib" and "rlib" values
+      have been deprecated.
+
+      If it is a [[shared_library]] it defaults to "lib" which builds a Rust ABI
+      library (dylib), "clib" value builds a C ABI library (cdylib).
+      *Since 0.62.0* "proc-macro" value builds a special rust procedural macro crate.
+      *Since 1.2.0* "clib" value has been added, "cdylib" and "dylib" values
+      have been deprecated.
 
   rust_dependency_map:
     type: dict[str]

mesonbuild/build.py

@@ -1246,6 +1246,9 @@ def process_kwargs(self, kwargs):
             FeatureNew.single_use('Rust crate type "proc-macro"', '0.62.0', self.subproject)
         if self.rust_crate_type == 'clib':
             FeatureNew.single_use('Rust crate type "clib"', '1.2.0', self.subproject)
+        if self.rust_crate_type in {'staticlib', 'rlib', 'cdylib', 'dylib'}:
+            FeatureDeprecated.single_use(f'Rust crate type {self.rust_crate_type!r}', '1.2.0', self.subproject,
+                                         'Use "lib" for Rust ABI and "clib" for C ABI')
 
         rust_dependency_map = kwargs.get('rust_dependency_map', {})
         if not isinstance(rust_dependency_map, dict):