From 2e4a8e98bd1d223ffb120cbc7440cdc478622efb Mon Sep 17 00:00:00 2001 From: Paolo Bonzini Date: Tue, 22 Jul 2025 10:41:59 +0200 Subject: [PATCH] docs: document naming convention for Rust subprojects Place the convention so that distro packagers know that they can rely on it, and not following it is a bug. This is the same convention that Meson uses for Cargo subprojects, but Mesa is not using them as they are experimental and not really usable yet. Acked-by: Faith Ekstrand Reviewed-by: Gurchetan Singh Tested-by: Gurchetan Singh Signed-off-by: Paolo Bonzini Part-of: --- docs/rust.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/rust.rst b/docs/rust.rst index 41155f74b3f..046fd23d613 100644 --- a/docs/rust.rst +++ b/docs/rust.rst @@ -1,6 +1,14 @@ Rust ==== +Rust Subproject Names +--------------------- + +All Rust subprojects should follow the convention ``NAME-SEMVER-rs``, +where ``SEMVER`` is the version up to and including the first nonzero +component. For example, ``zerocopy-0.8.13`` becomes ``zerocopy-0.8-rs``, +whereas ``syn-2.0.66`` becomes ``syn-2-rs``. + Rust Update Policy ------------------