--- JSON-XS/XS/Boolean.pm	2007/07/03 04:54:00	1.2
+++ JSON-XS/XS/Boolean.pm	2013/10/29 10:35:37	1.3
@@ -8,8 +8,13 @@
 
 =head1 DESCRIPTION
 
-This module exists only to provide overload resolution for Storable and similar modules. See
-L<JSON::XS> for more info about this class.
+This module exists only to provide overload resolution for Storable and
+similar modules. It's only needed for compatibility with data serialised
+(by other modules such as Storable) that was decoded by JSON::XS versions
+before 3.0.
+
+Since 3.0, JSON::PP::Boolean has replaced it. Support for
+JSON::XS::Boolean will be removed in a future release.
 
 =cut