[perl-gtk2-mozembed/deprecation: 3/3] Added project deprecation notice

[Brian Manning <bmanning src gnome org>]

commit a648ba1dcd3a74d9891ba8a2bcff5bad70f1e271
Author: Brian Manning <brian xaoc org>
Date:   Thu Oct 15 18:52:04 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, lib/Gtk2/MozEmbed.pm, perl-gtk2-mozembed.doap

 Makefile.PL             | 30 +++++++++++++++++++++++++++++
 README                  | 25 +++++++++++++++++++++++++
 lib/Gtk2/MozEmbed.pm    | 50 ++++++++++++++++++++++++++++++++++++++++++++++++-
 perl-gtk2-mozembed.doap |  2 +-
 4 files changed, 105 insertions(+), 2 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index 8b87873..2735337 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -125,9 +125,39 @@ WriteMakefile(
     no_index => {
       file => [@xs_files],
     },
+    x_deprecated => 1,
   },
 );
 
+
+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-mozembed
+* Upstream URL: https://www-archive.mozilla.org/releases/mozilla1.7.13/
+* Last upstream version: 1.7.13
+* Last upstream release date: 2006-04-21
+* 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 8d2445f..29c28f3 100644
--- a/README
+++ b/README
@@ -2,6 +2,31 @@
                                Gtk2::MozEmbed
                               ----------------
 
+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-mozembed
+* Upstream URL: https://www-archive.mozilla.org/releases/mozilla1.7.13/
+* Last upstream version: 1.7.13
+* Last upstream release date: 2006-04-21
+* 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
+
+
 This module allows you to use the Mozilla embedding widget from Perl.
 
 Gtk2::MozEmbed comes with automatically generated API documentation.  Its index
diff --git a/lib/Gtk2/MozEmbed.pm b/lib/Gtk2/MozEmbed.pm
index 67dfb19..ae2d36c 100644
--- a/lib/Gtk2/MozEmbed.pm
+++ b/lib/Gtk2/MozEmbed.pm
@@ -64,7 +64,55 @@ See examples/pumzilla in the source tarball for a more complete example.
 
 =head1 ABSTRACT
 
-This module allows a Perl developer to use the Mozilla embedding widget.
+B<DEPRECATED> This module allows a Perl developer to use the Mozilla embedding
+widget.
+
+=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-mozembed
+
+=item *
+
+Upstream URL: https://www-archive.mozilla.org/releases/mozilla1.7.13/
+
+=item *
+
+Last upstream version: 1.7.13
+
+=item *
+
+Last upstream release date: 2006-04-21
+
+=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>
 
 =head1 SEE ALSO
 
diff --git a/perl-gtk2-mozembed.doap b/perl-gtk2-mozembed.doap
index ab3aa8e..2ff0c8c 100644
--- a/perl-gtk2-mozembed.doap
+++ b/perl-gtk2-mozembed.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gtk2::MozEmbed</name>
+  <name xml:lang="en">Gtk2::MozEmbed (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl interface to the Mozilla embedding widget</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />