From b1a0f86c0e4001e8db4ddc5302e78338f1bc8863 Mon Sep 17 00:00:00 2001
From: Adam Gemmell <adam.gemmell@arm.com>
Date: Thu, 8 Oct 2026 14:44:45 +0100
Subject: [PATCH] doc(builtin-dep): Mention the package ID spec format in the
 unstable docs

---
 doc/book/src/reference/unstable.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/doc/book/src/reference/unstable.md b/doc/book/src/reference/unstable.md
index b60e1e6402c..9a7db1037ad 100644
--- a/doc/book/src/reference/unstable.md
+++ b/doc/book/src/reference/unstable.md
@@ -1960,6 +1960,10 @@ core = { builtin = true}
 Specifying builtin dependencies explicitly pairs well with `-Zbuild-std` and is
 also useful for `#[no_std]` crates. See the RFC for further details.
 
+The Package ID specification can refer to builtin packages using the form
+`builtin://.#<name>`. For example, `builtin://.#core` identifies the builtin
+core package, distinguishing it from packages named "core" from other sources.
+
 # Stabilized and removed features
 
 ## Compile progress