rust-lang / rust-lang/rust

Update linker-based LTO compatibility matrix as a part of the Rustc release process

Open
#154,285 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

A-docs
Dominant language
Rust
Stars
119k
Forks
16.1k
PR merge metrics
PR metrics pending

Description

Location (URL)

https://doc.rust-lang.org/rustc/linker-plugin-lto.html#toolchain-compatibility

Summary

We already had multiple times a problem with outdated Linker-based compatibility matrix:

The problem is that the documentation is not updated during the Rust release process, and now it's done in some random way. That's definitely not a good way to do this.

I suggest update this page as a mandatory part of the Rustc release process - in this case, no out-of-date states will be found in the future. I don't know in which way we should do it - automatically via some script or seomhow manually - since I am not familiar with the release process. But we need to do something with it.

This information is important for Rustc users (me including), who is trying to use cross-lang LTO for Rust + C/C++ apps, we need this compatibility matrix up-to-date to not guess (aka check manually) Rustc and Clang compatibility.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linker-plugin LTO toolchain compatibility section at the linked documentation URL, then read PRs 103955, 146827, and 154284 to understand how the matrix has been updated. Next, inspect the Rustc release process to determine where this check belongs and whether it can be automated. Done means the matrix update is a defined, repeatable part of every release.

Written by the indexing model from the issue text.

Assessment

Tech stack
cpp, rust
Domain
documentation, release
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.