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

[Brian Manning <bmanning src gnome org>]

commit adebb37b9b08f290d0fe1d4b27e7ee31a03b0609
Author: Brian Manning <bmanning src gnome org>
Date:   Tue Oct 20 14:18:48 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, TrayIcon.pm, perl-gtk2-trayicon.doap

 Makefile.PL             | 28 +++++++++++++++++++++++++++
 README                  | 25 +++++++++++++++++++++++++
 TrayIcon.pm             | 50 +++++++++++++++++++++++++++++++++++++++++++++++--
 perl-gtk2-trayicon.doap |  2 +-
 4 files changed, 102 insertions(+), 3 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index 63a509a..dee87a5 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -70,11 +70,39 @@ WriteMakefile(
     $trayicon->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-trayicon
+* Upstream URL: https://gitlab.gnome.org/GNOME/libegg
+* Last upstream version: N/A
+* Last upstream release date: 2009-05-01
+* Migration path for this module: Gtk3::StatusIcon
+* 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 ef5108d..f15faae 100644
--- a/README
+++ b/README
@@ -1,5 +1,30 @@
 README for Gtk2::TrayIcon
 
+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-trayicon
+* Upstream URL: https://gitlab.gnome.org/GNOME/libegg
+* Last upstream version: N/A
+* Last upstream release date: 2009-05-01
+* Migration path for this module: Gtk3::StatusIcon
+* Migration module URL: https://metacpan.org/pod/Gtk3
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+
 This module allows a Perl developer to embed an arbitrary widget in a
 System Tray like the Gnome notification area.
 
diff --git a/TrayIcon.pm b/TrayIcon.pm
index c41df5f..d29a6ef 100644
--- a/TrayIcon.pm
+++ b/TrayIcon.pm
@@ -40,11 +40,57 @@ Gtk2::TrayIcon - Perl interface to the EggTrayIcon library
 
 =head1 ABSTRACT
 
-This module allows a Perl developer to embed an arbitrary widget
+B<DEPRECATED> This module allows a Perl developer to embed an arbitrary widget
 in a System Tray like the Gnome notification area.
 
 =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-trayicon
+
+=item *
+
+* Upstream URL: https://gitlab.gnome.org/GNOME/libegg
+
+=item *
+
+* Last upstream version: N/A
+
+=item *
+
+* Last upstream release date: 2009-05-01
+
+=item *
+
+* Migration path for this module: Gtk3::StatusIcon
+
+=item *
+
+* Migration module URL: https://metacpan.org/pod/Gtk3
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
+
 EggTrayIcon is slated for inclusion in Gtk+ at some point, which is the
 reason the C<Gtk2::TrayIcon> namespace. As all egg libs, EggTrayIcon
 is not considered api stable and its not installed as a shared object.
@@ -53,7 +99,7 @@ Enough about what it is not, C<Gtk2::TrayIcon> is first and foremost
 a simple way of giving a Gtk2 script access to the system tray.
 
 System Trays are found in both KDE and Gnome. But neither support the
-spec fully (see below). 
+spec fully (see below).
 
 C<Gtk2::TrayIcon> is a subclass of C<Gtk2::Plug> and should be used
 as such.
diff --git a/perl-gtk2-trayicon.doap b/perl-gtk2-trayicon.doap
index 3f7b293..bf54878 100644
--- a/perl-gtk2-trayicon.doap
+++ b/perl-gtk2-trayicon.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gtk2::TrayIcon</name>
+  <name xml:lang="en">Gtk2::TrayIcon (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl interface to the EggTrayIcon library</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />