From eeb537c8d69cc6062d119885fd6b19ec8ec45ee5 Mon Sep 17 00:00:00 2001
From: Henner Zeller <h.zeller@acm.org>
Date: Sat, 30 Aug 2025 17:23:34 +0200
Subject: [PATCH] Annotate facade header with IWYU export annotation

Without that annotation, tools such as `clang-tidy` or
the `clangd` language server (as well as many other tools)
will complain about headers not directly providing a symbol
if users include `asio.hpp`; With this annotation, they
know.

Documentation IWYU
https://github.com/include-what-you-use/include-what-you-use/blob/master/docs/IWYUPragmas.md#iwyu-pragma-begin_exportsend_exports

Documentation llvm include cleaner/clang-tidy/clangd
https://clangd.llvm.org/design/include-cleaner#iwyu-pragmas

Signed-off-by: Henner Zeller <h.zeller@acm.org>
---
 include/boost/asio.hpp | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/include/boost/asio.hpp b/include/boost/asio.hpp
index 8670f6eb8..ee9ecb569 100644
--- a/include/boost/asio.hpp
+++ b/include/boost/asio.hpp
@@ -17,6 +17,8 @@
 # pragma once
 #endif // defined(_MSC_VER) && (_MSC_VER >= 1200)
 
+// IWYU pragma: begin_exports
+
 #include <boost/asio/any_completion_executor.hpp>
 #include <boost/asio/any_completion_handler.hpp>
 #include <boost/asio/any_io_executor.hpp>
@@ -198,4 +200,6 @@
 #include <boost/asio/write.hpp>
 #include <boost/asio/write_at.hpp>
 
+// IWYU pragma: end_exports
+
 #endif // BOOST_ASIO_HPP