[libcxx-commits] [libcxx] [libc++][doc] Add warning about limitation of --fresh in boostrapping build (PR #65265)

[Will Hawkins via libcxx-commits]

https://github.com/hawkinsw created https://github.com/llvm/llvm-project/pull/65265:

Add a warning to the `Building Libcxx` documentation about the limitations of the utility of `--fresh` at the top level.

>From 4feed6fa54a0f5aadd6d46fbbb0e14cc4b0ba28c Mon Sep 17 00:00:00 2001
From: Will Hawkins <hawkinsw at obs.cr>
Date: Mon, 4 Sep 2023 10:38:25 -0400
Subject: [PATCH] [libc++][doc] Add warning about limitation of --fresh in
 boostrapping build

Add a warning to the `Building Libcxx` documentation about the
limitations of the utility of `--fresh` at the top level.

Signed-off-by: Will Hawkins <hawkinsw at obs.cr>
---
 libcxx/docs/BuildingLibcxx.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/libcxx/docs/BuildingLibcxx.rst b/libcxx/docs/BuildingLibcxx.rst
index f62b0ba7a04652c..3a689b4981ab74b 100644
--- a/libcxx/docs/BuildingLibcxx.rst
+++ b/libcxx/docs/BuildingLibcxx.rst
@@ -78,6 +78,9 @@ CMake invocation at ``<monorepo>/llvm``:
   This type of build is also commonly called a "Runtimes build", but we would like to move
   away from that terminology, which is too confusing.
 
+.. warning::
+  Adding the `--fresh` flag to the top-level cmake invocation in a bootstrapping build *will not* freshen the cmake cache of any of the enabled runtimes.
+
 Support for Windows
 ===================