[perl-gnome2-panelapplet/deprecation: 3/3] Added project deprecation notice

[Brian Manning <bmanning src gnome org>]

commit 4d703649133c052d87ac26f89102adf9657b58ed
Author: Brian Manning <bmanning src gnome org>
Date:   Thu Sep 24 16:45:22 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, lib/Gnome2/PanelApplet.pm,
      perl-gnome2-panelapplet.doap

 Makefile.PL                  | 27 ++++++++++++++++++++++++
 README                       | 25 ++++++++++++++++++++++
 lib/Gnome2/PanelApplet.pm    | 50 +++++++++++++++++++++++++++++++++++++++++++-
 perl-gnome2-panelapplet.doap |  2 +-
 4 files changed, 102 insertions(+), 2 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index f2a8098..2845e0f 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -90,6 +90,33 @@ WriteMakefile(
   $dep->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-gnome2-panelapplet
+* Upstream URLs: https://developer.gnome.org/panel-applet/ and https://gitlab.gnome.org/GNOME/gnome-applets
+* Last compatible upstream version: 2.32.1.1
+* Last compatible upstream release date: 2010-11-22
+* 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 ()
             . Glib::MakeHelper->postamble_docs_full (
diff --git a/README b/README
index 0f6c2ce..9475fa8 100644
--- a/README
+++ b/README
@@ -1,6 +1,31 @@
 Gnome2::Panel
 =============
 
+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-panelapplet
+* Upstream URLs: https://developer.gnome.org/panel-applet/ and https://gitlab.gnome.org/GNOME/gnome-applets
+* Last compatible upstream version: 2.32.1.1
+* Last compatible upstream release date: 2010-11-22
+* 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 you to create applets for the GNOME 2.0 Panel using Perl.
 
 INSTALLATION
diff --git a/lib/Gnome2/PanelApplet.pm b/lib/Gnome2/PanelApplet.pm
index 41ae74e..0f60347 100644
--- a/lib/Gnome2/PanelApplet.pm
+++ b/lib/Gnome2/PanelApplet.pm
@@ -84,10 +84,58 @@ Gnome2::PanelApplet - Perl interface to GNOME's applet library
 
 =head1 ABSTRACT
 
-Use Perl to write GNOME applets that sit on the panel.
+
+B<DEPRECATED> Use Perl to write GNOME applets that sit on the panel.
 
 =head1 DOCUMENTATION
 
+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-panelapplet
+
+=item *
+
+* Upstream URLs: https://developer.gnome.org/panel-applet/ and https://gitlab.gnome.org/GNOME/gnome-applets
+
+=item *
+
+* Last compatible upstream version: 2.32.1.1
+
+=item *
+
+* Last compatible upstream release date: 2010-11-22
+
+=item *
+
+* Migration path for this module: Gtk3::StatusIcon
+
+=item *
+
+* Migration module URL: https://metacpan.org/pod/Gtk3
+
+=item *
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
 I<Gnome2::PanelApplet::Factory-E<gt>main> is documented in
 L<Gnome2::PanelApplet::Factory>.  The methods you can call on the applet
 instance are documented in L<Gnome2::PanelApplet::main>.  The GConf helper
diff --git a/perl-gnome2-panelapplet.doap b/perl-gnome2-panelapplet.doap
index 23e675d..05b09e6 100644
--- a/perl-gnome2-panelapplet.doap
+++ b/perl-gnome2-panelapplet.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gnome2::PanelApplet</name>
+  <name xml:lang="en">Gnome2::PanelApplet (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl interface to GNOME's applet library</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />