diff --git a/doc/faq.xml b/doc/faq.xml
index 02fdf05..930650a 100644
--- a/doc/faq.xml
+++ b/doc/faq.xml
@@ -5,6 +5,17 @@
Frequently Asked Questions
+
+
+ Is Boost.Signals being actively maintained?
+
+
+ No. Please migrate to Boost.Signals2.
+ There is a
+ porting guide
+ in the Signals2 documentation.
+
+
Don't noncopyable signal semantics mean that a class
diff --git a/doc/introduction.xml b/doc/introduction.xml
index 82dee01..6bbb06b 100644
--- a/doc/introduction.xml
+++ b/doc/introduction.xml
@@ -2,7 +2,16 @@
- Introduction
+
+Introduction
+
+Boost.Signals is no longer being actively maintained.
+Do not use Boost.Signals for new development (use
+Boost.Signals2
+instead). If you have existing Boost.Signals-based code, it will
+continue to work, but consider moving to Boost.Signals2. There is
+
+a porting guide in the Signals2 documentation.
The Boost.Signals library is an implementation of a managed
signals and slots system. Signals represent callbacks with multiple