[perl-gnome2/deprecation: 2/8] Gnome2.pm/Makefile.PL: added deprecation notice

[Brian Manning <bmanning src gnome org>]

commit 142632cf6f847f56d6b0a25aec7cfa4ca63bfbb3
Author: Brian Manning <bmanning src gnome org>
Date:   Tue Aug 18 21:35:46 2020 -0700

    Gnome2.pm/Makefile.PL: added deprecation notice

 Gnome2.pm   | 48 +++++++++++++++++++++++++++++++++++++++++++++---
 Makefile.PL | 26 ++++++++++++++++++++++++++
 2 files changed, 71 insertions(+), 3 deletions(-)
---
diff --git a/Gnome2.pm b/Gnome2.pm
index 583ec41..13e8a6f 100644
--- a/Gnome2.pm
+++ b/Gnome2.pm
@@ -42,12 +42,54 @@ Gnome2 - Perl interface to the 2.x series of the GNOME libraries
 
 =head1 ABSTRACT
 
-Perl bindings to the 2.x series of the GNOME libraries.  This module allows you
-to interface with the libgnome and libgnomeui libraries to create GNOME
-applications.
+B<(DEPRECATED)> Perl bindings to the 2.x series of the GNOME libraries.  This
+module allows you to interface with the libgnome and libgnomeui libraries to
+create GNOME applications.
 
 =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-gnome2
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/Archive/libgnome
+
+=item *
+
+Last upstream version: 2.32.1
+
+=item *
+
+Last upstream release date: 2011-01-31
+
+=item *
+
+Migration path for this module: No upstream replacement
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
+
 Since this module tries to stick very closely to the C API, the documentation
 found at
 
diff --git a/Makefile.PL b/Makefile.PL
index 54a391f..a9bffbc 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -163,6 +163,32 @@ WriteMakefile(
     $gnome2->get_makefile_vars,
 );
 
+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-gnome2
+* Upstream URL: https://gitlab.gnome.org/Archive/libgnome
+* Last upstream version: 2.32.1
+* Last upstream release date: 2011-01-31
+* Migration path for this module: No upstream replacement
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+__EON__
+
 sub MY::postamble {
        return Glib::MakeHelper->postamble_clean ()
             . Glib::MakeHelper->postamble_docs_full (