From bc865adbeef48c68944d9784746d92454f25081c Mon Sep 17 00:00:00 2001
From: Brentley Jones <github@brentleyjones.com>
Date: Mon, 21 Oct 2024 11:02:38 -0700
Subject: [PATCH] Add note about the future of `mixed_language_library` (#1418)

Signed-off-by: Brentley Jones <github@brentleyjones.com>
---
 doc/rules.md                              | 4 ++++
 mixed_language/mixed_language_library.bzl | 3 +++
 2 files changed, 7 insertions(+)

diff --git a/doc/rules.md b/doc/rules.md
index 382c2b4d3..117be3360 100644
--- a/doc/rules.md
+++ b/doc/rules.md
@@ -1000,6 +1000,10 @@ mixed_language_library(<a href="#mixed_language_library-name">name</a>, <a href=
 
 Creates a mixed language library from a Clang and Swift library target     pair.
 
+Note: In the future `swift_library` will support mixed-langauge libraries.
+Once that is the case, this macro will be deprecated.
+
+
 **PARAMETERS**
 
 
diff --git a/mixed_language/mixed_language_library.bzl b/mixed_language/mixed_language_library.bzl
index 9ffa54204..9e27d78be 100644
--- a/mixed_language/mixed_language_library.bzl
+++ b/mixed_language/mixed_language_library.bzl
@@ -61,6 +61,9 @@ def mixed_language_library(
     """Creates a mixed language library from a Clang and Swift library target \
     pair.
 
+    Note: In the future `swift_library` will support mixed-langauge libraries.
+    Once that is the case, this macro will be deprecated.
+
     Args:
         name: The name of the target.
         alwayslink: If true, any binary that depends (directly or indirectly) on