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

[Brian Manning <bmanning src gnome org>]

commit 8c7daefbd14036eb4965c3d19cbf0edd08d6f34b
Author: Brian Manning <bmanning src gnome org>
Date:   Tue Oct 20 11:39:00 2020 -0700

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

 Makefile.PL          | 29 ++++++++++++++++++++++++++++
 README               | 25 ++++++++++++++++++++++++
 lib/Gtk2/Spell.pm    | 54 ++++++++++++++++++++++++++++++++++++++++++++++++----
 perl-gtk2-spell.doap |  2 +-
 4 files changed, 105 insertions(+), 5 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index ac58030..12e7d68 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -69,6 +69,7 @@ WriteMakefile(
     ABSTRACT_FROM => 'lib/Gtk2/Spell.pm',
     META_MERGE    => {
         configure_requires => \%pre_reqs,
+        x_deprecated       => 1,
     },
     XSPROTOARG    => '-noprototypes',
     $gtk2spell->get_makefile_vars,
@@ -76,6 +77,34 @@ WriteMakefile(
 
 use Cwd;
 
+
+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-spell
+* Upstream URL: http://gtkspell.sourceforge.net/
+* Last upstream version: 2.0.16
+* Last upstream release date: 2009-10-22
+* Migration path for this module: G:O:I
+* Migration module URL: https://metacpan.org/pod/Glib::Object::Introspection
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+__EON__
+
 sub MY::postamble
 {
        return Glib::MakeHelper->postamble_clean ()
diff --git a/README b/README
index aad4ecf..74f1e91 100644
--- a/README
+++ b/README
@@ -3,6 +3,31 @@
 Gtk2::Spell version 1.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-spell
+* Upstream URL: http://gtkspell.sourceforge.net/
+* Last upstream version: 2.0.16
+* Last upstream release date: 2009-10-22
+* Migration path for this module: G:O:I
+* Migration module URL: https://metacpan.org/pod/Glib::Object::Introspection
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+
 Perl bindings to the 2.x series of the GtkSpell graphical user interface
 library.  This module allows you to write perl applications that utilize the
 GtkSpell library for mis-spelled word highlighting.
diff --git a/lib/Gtk2/Spell.pm b/lib/Gtk2/Spell.pm
index 2a61a7d..233d64a 100644
--- a/lib/Gtk2/Spell.pm
+++ b/lib/Gtk2/Spell.pm
@@ -44,11 +44,57 @@ Gtk2::Spell - Bindings for GtkSpell with Gtk2
 
 =head1 ABSTRACT
 
-  Perl bindings to GtkSpell, used in concert with Gtk2::TextView.
+B<DEPRECATED> Perl bindings to GtkSpell, used in concert with Gtk2::TextView.
 
 =head1 DESCRIPTION
 
-Perl bindings to GtkSpell, used in concert with Gtk2::TextView. Provides 
+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-spell
+
+=item *
+
+Upstream URL: http://gtkspell.sourceforge.net/
+
+=item *
+
+Last upstream version: 2.0.16
+
+=item *
+
+Last upstream release date: 2009-10-22
+
+=item *
+
+Migration path for this module: G:O:I
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Glib::Object::Introspection
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
+
+Perl bindings to GtkSpell, used in concert with Gtk2::TextView. Provides
 mis-spelled word highlighting in red and offers a right click pop-up menu with
 suggested corrections.
 
@@ -60,11 +106,11 @@ suggested corrections.
 
 =item $spell = Gtk2::Spell->new_attach(GTK2_TEXT_VIEW)
 
-Creates and returns a new Gtk2::Spell object attached to GTK2_TEXT_VIEW. 
+Creates and returns a new Gtk2::Spell object attached to GTK2_TEXT_VIEW.
 
 =item $spell->set_language(LANG_STR)
 
-Sets the language which the underlying spell-checker will use. According to the 
+Sets the language which the underlying spell-checker will use. According to the
 GtkSpell API reference this 'appears to be a locale specifier.'
 
 =item $spell->recheck_all
diff --git a/perl-gtk2-spell.doap b/perl-gtk2-spell.doap
index e256ea6..ce12544 100644
--- a/perl-gtk2-spell.doap
+++ b/perl-gtk2-spell.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gtk2::Spell</name>
+  <name xml:lang="en">Gtk2::Spell (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl bindings for GtkSpell</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />