From c168fba268082c1a9203550ac72d12ece143814f Mon Sep 17 00:00:00 2001
From: Camille GILLOT <gillot.camille@gmail.com>
Date: Tue, 3 May 2022 22:01:01 +0200
Subject: [PATCH] Comment untracked_crate.

---
 compiler/rustc_middle/src/ty/context.rs | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/compiler/rustc_middle/src/ty/context.rs b/compiler/rustc_middle/src/ty/context.rs
index 2beac304266..a750bb8abd0 100644
--- a/compiler/rustc_middle/src/ty/context.rs
+++ b/compiler/rustc_middle/src/ty/context.rs
@@ -1077,6 +1077,8 @@ pub struct GlobalCtxt<'tcx> {
     /// Output of the resolver.
     pub(crate) untracked_resolutions: ty::ResolverOutputs,
     untracked_resolver_for_lowering: Steal<ty::ResolverAstLowering>,
+    /// The entire crate as AST. This field serves as the input for the hir_crate query,
+    /// which lowers it from AST to HIR. It must not be read or used by anything else.
     pub untracked_crate: Steal<Lrc<ast::Crate>>,
 
     /// This provides access to the incremental compilation on-disk cache for query results.