Merge pull request #70060 from eeckstein/bridging-comments

add some comments in the bridging headers

Author: eeckstein

include/swift/AST/ASTBridging.h

@@ -16,6 +16,9 @@
 // Do not add other C++/llvm/swift header files here!
 // Function implementations should be placed into ASTBridging.cpp and required header files should be added there.
 //
+// Pure bridging mode does not permit including any C++/llvm/swift headers.
+// See also the comments for `BRIDGING_MODE` in the top-level CMakeLists.txt file.
+//
 #include "swift/Basic/BasicBridging.h"
 
 #ifdef USED_IN_CPP_SOURCE

include/swift/Basic/BasicBridging.h

@@ -20,6 +20,9 @@
 // Do not add other C++/llvm/swift header files here!
 // Function implementations should be placed into BasicBridging.cpp and required header files should be added there.
 //
+// Pure bridging mode does not permit including any C++/llvm/swift headers.
+// See also the comments for `BRIDGING_MODE` in the top-level CMakeLists.txt file.
+//
 #include "swift/Basic/BridgedSwiftObject.h"
 #include "swift/Basic/Compiler.h"
 

include/swift/SIL/SILBridging.h

@@ -17,6 +17,9 @@
 // Function implementations should be placed into SILBridgingImpl.h or SILBridging.cpp and
 // required header files should be added there.
 //
+// Pure bridging mode does not permit including any C++/llvm/swift headers.
+// See also the comments for `BRIDGING_MODE` in the top-level CMakeLists.txt file.
+//
 #include "swift/AST/ASTBridging.h"
 
 #ifdef USED_IN_CPP_SOURCE

include/swift/SILOptimizer/OptimizerBridging.h

@@ -17,6 +17,9 @@
 // Function implementations should be placed into OptimizerBridgingImpl.h or PassManager.cpp
 // (under OptimizerBridging) andrequired header files should be added there.
 //
+// Pure bridging mode does not permit including any C++/llvm/swift headers.
+// See also the comments for `BRIDGING_MODE` in the top-level CMakeLists.txt file.
+//
 #include "swift/AST/ASTBridging.h"
 #include "swift/SIL/SILBridging.h"
 
@@ -26,6 +29,8 @@
 
 #else // USED_IN_CPP_SOURCE
 
+// Pure bridging mode does not permit including any C++/llvm/swift headers.
+// See also the comments for `BRIDGING_MODE` in the top-level CMakeLists.txt file.
 #ifdef SWIFT_SIL_SILVALUE_H
 #error "should not include swift headers into bridging header"
 #endif