[perl-gstreamer-interfaces/deprecation] Added project deprecation notice

[Brian Manning <bmanning src gnome org>]

commit 92132f046cb4e49d6942e07079d3c755101a8166
Author: Brian Manning <bmanning src gnome org>
Date:   Tue Oct 13 23:10:31 2020 -0700

    Added project deprecation notice
    
    - Makefile.PL, README, Interfaces.pm, perl-gstreamer-interfaces.doap

 Makefile.PL                    | 27 +++++++++++++++++++++++
 README                         | 24 +++++++++++++++++++++
 lib/GStreamer/Interfaces.pm    | 49 +++++++++++++++++++++++++++++++++++++++---
 perl-gstreamer-interfaces.doap |  2 +-
 4 files changed, 98 insertions(+), 4 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index 058c817..8f7e9f0 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -87,11 +87,38 @@ WriteMakefile(
 
   META_MERGE    => {
     configure_requires => \%pre_reqs,
+    x_deprecated => 1,
   },
 
   $gst->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-gstreamer-interfaces
+* Upstream URL: None
+* Last upstream version: N/A
+* Last upstream release date: N/A
+* Migration path for this module: no upstream replacement
+
+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 77a9d06..eba643f 100644
--- a/README
+++ b/README
@@ -2,6 +2,30 @@
                             GStreamer::Interfaces
                            -----------------------
 
+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-gstreamer-interfaces
+* Upstream URL: None
+* Last upstream version: N/A
+* Last upstream release date: N/A
+* Migration path for this module: no upstream replacement
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+
 GStreamer::Interfaces provides access to some of the interfaces in the
 GStreamer Interfaces library.  Currently, that's GStreamer::PropertyProbe and
 GStreamer::XOverlay.
diff --git a/lib/GStreamer/Interfaces.pm b/lib/GStreamer/Interfaces.pm
index 88ff75f..461dcf5 100644
--- a/lib/GStreamer/Interfaces.pm
+++ b/lib/GStreamer/Interfaces.pm
@@ -47,9 +47,52 @@ GStreamer::Interfaces - Perl interface to the GStreamer Interfaces library
 
 =head1 ABSTRACT
 
-GStreamer::Interfaces provides access to some of the interfaces in the
-GStreamer Interfaces library.  Currently, that's L<GStreamer::PropertyProbe>
-and L<GStreamer::XOverlay>.
+B<DEPRECATED> GStreamer::Interfaces provides access to some of the interfaces
+in the GStreamer Interfaces library.  Currently, that's
+L<GStreamer::PropertyProbe> and L<GStreamer::XOverlay>.
+
+=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-gstreamer-interfaces
+
+=item *
+
+Upstream URL: None
+
+=item *
+
+Last upstream version: N/A
+
+=item *
+
+Last upstream release date: N/A
+
+=item *
+
+Migration path for this module: no upstream replacement
+
+=back
+
+B<NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE>
 
 =head1 INTERFACES
 
diff --git a/perl-gstreamer-interfaces.doap b/perl-gstreamer-interfaces.doap
index 47d59de..d12c340 100644
--- a/perl-gstreamer-interfaces.doap
+++ b/perl-gstreamer-interfaces.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">GStreamer::Interfaces</name>
+  <name xml:lang="en">GStreamer::Interfaces (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl interface to the GStreamer Interfaces library</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />