[perl-gnome2-gconf/deprecation: 1/2] Added deprecation notice to text/docs

[Brian Manning <bmanning src gnome org>]

commit 043a32620d309a1def721420a40174419f47bed1
Author: Brian Manning <bmanning src gnome org>
Date:   Thu Aug 20 21:26:41 2020 -0700

    Added deprecation notice to text/docs

 GConf.pm    | 48 +++++++++++++++++++++++++++++++++++++++++++++++-
 Makefile.PL | 39 +++++++++++++++++++++++++++------------
 README      | 25 +++++++++++++++++++++++++
 3 files changed, 99 insertions(+), 13 deletions(-)
---
diff --git a/GConf.pm b/GConf.pm
index 4035d28..ccf510e 100644
--- a/GConf.pm
+++ b/GConf.pm
@@ -147,11 +147,57 @@ Gnome2::GConf - Perl wrappers for the GConf configuration engine.
 
 =head1 ABSTRACT
 
-Perl bindings to the 2.2 series of the GConf configuration engine
+(DEPRECATED) Perl bindings to the 2.2 series of the GConf configuration engine
 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, 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-gconf
+
+=item *
+
+Upstream URL: https://gitlab.gnome.org/Archive/gconf
+
+=item *
+
+Last upstream version: 3.2.6
+
+=item *
+
+Last upstream release date: 2013-01-21
+
+=item *
+
+Migration path for this module: Glib::IO::Settings
+
+=item *
+
+Migration module URL: https://metacpan.org/pod/Glib::IO
+
+=back
+
+B<NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE>
+
+
 This module allows you to use the GConf configuration system in order
 to store/retrieve the configuration of an application.  The GConf
 system is a powerful configuration manager based on a user daemon that
diff --git a/Makefile.PL b/Makefile.PL
index 2f8eaae..c5228d0 100644
--- a/Makefile.PL
+++ b/Makefile.PL
@@ -94,18 +94,33 @@ WriteMakefile(
     $gconf->get_makefile_vars,
 );
 
-#print "
-#WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
-#
-#This is an unstable development release of Gnome2::GConf.  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 stable 1.020 version for important work.
-#
-#WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING WARNING
-#
-#";
-                       
+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-gconf
+* Upstream URL: https://gitlab.gnome.org/Archive/gconf
+* Last upstream version: 3.2.6
+* Last upstream release date: 2013-01-21
+* Migration path for this module: Glib::IO::Settings
+* Migration module URL: https://metacpan.org/pod/Glib::IO
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+__EON__
+
 
 sub MY::postamble
 {
diff --git a/README b/README
index 1268b83..7fc9147 100644
--- a/README
+++ b/README
@@ -1,6 +1,31 @@
 Gnome2::GConf version 1.045
 ===========================
 
+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-gconf
+* Upstream URL: https://gitlab.gnome.org/Archive/gconf
+* Last upstream version: 3.2.6
+* Last upstream release date: 2013-01-21
+* Migration path for this module: Glib::IO::Settings
+* Migration module URL: https://metacpan.org/pod/Glib::IO
+
+NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE
+
+
 This module allows you to use the GConf configuration system in order to
 store/retrieve the configuration of an application.  GConf is a powerful
 configuration manager based on a user daemon that handles a set of key and