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

@@ -295,17 +295,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.3.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.3.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.3.0* "clib" value has been added, "cdylib" and "dylib" values
+      have been deprecated.
 
   rust_dependency_map:
     type: dict[str]