]> err.no Git - libchamplain/commitdiff
Explain why there are not Gtk2 bindings yet
authorEmmanuel Rodriguez <emmanuel.rodriguez@gmail.com>
Fri, 18 Sep 2009 21:07:28 +0000 (23:07 +0200)
committerPierre-Luc Beaudoin <pierre-luc@pierlux.com>
Mon, 21 Sep 2009 16:19:45 +0000 (12:19 -0400)
bindings/perl/Champlain/lib/Champlain.pm

index 698e719f2831d084dcdab3b04f142207677cf4f1..df146adf89f0ddc4cab4473abfcdd1445379c198 100644 (file)
@@ -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