[cxx-interop] Introduce APINotes file for C++ stdlib

This adds an `std.apinotes` file that is installed into `lib/swift/apinotes` along with existing Darwin apinotes. This new file is installed on all platforms. It replaces a few special cases in the compiler for `cmath` and `cstring` functions.

This does not require the upcoming APINotes support for namespaces, however, this does require swiftlang/llvm-project#7309.

rdar://107572302

Author: egorzhdan

lib/ClangImporter/ImportDecl.cpp

@@ -3215,24 +3215,6 @@ namespace {
 
       if (Impl.SwiftContext.LangOpts.EnableCXXInterop &&
           !isa<clang::CXXMethodDecl>(decl)) {
-        // Do not import math functions from the C++ standard library, as
-        // they're also imported from the Darwin/Glibc module, and their
-        // presence in the C++ standard library will cause overloading
-        // ambiguities or other type checking errors in Swift.
-        auto isAlternativeCStdlibFunctionFromTextualHeader =
-            [this](const clang::FunctionDecl *d) -> bool {
-          // stdlib.h might be a textual header in libc++'s module map.
-          // in this case, check for known ambiguous functions by their name
-          // instead of checking if they come from the `std` module.
-          if (!d->getDeclName().isIdentifier())
-            return false;
-          if (d->getName() == "abs" || d->getName() == "div")
-            return true;
-          if (Impl.SwiftContext.LangOpts.Target.isOSDarwin())
-            return d->getName() == "strstr" || d->getName() == "sin" ||
-                   d->getName() == "cos" || d->getName() == "exit";
-          return false;
-        };
         auto topLevelModuleEq =
             [](const clang::FunctionDecl *d, StringRef n) -> bool {
           return d->getOwningModule() &&
@@ -3241,9 +3223,6 @@ namespace {
                     ->getFullModuleName() == n;
         };
         if (topLevelModuleEq(decl, "std")) {
-          if (isAlternativeCStdlibFunctionFromTextualHeader(decl)) {
-            return nullptr;
-          }
           auto filename =
               Impl.getClangPreprocessor().getSourceManager().getFilename(
                   decl->getLocation());

stdlib/public/Cxx/std/CMakeLists.txt

@@ -1,3 +1,21 @@
+#
+# API Notes for the C++ Standard Library
+#
+set(output_dir "${SWIFTLIB_DIR}/apinotes")
+add_custom_target(CxxStdlib-apinotes
+    COMMAND ${CMAKE_COMMAND} "-E" "copy_if_different" "${CMAKE_CURRENT_SOURCE_DIR}/std.apinotes" "${output_dir}"
+    DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/std.apinotes
+    COMMENT "Copying CxxStdlib API Notes to ${output_dir}")
+
+swift_install_in_component(FILES std.apinotes
+    DESTINATION "lib/swift/apinotes"
+    COMPONENT compiler)
+
+set_property(TARGET CxxStdlib-apinotes PROPERTY FOLDER "Miscellaneous")
+add_dependencies(sdk-overlay CxxStdlib-apinotes)
+add_dependencies(compiler CxxStdlib-apinotes)
+
+
 # Swift compiler currently assumes that the Darwin overlay is a dependency of
 # CxxStdlib, and fails to build CxxStdlib if Darwin.swiftmodule in build dir
 # is built with a different (older) version of the compiler. To workaround this,
@@ -34,4 +52,4 @@ add_swift_target_library(swiftCxxStdlib STATIC NO_LINK_NAME IS_STDLIB IS_SWIFT_O
     TARGET_SDKS ALL_APPLE_PLATFORMS LINUX WINDOWS
     INSTALL_IN_COMPONENT compiler
     INSTALL_WITH_SHARED
-    DEPENDS libstdcxx-modulemap libcxxshim_modulemap)
+    DEPENDS libstdcxx-modulemap libcxxshim_modulemap CxxStdlib-apinotes)

stdlib/public/Cxx/std/std.apinotes

@@ -0,0 +1,20 @@
+Name: std
+Functions:
+- Name: abs
+  Availability: nonswift
+  AvailabilityMsg: Use the C standard library function
+- Name: cos
+  Availability: nonswift
+  AvailabilityMsg: Use the C standard library function
+- Name: div
+  Availability: nonswift
+  AvailabilityMsg: Use the C standard library function
+- Name: exit
+  Availability: nonswift
+  AvailabilityMsg: Use the C standard library function
+- Name: sin
+  Availability: nonswift
+  AvailabilityMsg: Use the C standard library function
+- Name: strstr
+  Availability: nonswift
+  AvailabilityMsg: Use the C standard library function