fdo-mime.eclass: Mark the eclass as deprecated

The GNOME team has committed the xdg-utils.eclass serving exactly
the same purpose as fdo-mime.eclass, supposedly with the goal of
replacing it. However, it seems that they have never bothered to
actually hint the deprecation in the fdo-mime.eclass in any way.
As a result, developers are still adding references to this eclass
instead of using xdg-utils or xdg, and/or not working towards replacing
them.

Add an explicit deprecation notice to the fdo-mime.eclass to make it
clear that the eclass should not be used in new packages, and what
the replacement eclasses are.

diff --git a/eclass/fdo-mime.eclass b/eclass/fdo-mime.eclass
index b3b096d154e7be2421504ac85dfba4557748884f..8e51d8a69df10e3ea29fe0d04f7b758edb09d657 100644 (file)
--- a/eclass/fdo-mime.eclass
+++ b/eclass/fdo-mime.eclass
@@ -1,4 +1,4 @@
-# Copyright 1999-2011 Gentoo Foundation
+# Copyright 1999-2017 Gentoo Foundation
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: fdo-mime.eclass
@@ -7,6 +7,8 @@
 # @AUTHOR:
 # Original author: foser <foser@gentoo.org>
 # @BLURB: Utility eclass to update the desktop mime info as laid out in the freedesktop specs & implementations
+# @DESCRIPTION:
+# This eclass is DEPRECATED. Please use xdg-utils or xdg instead.
 
 # @FUNCTION: fdo-mime_desktop_database_update
 # @DESCRIPTION: