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

[Brian Manning <bmanning src gnome org>]

commit ef385c568afc2f98a8d1be39f4b6257908a512e7
Author: Brian Manning <bmanning src gnome org>
Date:   Tue Oct 20 20:40:52 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, TrayManager.pm, perl-gtk2-traymanager.doap

 Makefile.PL                | 30 +++++++++++++++++++++++++++-
 README                     | 24 ++++++++++++++++++++++
 TrayManager.pm             | 50 +++++++++++++++++++++++++++++++++++++++++++---
 perl-gtk2-traymanager.doap |  2 +-
 4 files changed, 101 insertions(+), 5 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index 8ac68a3..d39b6d3 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -80,16 +80,44 @@ $traymanager->add_typemaps (map {File::Spec->catfile($cwd,$_)} 'build/traymanage
 WriteMakefile(
     NAME            => 'Gtk2::TrayManager',
     VERSION_FROM    => 'TrayManager.pm', # finds $VERSION
-    # ABSTRACT_FROM   => 'TrayManager.pm', # retrieve abstract from module
+    ABSTRACT_FROM   => 'TrayManager.pm', # retrieve abstract from module
     XSPROTOARG      => '-noprototypes',
     $traymanager->get_makefile_vars,
     META_MERGE    => {
         configure_requires => \%pre_reqs,
+        x_deprecated       => 1,
     },
 );
 
 use Cwd;
 
+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-traymanager
+* Upstream URL: N/A
+* Last upstream version: N/A
+* Last upstream release date: N/A
+* Migration path for this module: N/A
+
+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 65b72d4..0d80b26 100644
--- a/README
+++ b/README
@@ -7,3 +7,27 @@ Gtk2-Perl.
 The module requires Gtk2 to be installed. But includes the code for
 eggtraymanager in the distribution.
 
+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-traymanager
+* Upstream URL: N/A
+* Last upstream version: N/A
+* Last upstream release date: N/A
+* Migration path for this module: N/A
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+
diff --git a/TrayManager.pm b/TrayManager.pm
index d57e975..ddb1f48 100644
--- a/TrayManager.pm
+++ b/TrayManager.pm
@@ -27,7 +27,7 @@ written by Gavin Brown <gavin brown uk com>
 
 =head1 NAME
 
-Gtk2::TrayManager - Perl bindings for EggTrayManager
+Gtk2::TrayManager - (DEPRECATED) Perl bindings for EggTrayManager
 
 =head1 SYNOPSIS
 
@@ -55,11 +55,55 @@ Gtk2::TrayManager - Perl bindings for EggTrayManager
 
 =head1 ABSTRACT
 
-The EggTrayManager library is used internally by GNOME to implement the
-server-side of the Notification Area (or system tray) protocol.
+B<DEPRECATED> The EggTrayManager library is used internally by GNOME to
+implement the server-side of the Notification Area (or system tray) protocol.
 Gtk2::TrayManager allows you to create notification area applications using
 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-traymanager
+
+=item *
+
+Upstream URL: N/A
+
+=item *
+
+Last upstream version: N/A
+
+=item *
+
+Last upstream release date: N/A
+
+=item *
+
+Migration path for this module: N/A
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
+
 =head1 METHODS
 
        $running = Gtk2::TrayManager->check_running($screen);
diff --git a/perl-gtk2-traymanager.doap b/perl-gtk2-traymanager.doap
index 5365751..c485c3e 100644
--- a/perl-gtk2-traymanager.doap
+++ b/perl-gtk2-traymanager.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gtk2::TrayManager</name>
+  <name xml:lang="en">Gtk2::TrayManager (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl interface to the EggTrayManager library</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />