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

[Brian Manning <bmanning src gnome org>]

commit c51cd94672565f7804d29a8a8055780f430ce6bd
Author: Brian Manning <bmanning src gnome org>
Date:   Wed Oct 14 22:36:54 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, GladeXML.pm, perl-gtk2-gladexml.doap

 GladeXML.pm             | 55 ++++++++++++++++++++++++++++++++++++++++++++-----
 Makefile.PL             | 28 +++++++++++++++++++++++++
 README                  | 25 ++++++++++++++++++++++
 perl-gtk2-gladexml.doap |  2 +-
 4 files changed, 104 insertions(+), 6 deletions(-)
---
diff --git a/GladeXML.pm b/GladeXML.pm
index 6884c69..7806eee 100644
--- a/GladeXML.pm
+++ b/GladeXML.pm
@@ -128,7 +128,7 @@ Gtk2::GladeXML - Create user interfaces directly from Glade XML files.
   use Gtk2::GladeXML;
   $gladexml = Gtk2::GladeXML->new('example.glade');
   $gladexml->signal_autoconnect_from_package('main');
-  $quitbtn = $gladexml->get_widget('Quit'); 
+  $quitbtn = $gladexml->get_widget('Quit');
   Gtk2->main;
 
   # for glade files using gnome widgets, you must initialize Gnome2
@@ -142,12 +142,57 @@ Gtk2::GladeXML - Create user interfaces directly from Glade XML files.
 
 =head1 ABSTRACT
 
-Gtk2::GladeXML allows Perl programmers to use libglade, a C library which
-generates graphical user interfaces directly from the XML output of the
-Glade user interface designer.
+B<DEPRECATED> Gtk2::GladeXML allows Perl programmers to use libglade, a C
+library which generates graphical user interfaces directly from the XML output
+of the Glade user interface designer.
 
 =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-gladexml
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/Archive/libglade
+
+=item *
+
+Last upstream version: 2.6.4
+
+=item *
+
+Last upstream release date: 2009-03-17
+
+=item *
+
+Migration path for this module: Gtk3::Builder
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Gtk3
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
 Glade is a free user interface builder for GTK+ and GNOME.  After designing
 a user interface with glade-2 the layout and configuration are saved in an
 XML file.  libglade is a library which knows how to build and hook up the
@@ -157,7 +202,7 @@ This extension module binds libglade to Perl so you can create and manipulate
 user interfaces in Perl code in conjunction with Gtk2 and even Gnome2.  Better
 yet you can load a file's contents into a PERL scalar do a few magical regular
 expressions to customize things and the load up the app. It doesn't get any
-easier. 
+easier.
 
 =head1 FUNCTIONS
 
diff --git a/Makefile.PL b/Makefile.PL
index a08b26b..4a88b05 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -73,11 +73,39 @@ WriteMakefile(
     XSPROTOARG    => '-noprototypes',
     META_MERGE    => {
        configure_requires => \%pre_reqs,
+       x_deprecated => 1,
     },
     $gladexml->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-gladexml
+* Upstream URL: https://gitlab.gnome.org/Archive/libglade
+* Last upstream version: 2.6.4
+* Last upstream release date: 2009-03-17
+* Migration path for this module: Gtk3::Builder
+* Migration module URL: https://metacpan.org/pod/Gtk3
+
+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 84b472d..10dcd26 100644
--- a/README
+++ b/README
@@ -1,6 +1,31 @@
 Gtk2::GladeXML version 1.007
 ============================
 
+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-gladexml
+* Upstream URL: https://gitlab.gnome.org/Archive/libglade
+* Last upstream version: 2.6.4
+* Last upstream release date: 2009-03-17
+* Migration path for this module: Gtk3::Builder
+* Migration module URL: https://metacpan.org/pod/Gtk3
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+
 This package adds perl support for Glade 2.x to Gtk2-Perl.
 
 To discuss gtk2-perl, ask questions and flame/praise the authors,
diff --git a/perl-gtk2-gladexml.doap b/perl-gtk2-gladexml.doap
index f987c20..aaf25d8 100644
--- a/perl-gtk2-gladexml.doap
+++ b/perl-gtk2-gladexml.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gtk2-GladeXML</name>
+  <name xml:lang="en">Gtk2-GladeXML (DEPRECATED)</name>
   <shortdesc xml:lang="en">Create user interfaces directly from Glade XML files</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />