From 1f4e9cbfda2b8ab0a2ad8d4f0246a236355cf21d Mon Sep 17 00:00:00 2001
From: jyn <github@jyn.dev>
Date: Fri, 9 May 2025 08:25:49 -0400
Subject: [PATCH] document that the `rustc` tool namespace is reserved
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

this section in the reference is not quite right; or at least is an
incomplete summary. here is a more detailed explanation of what's
currently implemented:

|Tool|Lints|Attributes|
|-|-|-|
|`clippy`|✅|✅|
|`rustfmt`|❌|✅|
|`miri`|❌|✅|
|`rust_analyzer`|❌|✅|
|`rustdoc`|✅|❌|
|`rustc`|✅ (with `-Z unstable-options`)|❌|
|`diagnostic`|❌|✅|

i'm not sure how to write that up, and it doesn't belong in the
attributes section anyway, so i've just added this short snippet.
---
 src/attributes.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/attributes.md b/src/attributes.md
index d81e50ced..97dc92720 100644
--- a/src/attributes.md
+++ b/src/attributes.md
@@ -229,6 +229,7 @@ pub fn f() {}
 
 > [!NOTE]
 > `rustc` currently recognizes the tools "clippy", "rustfmt", "diagnostic", "miri" and "rust_analyzer".
+> Additionally, the `rustc` tool, and all tools starting with the literal string "rustc", are reserved for future extensions.
 
 r[attributes.builtin]
 ## Built-in attributes index