=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/>.
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