[libchamplain: 38/39] Explain why there are not Gtk2 bindings yet

[Pierre-Luc Beaudoin <plbeaudoin src gnome org>]

commit 004e7e72916445c6d43014510aa38d1d1d294518
Author: Emmanuel Rodriguez <emmanuel rodriguez gmail com>
Date:   Fri Sep 18 23:07:28 2009 +0200

    Explain why there are not Gtk2 bindings yet

 bindings/perl/Champlain/lib/Champlain.pm |   22 +++++++++++++++++-----
 1 files changed, 17 insertions(+), 5 deletions(-)
---
diff --git a/bindings/perl/Champlain/lib/Champlain.pm b/bindings/perl/Champlain/lib/Champlain.pm
index 698e719..df146ad 100644
--- a/bindings/perl/Champlain/lib/Champlain.pm
+++ b/bindings/perl/Champlain/lib/Champlain.pm
@@ -29,11 +29,8 @@ Champlain - Map rendering canvas
 =head1 DESCRIPTION
 
 Champlain is a Perl binding for the C library libchamplain which provides a
-canvas widget based on Clutter that displays maps from various free map sources
-such as I<OpenStreetMap>, I<OpenAerialMap> and I<Maps for free>.
-
-If the C library is compiled with GTK support then the map widget can also be
-embedded in any GTK application.
+canvas widget based on L<Clutter> that displays maps from various free map
+sources such as I<OpenStreetMap>, I<OpenAerialMap> and I<Maps for free>.
 
 For more information about libchamplain see:
 L<http://projects.gnome.org/libchamplain/>.
@@ -59,6 +56,21 @@ and maximal values for (latitude, longitude) coordinates:
 
 	use Champlain ':coords';
 
+=head1 Gtk2 support
+
+In the past I<Champlain> provided also support for a L<Gtk2> widget if the C
+library libchamplain was compiled with GTK support and if Clutter would be
+built with Gtk2 support.
+
+While this was very handy it made the Perl modules hard to maintain and starting
+with Clutter 1.0 the Gtk2 wrappers are no longer bundled. They will be provided
+by another CPAN package that doesn't exist yet. This will mimic what the C
+libraries do and what other bindings do.
+
+In the meanwhile this means that this Perl module no longer supports Gtk2.
+Just as with Clutter, another module will be created that will add support for
+Gtk2 once the Gkt2 Perl bindings for Clutter are written.
+
 =head1 BUGS
 
 The library libchamplain is quite young and its API is changing as the code