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




commit 2d02e77c6df6cd9bde3e8ad1f4992b6680584b7a
Author: Brian Manning <brian xaoc org>
Date:   Sat Oct 17 20:04:19 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, Recent.pm, perl-gtk2-recent.doap

 Makefile.PL           | 31 +++++++++++++++++++++++++------
 README                | 25 +++++++++++++++++++++++++
 Recent.pm             | 50 ++++++++++++++++++++++++++++++++++++++++++++++++--
 perl-gtk2-recent.doap |  2 +-
 4 files changed, 99 insertions(+), 9 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index 7cc6e50..17ef611 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -90,20 +90,39 @@ WriteMakefile(
     XSPROTOARG    => '-noprototypes',
     META_MERGE    => {
        configure_requires => \%pre_reqs,
+       x_deprecated       => 1,
     },
     MAN3PODS      => \%pod_files,
     $recent->get_makefile_vars,
 );
 
-print "
-WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
 
-This module is deprecated by Gtk2 >= 1.130 and gtk+-2.0 >= 2.10.  You
-should not use this module inside your code.
+print <<__EON__;
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
 
-WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
+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-recent
+* Upstream URL: https://gitlab.gnome.org/Archive/libgnome
+* Last upstream version: 2.32.1
+* Last upstream release date: 2011-01-31
+* Migration path for this module: Gtk3::Recent*
+* Migration module URL: https://metacpan.org/pod/Gtk3
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+__EON__
 
 
 sub MY::postamble
diff --git a/README b/README
index 7eed3df..d221ffc 100644
--- a/README
+++ b/README
@@ -1,6 +1,31 @@
 Gtk2::Recent version 0.051
 ==========================
 
+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-recent
+* Upstream URL: https://gitlab.gnome.org/Archive/libgnome
+* Last upstream version: 2.32.1
+* Last upstream release date: 2011-01-31
+* Migration path for this module: Gtk3::Recent*
+* Migration module URL: https://metacpan.org/pod/Gtk3
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+
 This module allows a Perl programmer to access the Recently used Files list
 using the libegg component.
 
diff --git a/Recent.pm b/Recent.pm
index 58439e9..0111d99 100644
--- a/Recent.pm
+++ b/Recent.pm
@@ -83,11 +83,57 @@ Gtk2::Recent - Perl wrapper to the recent files spec Gtk implementation
 
 =head1 ABSTRACT
 
-Perl bindings to the recent files spec Gtk implementation, for use with
-gtk2-perl.
+B<DEPRECATED> Perl bindings to the recent files spec Gtk implementation, for
+use with 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-recent
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/Archive/libgnome
+
+=item *
+
+Last upstream version: 2.32.1
+
+=item *
+
+Last upstream release date: 2011-01-31
+
+=item *
+
+Migration path for this module: Gtk3::Recent*
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Gtk3
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
+
 This model allows you to access, modify and show the recent files list,
 using the recent files specification provided by freedesktop.org and
 implemented using the Gtk libraries.
diff --git a/perl-gtk2-recent.doap b/perl-gtk2-recent.doap
index 8eae1ec..3515b36 100644
--- a/perl-gtk2-recent.doap
+++ b/perl-gtk2-recent.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gtk2-Recent</name>
+  <name xml:lang="en">Gtk2-Recent (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl bindings to the recent files spec</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]