rename rustc_legacy_const_generics to make it more clear that it is (soft) deprecated

[RalfJung]

r? types or @oli-obk, you know best how deprecated this really is

Context: rust-lang/stdarch#1916

[rustbot]

Some changes occurred in compiler/rustc_passes/src/check_attr.rs

cc @jdonszelmann

stdarch is developed in its own repository. If possible, consider making this change to rust-lang/stdarch instead.

cc @Amanieu, @folkertdev, @sayantn

[traviscross]

Perhaps it'd be worth adding a comment here to the effect that this should not be newly applied anywhere.

[RalfJung]

I doubt anyone who might be tempted to apply it would see a comment deep inside the rustc sources.

[oli-obk]

Ha, just an hour ago I was thinking to name it legacy_const_generics_do_not_use just to avoid any and all ambiguity

[RalfJung]

Yeah I considered that name but it seemed a bit too cheesy ;)

[RalfJung]

I also considered rustc_legacy_const_generics_deprecated (instead of rustc_deprecated_legacy_const_generics), not sure which order makes more sense.

[lcnr]

r=me on the name change

legacy const generics arguments have weird restriction and I also really feel like if we actually want better support for const generics, that should be an actually stable feature instead of some widely used std internal hack

use std::arch::x86_64::_mm_aeskeygenassist_si128;
fn main() {
    _mm_aeskeygenassist_si128(return, {
        struct Foo;
        1
    });
}

error: invalid argument to a legacy const generic: cannot have const blocks, closures, async blocks or items
 --> src/main.rs:4:9
  |
4 |         struct Foo;
  |         ^^^^^^^^^^^
  |
help: try using a const generic argument instead
  |
3 ~     _mm_aeskeygenassist_si128::<{ {
4 +     struct Foo;
5 +     1
6 ~ } }>(return);
  |

I feel like ideally we have an explicit allow-list for all functions marked with that attribute and need people to add any new functions to it manually. Idk how much effort that is however.

[RalfJung]

I feel like ideally we have an explicit allow-list for all functions marked with that attribute and need people to add any new functions to it manually.

I don't think that's worth it, the compiler has to trust the standard library to not misuse the unstable features that exist solely to support the standard library. Ofc reviewers forget things so we should support them where we can, but an allowlist seems pretty heavy-handed.

IOW, the attribute is the allowlist.

[RalfJung]

Looks like there wasn't actually a team decision to deprecate this (rust-lang/stdarch#1916 (comment)), so let's hold off on this PR for now.

[rust-log-analyzer]

The job aarch64-gnu-llvm-19-1 failed! Check out the build log: (web) (plain enhanced) (plain)

Click to see the possible cause of the failure (guessed by this bot)

---- [rustdoc] tests/rustdoc/constant/legacy-const-generic.rs stdout ----
------rustdoc stdout------------------------------

------rustdoc stderr------------------------------
error: attributes starting with `rustc` are reserved for use by the `rustc` compiler
##[error]  --> /checkout/tests/rustdoc/constant/legacy-const-generic.rs:13:3
   |
13 | #[rustc_legacy_const_generics(1, 2)]
   |   ^^^^^^^^^^^^^^^^^^^^^^^^^^^

error: attributes starting with `rustc` are reserved for use by the `rustc` compiler
##[error] --> /checkout/tests/rustdoc/constant/legacy-const-generic.rs:6:3
  |
6 | #[rustc_legacy_const_generics(1)]
  |   ^^^^^^^^^^^^^^^^^^^^^^^^^^^

error: cannot find attribute `rustc_legacy_const_generics` in this scope
##[error]  --> /checkout/tests/rustdoc/constant/legacy-const-generic.rs:13:3
   |
13 | #[rustc_legacy_const_generics(1, 2)]
   |   ^^^^^^^^^^^^^^^^^^^^^^^^^^^

error: cannot find attribute `rustc_legacy_const_generics` in this scope
##[error] --> /checkout/tests/rustdoc/constant/legacy-const-generic.rs:6:3
  |
---
------------------------------------------

error: rustdoc failed!
status: exit status: 1
command: cd "/checkout/obj/build/aarch64-unknown-linux-gnu/test/rustdoc/constant/legacy-const-generic" && env -u RUSTC_LOG_COLOR RUSTC_ICE="0" RUST_BACKTRACE="short" "/checkout/obj/build/aarch64-unknown-linux-gnu/stage2/bin/rustdoc" "-L" "/checkout/obj/build/aarch64-unknown-linux-gnu/stage2/lib/rustlib/aarch64-unknown-linux-gnu/lib" "-L" "/checkout/obj/build/aarch64-unknown-linux-gnu/test/rustdoc/constant/legacy-const-generic/auxiliary" "-o" "/checkout/obj/build/aarch64-unknown-linux-gnu/test/rustdoc/constant/legacy-const-generic" "--deny" "warnings" "/checkout/tests/rustdoc/constant/legacy-const-generic.rs" "-A" "internal_features"
stdout: none
--- stderr -------------------------------
error: attributes starting with `rustc` are reserved for use by the `rustc` compiler
##[error]  --> /checkout/tests/rustdoc/constant/legacy-const-generic.rs:13:3
   |
13 | #[rustc_legacy_const_generics(1, 2)]
   |   ^^^^^^^^^^^^^^^^^^^^^^^^^^^

error: attributes starting with `rustc` are reserved for use by the `rustc` compiler
##[error] --> /checkout/tests/rustdoc/constant/legacy-const-generic.rs:6:3
  |
6 | #[rustc_legacy_const_generics(1)]
  |   ^^^^^^^^^^^^^^^^^^^^^^^^^^^

error: cannot find attribute `rustc_legacy_const_generics` in this scope
##[error]  --> /checkout/tests/rustdoc/constant/legacy-const-generic.rs:13:3
   |
13 | #[rustc_legacy_const_generics(1, 2)]
   |   ^^^^^^^^^^^^^^^^^^^^^^^^^^^

error: cannot find attribute `rustc_legacy_const_generics` in this scope
##[error] --> /checkout/tests/rustdoc/constant/legacy-const-generic.rs:6:3
  |

[traviscross]

Nominated this question as part of:

• Decide about future of rustc_legacy_const_generics #146613

[bors]

☔ The latest upstream changes (presumably #146700) made this pull request unmergeable. Please resolve the merge conflicts.