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

[Brian Manning <bmanning src gnome org>]

commit 19ad5742ef6e9193c2a642e5245ac59350105fd8
Author: Brian Manning <bmanning src gnome org>
Date:   Sat Oct 17 21:17:38 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, SourceView.pm, perl-gtk2-sourceview.doap

 Makefile.PL               | 36 +++++++++++++++++++++++++---------
 README                    | 25 ++++++++++++++++++++++++
 SourceView.pm             | 49 ++++++++++++++++++++++++++++++++++++++++++++++-
 perl-gtk2-sourceview.doap |  2 +-
 4 files changed, 101 insertions(+), 11 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index 32aed80..a3d855c 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -89,20 +89,38 @@ WriteMakefile(
     PREREQ_PM     => \%prereqs,
     ABSTRACT_FROM => 'SourceView.pm', # retrieve abstract from module
     XSPROTOARG    => '-noprototypes',
-    MAN3PODS     => \%pod_files,
+    META_MERGE    => { x_deprecated => 1, },
+    MAN3PODS      => \%pod_files,
     $sview->get_makefile_vars,
 );
 
-print <<__EOW__;
-WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
 
-   This is an unstable development release of Gtk2::SourceView.
-   The API is not frozen and things are subject to change at any
-   time.  Report any bugs to gtk-perl-list AT gnome DOT org as
-   soon as possible. Please use the 1.00x series for important work.
+print <<__EON__;
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
 
-WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
-__EOW__
+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-sourceview
+* Upstream URL: https://gitlab.gnome.org/GNOME/gtksourceview
+* Last compatible upstream version: 1.8.6
+* Last upstream release date: 2007-05-01
+* 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
 {
diff --git a/README b/README
index a831adb..9816153 100644
--- a/README
+++ b/README
@@ -1,6 +1,31 @@
 Gtk2::SourceView version 1.010
 ==============================
 
+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-sourceview
+* Upstream URL: https://gitlab.gnome.org/GNOME/gtksourceview
+* Last compatible upstream version: 1.8.6
+* Last upstream release date: 2007-05-01
+* 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 1.x series of the GtkSourceView widget libraries.  This
 module allows you to write Perl applications that utilize the GtkSourceView
 library for source editing.
diff --git a/SourceView.pm b/SourceView.pm
index 60449cb..7f35fa7 100644
--- a/SourceView.pm
+++ b/SourceView.pm
@@ -109,10 +109,57 @@ Gtk2::SourceView - Perl wrappers for the GtkSourceView widget
 
 =head1 ABSTRACT
 
-Perl bindings to the 1.x series of the GtkSourceView widget libraries.
+B<DEPRECATED> Perl bindings to the 1.x series of the GtkSourceView widget
+libraries.
 
 =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-sourceview
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/GNOME/gtksourceview
+
+=item *
+
+Last compatible upstream version: 1.8.6
+
+=item *
+
+Last upstream release date: 2007-05-01
+
+=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 the 1.x series of the GtkSourceView widget libraries.  This
 module allows you to write Perl applications that utilize the GtkSourceView
 library for source editing and printing.
diff --git a/perl-gtk2-sourceview.doap b/perl-gtk2-sourceview.doap
index b62e9ea..6d846e7 100644
--- a/perl-gtk2-sourceview.doap
+++ b/perl-gtk2-sourceview.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gtk2-SourceView</name>
+  <name xml:lang="en">Gtk2-SourceView (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl wrappers for the GtkSourceView widget</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />