[perl-gnome2-canvas: 2/5] Added deprecation notices to all files with documentation

[Brian Manning <bmanning src gnome org>]

commit 4399e458b0119bcaeacce2555ff6bc8d65ddbdf2
Author: Brian Manning <bmanning src gnome org>
Date:   Mon Sep 21 22:39:18 2020 -0700

    Added deprecation notices to all files with documentation
    
    - Makefile.PL, README, perl-Gnome2-Canvas.doap, xs/GnomeCanvas.xs

 Canvas.pm               |  2 +-
 META.yml                |  2 ++
 Makefile.PL             | 29 ++++++++++++++++++++++++++++-
 README                  | 25 +++++++++++++++++++++++++
 perl-gnome2-canvas.doap |  2 +-
 xs/GnomeCanvas.xs       |  2 +-
 6 files changed, 58 insertions(+), 4 deletions(-)
---
diff --git a/Canvas.pm b/Canvas.pm
index ca0b3b8..f328b04 100644
--- a/Canvas.pm
+++ b/Canvas.pm
@@ -32,7 +32,7 @@ __END__
 
 =head1 NAME
 
-Gnome2::Canvas - A structured graphics canvas
+Gnome2::Canvas - (DEPRECATED) A structured graphics canvas
 
 =head1 SYNOPSIS
 
diff --git a/META.yml b/META.yml
index 7faa8a0..540caef 100644
--- a/META.yml
+++ b/META.yml
@@ -1,5 +1,6 @@
 #XXXXXXX This is a prototype!!!  It will change in the future!!! XXXXX#
 name:         Gnome2-Canvas
+abstract:     (DEPRECATED) A structured graphics canvas
 version:      1.004
 version_from: Canvas.pm
 installdirs:  site
@@ -12,3 +13,4 @@ configure_requires:
   Glib: '1.120'
 distribution_type: module
 generated_by: ExtUtils::MakeMaker version 6.10_03
+x_deprecated: 1
diff --git a/Makefile.PL b/Makefile.PL
index e744c8c..c7f83b5 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -83,13 +83,40 @@ $gnomecanvas->save_config ('build/IFiles.pm');
 WriteMakefile(
     NAME            => 'Gnome2::Canvas',
     VERSION_FROM    => 'Canvas.pm', # finds $VERSION
-    ABSTRACT        => 'Perl bindings for the 2.x series of the Gnome Canvas widget',
+    ABSTRACT        => '(DEPRECATED) A structured graphics canvas',
     XSPROTOARG      => '-noprototypes',
     MAN3PODS        => \%pod_files,
     NO_META         => 1,
     $gnomecanvas->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, 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-gnome2-canvas
+* Upstream URL: https://gitlab.gnome.org/Archive/libgnomecanvas
+* Last upstream version: 2.30.3
+* Last upstream release date: 2011-01-31
+* Migration path for this module: Cairo
+* Migration module URL: https://metacpan.org/pod/Cairo
+
+
+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 0f73585..e0e3b1d 100644
--- a/README
+++ b/README
@@ -1,6 +1,31 @@
 Gnome2::Canvas version 1.004
 ============================
 
+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-gnome2-canvas
+* Upstream URL: https://gitlab.gnome.org/Archive/libgnomecanvas
+* Last upstream version: 2.30.3
+* Last upstream release date: 2011-01-31
+* Migration path for this module: Cairo
+* Migration module URL: https://metacpan.org/pod/Cairo
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+
 The Gnome2::Canvas module allows a perl developer to use the GnomeCanvas
 widget with Gtk2-Perl.  Find out more about Gnome+ at http://www.gnome.org.
 
diff --git a/perl-gnome2-canvas.doap b/perl-gnome2-canvas.doap
index 5e20c8a..24d01a1 100644
--- a/perl-gnome2-canvas.doap
+++ b/perl-gnome2-canvas.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gnome2-Canvas</name>
+  <name xml:lang="en">(DEPRECATED) Gnome2-Canvas</name>
   <shortdesc xml:lang="en">Allows a perl developer to use the GnomeCanvas widget</shortdesc>
   <homepage rdf:resource="http://gtk2-perl.sourceforge.net/"; />
   <mailing-list rdf:resource="http://mail.gnome.org/mailman/listinfo/gtk-perl-list"; />
diff --git a/xs/GnomeCanvas.xs b/xs/GnomeCanvas.xs
index 8fc078a..778b743 100644
--- a/xs/GnomeCanvas.xs
+++ b/xs/GnomeCanvas.xs
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003 by the gtk2-perl team (see the file AUTHORS)
+ * Copyright (c) 2003-2004 by the gtk2-perl team (see the file AUTHORS)
  *
  * This library is free software; you can redistribute it and/or
  * modify it under the terms of the GNU Library General Public