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




commit 7d2a800eb6eaa9a47cc2933a6b1fd6760cf226b9
Author: Brian Manning <bmanning src gnome org>
Date:   Thu Oct 15 12:57:56 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, Html2.pm, perl-gtk2-html2.doap

 Html2.pm             | 51 +++++++++++++++++++++++++++++++++++++++++++++++++++
 Makefile.PL          | 47 ++++++++++++++++++++++++++++++++++++++++-------
 README               | 26 +++++++++++++++++++++++++-
 perl-gtk2-html2.doap |  2 +-
 4 files changed, 117 insertions(+), 9 deletions(-)
---
diff --git a/Html2.pm b/Html2.pm
index 6d98340..4b0d32f 100644
--- a/Html2.pm
+++ b/Html2.pm
@@ -57,8 +57,59 @@ Gtk2::Html2 - HTML Viewer widget for Gtk2-Perl
  
  ...
 
+=head1 ABSTRACT
+
+B<DEPRECATED>The Gtk2::Html2 extension allows a perl developer to use the
+gtkhtml2 html display widget 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-html2
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/Archive/gtkhtml2
+
+=item *
+
+Last upstream version: 2.11.1
+
+=item *
+
+Last upstream release date: 2007-08-13
+
+=item *
+
+Migration path for this module: maybe Gtk3::WebKit
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Gtk3::WebKit
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
+
 The Gtk2::Html2 extension allows a perl developer to use the gtkhtml2 html
 display widget with Gtk2-Perl.
 
diff --git a/Makefile.PL b/Makefile.PL
index 468eb75..d2d8181 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -17,6 +17,13 @@ our %build_reqs = (
        'gtkhtml2'                => '2.0.0',
 );
 
+our %pre_reqs = (
+   'Glib'                  => $build_reqs{'perl-Glib'},
+   'Gtk2'                  => $build_reqs{'perl-Gtk2'},
+   'ExtUtils::Depends'     => $build_reqs{'perl-ExtUtils-Depends'},
+   'ExtUtils::PkgConfig'   => $build_reqs{'perl-ExtUtils-PkgConfig'},
+);
+
 # Writing a fake Makefile ensures that CPAN will pick up the correct
 # dependencies and install them.
 unless (eval "use ExtUtils::Depends '$build_reqs{'perl-ExtUtils-Depends'}';"
@@ -31,12 +38,7 @@ unless (eval "use ExtUtils::Depends '$build_reqs{'perl-ExtUtils-Depends'}';"
    warn "$@\n";
    WriteMakefile(
          PREREQ_FATAL => 1,
-         PREREQ_PM    => {
-            Glib::                => $build_reqs{'perl-Glib'},
-            Gtk2::                => $build_reqs{'perl-Gtk2'},
-            ExtUtils::Depends::   => $build_reqs{'perl-ExtUtils-Depends'},
-            ExtUtils::PkgConfig:: => $build_reqs{'perl-ExtUtils-PkgConfig'},
-         },
+         PREREQ_PM    => { \%pre_reqs },
    );
    exit 1; # not reached
 }
@@ -74,13 +76,44 @@ $gtkhtml2->save_config ('build/IFiles.pm');
 WriteMakefile(
     NAME            => 'Gtk2::Html2',
     VERSION_FROM    => 'Html2.pm', # finds $VERSION
-    ABSTRACT        => 'Perl bindings for the GtkHtml2 Html display widget',
+    ABSTRACT        => 'DEPRECATED Perl bindings for the GtkHtml2 Html display widget',
+    PREREQ_PM       => { \%pre_reqs },
     XSPROTOARG      => '-noprototypes',
+    META_MERGE    => {
+       configure_requires => \%pre_reqs,
+       x_deprecated => 1,
+    },
     MAN3PODS        => \%pod_files,
     $gtkhtml2->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-gtk2-html2
+* Upstream URL: https://gitlab.gnome.org/Archive/gtkhtml2
+* Last upstream version: 2.11.1
+* Last upstream release date: 2007-08-13
+* Migration path for this module: maybe Gtk3::WebKit
+* Migration module URL: https://metacpan.org/pod/Gtk3::WebKit
+
+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 7fdf434..1698084 100644
--- a/README
+++ b/README
@@ -1,7 +1,31 @@
-
 Gtk2::Html2 version 0.04
 ========================
 
+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-html2
+* Upstream URL: https://gitlab.gnome.org/Archive/gtkhtml2
+* Last upstream version: 2.11.1
+* Last upstream release date: 2007-08-13
+* Migration path for this module: maybe Gtk3::WebKit
+* Migration module URL: https://metacpan.org/pod/Gtk3::WebKit
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+
 The Gtk2::Html2 extension allows a perl developer to use the gtkhtml2 html
 display widget with Gtk2-Perl.
 
diff --git a/perl-gtk2-html2.doap b/perl-gtk2-html2.doap
index 4f59b9c..359f882 100644
--- a/perl-gtk2-html2.doap
+++ b/perl-gtk2-html2.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gtk2-Html2</name>
+  <name xml:lang="en">Gtk2-Html2 (DEPRECATED)</name>
   <shortdesc xml:lang="en">HTML Viewer widget for Gtk2-Perl</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]