[perl-gnome2-print/deprecation: 4/5] Added/updated project deprecation notice

[Brian Manning <bmanning src gnome org>]

commit a9c596ddc292e4527b9b179842f290be363f5a8a
Author: Brian Manning <bmanning src gnome org>
Date:   Thu Sep 24 22:12:16 2020 -0700

    Added/updated project deprecation notice
    
    - There was an existing deprecation notice in some files, now there's
      deprecation notices pretty much *everywhere*

 Makefile.PL            | 39 ++++++++++++++++++++++------------
 Print.pm               | 57 +++++++++++++++++++++++++++++++++++++++++---------
 README                 | 37 ++++++++++++++++++++------------
 perl-gnome2-print.doap |  2 +-
 pm/Config.pm           | 51 +++++++++++++++++++++++++++++++++++++++++++-
 pm/Font.pm             | 52 ++++++++++++++++++++++++++++++++++++++++++++-
 6 files changed, 199 insertions(+), 39 deletions(-)
---
diff --git a/Makefile.PL b/Makefile.PL
index ab1a911..8076e95 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -96,19 +96,32 @@ WriteMakefile(
     $gnomeprint2->get_makefile_vars,
 );
 
-print <<__EOW__;
-WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
-
-  This module, like the libraries it binds, has been deprecated.
-  You should use GTK+ >= 2.10 and the Gtk2 bindings >= 1.140,
-  which provide a high level printing API.
-
-  For more information, see:
-
-  http://library.gnome.org/devel/gtk/stable/gtk-High-level-Printing-API.html
-
-WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
-__EOW__
+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-gnome2-print
+* Upstream URL: https://gitlab.gnome.org/Archive/libgnomeprint
+* Last upstream version: 2.18.8
+* Last upstream release date: 2010-09-28
+* Migration path for this module: Gtk3::Print*
+* Migration module URL: https://metacpan.org/pod/Gtk3
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+__EON__
 
 sub MY::postamble
 {
diff --git a/Print.pm b/Print.pm
index 1103c39..5482ec1 100644
--- a/Print.pm
+++ b/Print.pm
@@ -68,11 +68,56 @@ Gnome2::Print - Perl wrappers for the Gnome Print utilities.
 
 =head1 ABSTRACT
 
-Perl bindings to the 2.2 series of the Gnome Print libraries, for use
-with gtk2-perl.
+B<DEPRECATED> Perl bindings to the 2.2 series of the Gnome Print libraries,
+for use with gtk2-perl.
 
 =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-gnome2-print
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/Archive/libgnomeprint
+
+=item *
+
+Last upstream version: 2.18.8
+
+=item *
+
+Last upstream release date: 2010-09-28
+
+=item *
+
+Migration path for this module: Gtk3::Print*
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Gtk3
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
 This module allows you to use the GNOME Print libraries within your
 applications written using the gtk2-perl wrapper.  The GNOME Print libraries
 (also known as libgnomeprint and libgnomeprintui) allow you to create
@@ -84,14 +129,6 @@ join gtk-perl-list gnome org at lists.gnome.org.
 
 Find out more about GNOME at http://www.gnome.org.
 
-=head1 DEPRECATION WARNING
-
-With the release of GTK+ 2.10 both libgnomeprint and libgnomeprintui have
-been marked as deprecated and should not be used in newly released code.
-
-In order to use the new Print support in GTK+ you have to use the Gtk2
-module version E<gt>= 1.140 compiled against GTK+ E<gt>= 2.10.0.
-
 =head1 SEE ALSO
 
 L<perl>(1), L<Glib>(3pm), L<Gtk2>(3pm), L<Gnome2>(3pm).
diff --git a/README b/README
index 46404b5..e38ea3b 100644
--- a/README
+++ b/README
@@ -1,6 +1,30 @@
 Gnome2::Print version 1.000
 ===========================
 
+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-print
+* Upstream URL: https://gitlab.gnome.org/Archive/libgnomeprint
+* Last upstream version: 2.18.8
+* Last upstream release date: 2010-09-28
+* Migration path for this module: Gtk3::Print*
+* Migration module URL: https://metacpan.org/pod/Gtk3
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
 The Gnome2::Print module allows a perl developer to use the Gnome Printing
 libraries with Gtk2-Perl.  Find out more about Gnome+ at http://www.gnome.org.
 
@@ -13,19 +37,6 @@ join gtk-perl-list gnome org at lists.gnome.org.
 Also have a look at the gtk2-perl website and sourceforge project page,
 http://gtk2-perl.sourceforge.net
 
-WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
-
-This module, like the underlying libraries it binds, has been deprecated
-by the new high level printing API available since GTK+ 2.10 and wrapped
-by the Gtk2 Perl module since 1.140.
-
-For more information, see:
-
-http://library.gnome.org/devel/gtk/stable/gtk-High-level-Printing-API.html
-
-WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
-
-
 INSTALLATION
 
 To install this module type the following:
diff --git a/perl-gnome2-print.doap b/perl-gnome2-print.doap
index 3b3a79e..e9a1747 100644
--- a/perl-gnome2-print.doap
+++ b/perl-gnome2-print.doap
@@ -4,7 +4,7 @@
          xmlns:gnome="http://api.gnome.org/doap-extensions#";
          xmlns="http://usefulinc.com/ns/doap#";>
 
-  <name xml:lang="en">Gnome2-Print</name>
+  <name xml:lang="en">Gnome2-Print (DEPRECATED)</name>
   <shortdesc xml:lang="en">Perl wrappers for the Gnome Print utilities</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/pm/Config.pm b/pm/Config.pm
index a44cc7f..c3add4f 100644
--- a/pm/Config.pm
+++ b/pm/Config.pm
@@ -69,7 +69,7 @@ use constant GNOME_PRINT_KEY_PREFERED_UNIT => "Settings.Document.PreferedUnit"
 
 =head1 NAME
 
-Gnome2::Print::Config::Constants - constants for use with Gnome2::Print::Config
+Gnome2::Print::Config::Constants
 
 =head1 SYNOPSIS
 
@@ -77,8 +77,57 @@ Gnome2::Print::Config::Constants - constants for use with Gnome2::Print::Config
 
   use Gnome2::Print::Config::Constants; # load extra constants
 
+=head1 ABSTRACT
+
+B<DEPRECATED> Constants for use with Gnome2::Print::Config
+
 =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-gnome2-print
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/Archive/libgnomeprint
+
+=item *
+
+Last upstream version: 2.18.8
+
+=item *
+
+Last upstream release date: 2010-09-28
+
+=item *
+
+Migration path for this module: Gtk3::Print*
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Gtk3
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
 Similarily to Pango, in order to effectively use Gnome2::Print::Config you need
 a few constants that are not supplied by the type system or by other means.
 
diff --git a/pm/Font.pm b/pm/Font.pm
index 2431950..1bd41cd 100644
--- a/pm/Font.pm
+++ b/pm/Font.pm
@@ -43,7 +43,7 @@ use constant GNOME_FONT_HEAVIEST => 1100;
 
 =head1 NAME
 
-Gnome2::Print::Font::Constants - constants for use with Gnome2::Print::Font
+Gnome2::Print::Font::Constants
 
 =head1 SYNOPSIS
 
@@ -51,8 +51,58 @@ Gnome2::Print::Font::Constants - constants for use with Gnome2::Print::Font
 
   use Gnome2::Print::Font::Constants; # load extra constants
 
+=head1 ABSTRACT
+
+B<DEPRECATED> Constants for use with Gnome2::Print::Font
+
 =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-gnome2-print
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/Archive/libgnomeprint
+
+=item *
+
+Last upstream version: 2.18.8
+
+=item *
+
+Last upstream release date: 2010-09-28
+
+=item *
+
+Migration path for this module: Gtk3::Print*
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Gtk3
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
+
 Similarily to Pango, in order to effectively use Gnome2::Print::Font you need
 a few constants that are not supplied by the type system or by other means.