[perl-gtk2-champlain/deprecated: 1/2] Added project deprecation notice

[Emmanuel Rodriguez <erodriguez src gnome org>]

commit 3cb99e2535af72a21c4d04051f77ab3f18c2a3b4
Author: Emmanuel Rodriguez <emmanuel rodriguez gmail com>
Date:   Tue Jan 26 18:18:53 2021 +0100

    Added project deprecation notice
    
    - Makefile.PL, README, lib/Gtk2/Champlain.pm, perl-gtk2-champlain.doap

 Makefile.PL              | 25 ++++++++++++++++++++++++-
 README                   | 20 ++++++++++++++++++++
 lib/Gtk2/Champlain.pm    | 34 +++++++++++++++++++++++++++++++++-
 perl-gtk2-champlain.doap |  2 +-
 4 files changed, 78 insertions(+), 3 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index 0a989aa..ac26003 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -92,7 +92,30 @@ sub main {
                        FILES => 'build',
                },
        );
-       
+
+print <<__EON__;
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+This module has been deprecated by the Gtk-Perl project.  This means that the
+module will no longer be updated with security patches, bug fixes, or when
+changes are made in the Perl ABI.  The Git repo for this module has been
+archived (made read-only), it will no longer possible to submit new commits to
+it.  You are more than welcome to ask about this module on the Gtk-Perl
+mailing list, but our priorities going forward will be maintaining Gtk-Perl
+modules that are supported and maintained upstream; this module is neither.
+
+Since this module is licensed under the LGPL v2.1, you may also fork this
+module, if you wish, but you will need to use a different name for it on CPAN,
+and the Gtk-Perl team requests that you use your own resources (mailing list,
+Git repos, bug trackers, etc.) to maintain your fork going forward.
+
+* Perl URL: https://gitlab.gnome.org/GNOME/perl-gtk2-champlain
+* Upstream URL: https://gitlab.gnome.org/GNOME/libchamplain
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+__EON__
+
        return 0;
 }
 
diff --git a/README b/README
index 525bd1b..587db3c 100644
--- a/README
+++ b/README
@@ -1,6 +1,26 @@
 Gtk2::Champlain
 ===============
 
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+This module has been deprecated by the Gtk-Perl project.  This means that the
+module will no longer be updated with security patches, bug fixes, or when
+changes are made in the Perl ABI.  The Git repo for this module has been
+archived (made read-only), it will no longer possible to submit new commits to
+it.  You are more than welcome to ask about this module on the Gtk-Perl
+mailing list, but our priorities going forward will be maintaining Gtk-Perl
+modules that are supported and maintained upstream; this module is neither.
+
+Since this module is licensed under the LGPL v2.1, you may also fork this
+module, if you wish, but you will need to use a different name for it on CPAN,
+and the Gtk-Perl team requests that you use your own resources (mailing list,
+Git repos, bug trackers, etc.) to maintain your fork going forward.
+
+* Perl URL: https://gitlab.gnome.org/GNOME/perl-gtk2-champlain
+* Upstream URL: https://gitlab.gnome.org/GNOME/libchamplain
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
 Perl bindings for the C library "libchamplain-gtk" that provides a GtkWidget
 for displaying geographical maps from various free sources. Libchamplain-gtk
 provides a simple mechanism for rendering maps in a Gtk application. The library
diff --git a/lib/Gtk2/Champlain.pm b/lib/Gtk2/Champlain.pm
index a5adeda..3960854 100644
--- a/lib/Gtk2/Champlain.pm
+++ b/lib/Gtk2/Champlain.pm
@@ -2,7 +2,7 @@ package Gtk2::Champlain;
 
 =head1 NAME
 
-Gtk2::Champlain - Gtk2 map rendering widget
+Gtk2::Champlain - (DEPRECATED) Gtk2 map rendering widget
 
 =head1 SYNOPSIS
 
@@ -27,8 +27,40 @@ Gtk2::Champlain - Gtk2 map rendering widget
        $window->show_all();
        Gtk2->main();
 
+=head1 ABSTRACT
+
+B<DEPRECATED> Perl bindings for the C library 'libchamplain-gtk'
+
 =head1 DESCRIPTION
 
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
+This module has been deprecated by the Gtk-Perl project.  This means that the
+module will no longer be updated with security patches, bug fixes, or when
+changes are made in the Perl ABI.  The Git repo for this module has been
+archived (made read-only), it will no longer possible to submit new commits to
+it.  You are more than welcome to ask about this module on the Gtk-Perl
+mailing list, but our priorities going forward will be maintaining Gtk-Perl
+modules that are supported and maintained upstream; this module is neither.
+
+Since this module is licensed under the LGPL v2.1, you may also fork this
+module, if you wish, but you will need to use a different name for it on CPAN,
+and the Gtk-Perl team requests that you use your own resources (mailing list,
+Git repos, bug trackers, etc.) to maintain your fork going forward.
+
+=over
+
+=item *
+
+Perl URL: https://gitlab.gnome.org/GNOME/perl-gtk2-champlain
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/GNOME/libchamplain
+
+=back
+
+
 Gtk2::Champlain is a Gtk2 widget that allows Champlain maps to be embeded in any
 Gtk2 application.
 
diff --git a/perl-gtk2-champlain.doap b/perl-gtk2-champlain.doap
index b5a561a..4a3e459 100644
--- a/perl-gtk2-champlain.doap
+++ b/perl-gtk2-champlain.doap
@@ -5,7 +5,7 @@
          xmlns="http://usefulinc.com/ns/doap#";>
 
   <name xml:lang="en">Gtk2::Champlain</name>
-  <shortdesc xml:lang="en">Perl bindings for the Gtk2 API exposed by libchamplain</shortdesc>
+  <shortdesc xml:lang="en">(DEPRECATED) Perl bindings for the Gtk2 API exposed by libchamplain</shortdesc>
   <homepage rdf:resource="http://projects.gnome.org/libchamplain/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/libchamplain-list"; />