[perl-gtk2-glext/deprecation] Added project deprecation notice

[Brian Manning <bmanning src gnome org>]

commit 7d2098adc76104c98b0b442017a4fbdfad9dd3c6
Author: Brian Manning <bmanning src gnome org>
Date:   Wed Oct 14 20:02:26 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, perl-gtk2-glext.doap, xs/GtkGL.xs

 Makefile.PL          | 29 +++++++++++++++++++++++++++++
 README               | 23 +++++++++++++++++++++++
 perl-gtk2-glext.doap |  2 +-
 xs/GtkGL.xs          | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 103 insertions(+), 1 deletion(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index 92dcb9e..9a34668 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -76,10 +76,39 @@ WriteMakefile(
     NAME            => 'Gtk2::GLExt',
     VERSION_FROM    => 'GLExt.pm', # finds $VERSION
     XSPROTOARG      => '-noprototypes',
+    META_MERGE      => { x_deprecated => 1, },
     MAN3PODS        => \%pod_files,
     $gtkglext->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-gtk2-glext
+* Upstream URL: https://gitlab.gnome.org/Archive/gtkglext
+* Last upstream version: N/A
+* Last upstream release date: N/A
+* Migration path for this module: Gtk3::GLArea
+* Migration module URL: https://metacpan.org/pod/Glib::Object::Introspection
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+__EON__
+
+
 sub MY::postamble
 {
        return Glib::MakeHelper->postamble_clean ()
diff --git a/README b/README
index f73f6b5..397f436 100644
--- a/README
+++ b/README
@@ -1,6 +1,29 @@
 Gtk2::GLExt version 0.90
 ========================
 
+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-glext
+* Upstream URL: https://gitlab.gnome.org/Archive/gtkglext
+* Last upstream version: N/A
+* Last upstream release date: N/A
+* Migration path for this module: Gtk3::GLArea
+* Migration module URL: https://metacpan.org/pod/Glib::Object::Introspection
+
+
 The Gtk2::GLExt module allows a Perl developer to use GtkGLExt, an OpenGL
 extension to GTK+ by Naofumi Yasufuku (��ʡ ��ʸ), with Gtk2-Perl.
 
diff --git a/perl-gtk2-glext.doap b/perl-gtk2-glext.doap
index 5ac934b..7020531 100644
--- a/perl-gtk2-glext.doap
+++ b/perl-gtk2-glext.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gtk2-GLExt</name>
+  <name xml:lang="en">Gtk2-GLExt (DEPRECATED)</name>
   <shortdesc xml:lang="en">An OpenGL extension to Gtk2-Perl</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />
diff --git a/xs/GtkGL.xs b/xs/GtkGL.xs
index 64d30c8..9ddf25f 100644
--- a/xs/GtkGL.xs
+++ b/xs/GtkGL.xs
@@ -29,8 +29,58 @@ BOOT:
   # do OpenGL stuff...
   $gldrawable->gl_end;
 
+=head1 ABSTRACT
+
+B<DEPRECATED> The Gtk2::GLExt module allows a Perl developer to use GtkGLExt,
+an OpenGL extension to GTK+ by Naofumi Yasufuku, with Gtk2-Perl.
+
 =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-glext
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/Archive/gtkglext
+
+=item *
+
+Last upstream version: N/A
+
+=item *
+
+Last upstream release date: N/A
+
+=item *
+
+Migration path for this module: Gtk3::GLArea
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Glib::Object::Introspection
+
+=back
+
+B<NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE>
+
 The Gtk2::GLExt module allows a Perl developer to use GtkGLExt, an OpenGL
 extension to GTK+ by Naofumi Yasufuku, with Gtk2-Perl.