[perl-gnome2-wnck/deprecation: 2/2] Added project deprecation notice

[Brian Manning <bmanning src gnome org>]

commit c9c0e74432b30a2ab919034787b5e6d0ec9f47ed
Author: Brian Manning <bmanning src gnome org>
Date:   Sat Oct 3 17:45:50 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, Wnck.pm, perl-gnome2-wnck.doap

 Makefile.PL           | 30 ++++++++++++++++++++++++++++++
 README                | 24 ++++++++++++++++++++++++
 Wnck.pm               | 51 +++++++++++++++++++++++++++++++++++++++++++++++++--
 perl-gnome2-wnck.doap |  2 +-
 4 files changed, 104 insertions(+), 3 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index a921440..9388c25 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -87,8 +87,38 @@ WriteMakefile(
   $wnck->get_makefile_vars,
 
   EXTRA_META    => $configure_requires,
+  META_MERGE => {
+    x_deprecated => 1,
+  },
 );
 
+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-wnck
+* Upstream URL: https://gitlab.gnome.org/GNOME/libwnck
+* Last upstream version: 2.30.7
+* Last upstream release date: 2011-08-31
+* Migration path for this module: G:O:I
+* 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 ()
        . Glib::MakeHelper->postamble_docs_full (
diff --git a/README b/README
index 95b65cb..d7884df 100644
--- a/README
+++ b/README
@@ -1,6 +1,30 @@
                                 Gnome2::Wnck
                                --------------
 
+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-wnck
+* Upstream URL: https://gitlab.gnome.org/GNOME/libwnck
+* Last upstream version: 2.30.7
+* Last upstream release date: 2011-08-31
+* Migration path for this module: G:O:I
+* Migration module URL: https://metacpan.org/pod/Glib::Object::Introspection
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
 This module allows you to use the Window Navigator Construction Kit library
 (libwnck for short) from Perl.
 
diff --git a/Wnck.pm b/Wnck.pm
index b7aa54c..80ac966 100644
--- a/Wnck.pm
+++ b/Wnck.pm
@@ -43,8 +43,55 @@ Gnome2::Wnck - Perl interface to the Window Navigator Construction Kit
 
 =head1 ABSTRACT
 
-This module allows a Perl developer to use the Window Navigator Construction
-Kit library (libwnck for short) to write tasklists and pagers.
+B<DEPRECATED> This module allows a Perl developer to use the Window Navigator
+Construction Kit library (libwnck for short) to write tasklists and pagers.
+
+=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-wnck
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/GNOME/libwnck
+
+=item *
+
+Last upstream version: 2.30.7
+
+=item *
+
+Last upstream release date: 2011-08-31
+
+=item *
+
+Migration path for this module: G:O:I
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Glib::Object::Introspection
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
 
 =head1 SEE ALSO
 
diff --git a/perl-gnome2-wnck.doap b/perl-gnome2-wnck.doap
index 2d8cea9..bdfcd51 100644
--- a/perl-gnome2-wnck.doap
+++ b/perl-gnome2-wnck.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gnome2-Wnck</name>
+  <name xml:lang="en">Gnome2-Wnck (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl interface to the Window Navigator Construction Kit</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />