From: Joel Rosdahl <joel@rosdahl.net>
Date: Wed, 6 Aug 2025 16:52:28 +0000 (+0200)
Subject: docs: Mention that #pragma once could be problematic with PCH
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=dfc976fa4888814a253627e2ebd2913d29cffd59;p=thirdparty%2Fccache.git

docs: Mention that #pragma once could be problematic with PCH

Fixes #1615.
---

diff --git a/doc/MANUAL.adoc b/doc/MANUAL.adoc
index e67b3589..b8f48a6f 100644
--- a/doc/MANUAL.adoc
+++ b/doc/MANUAL.adoc
@@ -1802,7 +1802,7 @@ directories:
 
 == Precompiled headers
 
-Ccache has support for precompiled headers with GCC and Clang. However, you have
+Ccache has limited support for precompiled headers with GCC and Clang. You have
 to do some things to make it work properly:
 
 * You must set <<config_sloppiness,*sloppiness*>> to *pch_defines,time_macros*.
@@ -1833,6 +1833,9 @@ be used (if available) or ccache will fall back to running the real compiler and
 increase the statistics counter "`Preprocessing failed`" (if the non-precompiled
 header file is not available).
 
+Also, you might get into trouble if header files use `#pragma once` instead of
+include guards.
+
 
 == C++ modules