mirror of
https://gitlab.freedesktop.org/mesa/mesa.git
synced 2025-12-20 11:40:10 +01:00
2f5e37f72e
This creates a concept of "peripheral" for Rust crates housed in Mesa, and "unofficially" uploaded to crates.io by subcommunities of Mesa. This is modeled on LLVM's peripheral versus core support concept: https://llvm.org/docs/SupportPolicy.html This allows use of the mesa3d_util crate without vendoring it. This is a desire of the crosvm maintainers (crrev.com/c/6594760). This also formally defines CODEOWNERS to be the projected uploaders of the mesa3d_util crate. Everyone of course is encouraged to make changes, but that just gives us a heads-up to update the downstream imports of mesa3d_util. The Cargo.toml file is not added here, since Meson is the only officially supported build system of the Mesa3D project. Reviewed-by: Marcin Radomski <dextero@google.com> Part-of: <https://gitlab.freedesktop.org/mesa/mesa/-/merge_requests/36276>
57 lines
2 KiB
ReStructuredText
57 lines
2 KiB
ReStructuredText
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
|
|
------------------
|
|
|
|
Given that for some distributions it's not feasible to keep up with the
|
|
pace of Rust, we promise to only bump the minimum required Rust version
|
|
following those rules:
|
|
|
|
- Only up to the Rust requirement of other major Linux desktop
|
|
components, e.g.:
|
|
|
|
- `Firefox ESR <https://whattrainisitnow.com/release/?version=esr>`__:
|
|
`Minimum Supported Rust Version:
|
|
<https://firefox-source-docs.mozilla.org/writing-rust-code/update-policy.html#schedule>`__
|
|
|
|
- latest `Linux Kernel Rust requirement
|
|
<https://docs.kernel.org/process/changes.html#current-minimal-requirements>`__
|
|
|
|
- Only require a newer Rust version than stated by other rules if and only
|
|
if it's required to get around a bug inside rustc.
|
|
|
|
As bug fixes might run into rustc compiler bugs, a rust version bump _can_
|
|
happen on a stable branch as well.
|
|
|
|
Peripheral Support for crates.io uploads
|
|
----------------------------------------
|
|
Certain Mesa crates are uploaded to crates.io at the discretion of certain
|
|
sub-communities of Mesa. These crates are:
|
|
|
|
- https://crates.io/crates/mesa3d_util
|
|
|
|
These crates are used as dependencies to other Rust-based projects, such as:
|
|
|
|
- https://crates.io/crates/rutabaga_gfx/0.1.61/dependencies
|
|
|
|
This is not supported by the "core" Mesa quarterly release cycles, and the
|
|
official Mesa maintainers are not liable for use or mis-use of the crates.
|
|
Please contact the relevant sub-community before using these crates outside
|
|
of Mesa3D.
|
|
|
|
Official Mesa distribution of crates will likely have wait until improvements
|
|
are made in the Meson build system:
|
|
|
|
- https://github.com/mesonbuild/meson/issues/2173
|
|
|
|
The Meson build system is the only build system officially supported by
|
|
Mesa3D.
|