From d35f11fc08b9033b2ce012eb394028b19d7e25f4 Mon Sep 17 00:00:00 2001 From: Dylan Baker Date: Sat, 5 Mar 2022 08:32:33 -0800 Subject: docs: document the rust_crate_type build_target keyword --- docs/yaml/functions/_build_target_base.yaml | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) (limited to 'docs') diff --git a/docs/yaml/functions/_build_target_base.yaml b/docs/yaml/functions/_build_target_base.yaml index 68df5d8..88fb8ae 100644 --- a/docs/yaml/functions/_build_target_base.yaml +++ b/docs/yaml/functions/_build_target_base.yaml @@ -276,3 +276,23 @@ kwargs: version specification such as `windows,6.0`. See [MSDN documentation](https://docs.microsoft.com/en-us/cpp/build/reference/subsystem-specify-subsystem) for the full list. + + rust_crate_type: + type: str + since: 0.41.0 + description: | + Set the specific type of rust crate to compile (when compiling rust). + + 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", + "staticlib", or "rlib". If "lib" then Rustc will pick a default, "staticlib" + means a C ABI library, "rlib" means a Rust ABI. + + If it is a [[shared_library]] it defaults to "lib", and may be "lib", + "dylib", "cdylib", or "proc-macro". If "lib" then Rustc will pick a + default, "cdylib" means a C ABI library, "dylib" means a Rust ABI, and + "proc-macro" is a special rust proceedural macro crate. + + "proc-macro" is new in 0.62.0. -- cgit v1.1