GNOME.org
 

[perl-gnome2-vte/deprecation] Added deprecation notices to all files with documentation


commit c02cacfa78f084ebb9bcea7f2e3e2181920cf5eb
Author: Brian Manning <bmanning src gnome org>
Date:   Fri Oct 2 20:40:58 2020 -0700

    Added deprecation notices to all files with documentation
    
    - Makefile.PL, README, perl-gnome2-vte.doap, Vte.pm

 Makefile.PL          | 30 +++++++++++++++++++++++++++++-
 README               | 24 ++++++++++++++++++++++++
 Vte.pm               | 49 +++++++++++++++++++++++++++++++++++++++++++++++--
 perl-gnome2-vte.doap |  2 +-
 4 files changed, 101 insertions(+), 4 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index eb4fd9e..2092cd4 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -28,8 +28,9 @@ my %meta_merge = (
         version => '2',
         url     => 'http://search.cpan.org/perldoc?CPAN::Meta::Spec',
     },
+    x_deprecated => 1,
     author              =>
-        ['Cairo Perl Team <gtk-perl-list at gnome dot org>'],
+        ['Gtk-Perl Team <gtk-perl-list at gnome dot org>'],
     release_status      => 'stable',
     # valid values: https://metacpan.org/module/CPAN::Meta::Spec#license
     license             => 'lgpl_2_1',
@@ -116,6 +117,33 @@ WriteMakefile(
   $vte->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-vfs
+* Upstream URL: https://gitlab.gnome.org/Archive/gnome-vfs
+* Last upstream version: 2.24.4
+* Last upstream release date: 2010-09-28
+* Migration path for this module: Glib::IO
+* Migration module URL: https://metacpan.org/pod/Glib::IO
+
+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 8b4f3cd..6bf66cf 100644
--- a/README
+++ b/README
@@ -2,6 +2,30 @@
                                  Gnome2::Vte
                                 -------------
 
+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-vfs
+* Upstream URL: https://gitlab.gnome.org/Archive/gnome-vfs
+* Last upstream version: 2.24.4
+* Last upstream release date: 2010-09-28
+* Migration path for this module: Glib::IO
+* Migration module URL: https://metacpan.org/pod/Glib::IO
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
 This module allows you to use the Virtual Terminal Emulation library (libvte
 for short) from Perl.
 
diff --git a/Vte.pm b/Vte.pm
index 63b5406..2146f76 100644
--- a/Vte.pm
+++ b/Vte.pm
@@ -64,8 +64,53 @@ Gnome2::Vte - Perl interface to the Virtual Terminal Emulation library
 
 =head1 ABSTRACT
 
-This module allows a Perl developer to use the Virtual Terminal Emulator
-library (libvte for short).
+B<DEPRECATED> This module allows a Perl developer to use the Virtual Terminal
+Emulator library (libvte for short).
+
+=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-vfs
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/Archive/gnome-vfs
+
+=item *
+
+Last upstream version: 2.24.4
+
+=item *
+
+Last upstream release date: 2010-09-28
+
+=item *
+
+Migration path for this module: Glib::IO
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Glib::IO
+
+=back
 
 =head1 SEE ALSO
 
diff --git a/perl-gnome2-vte.doap b/perl-gnome2-vte.doap
index 915d1e0..546c704 100644
--- a/perl-gnome2-vte.doap
+++ b/perl-gnome2-vte.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gnome2::Vte</name>
+  <name xml:lang="en">Gnome2::Vte (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl interface to the Virtual Terminal Emulation library</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]