From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id 6DC831382C5 for ; Fri, 9 Feb 2018 09:42:30 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id B439AE0AB8; Fri, 9 Feb 2018 09:42:24 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 6CA93E0A96 for ; Fri, 9 Feb 2018 09:42:22 +0000 (UTC) Received: from localhost.localdomain (d202-252.icpnet.pl [109.173.202.252]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) (Authenticated sender: mgorny) by smtp.gentoo.org (Postfix) with ESMTPSA id 66EBF335C4E; Fri, 9 Feb 2018 09:42:20 +0000 (UTC) From: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= To: gentoo-dev@lists.gentoo.org Cc: =?UTF-8?q?Micha=C5=82=20G=C3=B3rny?= Subject: [gentoo-dev] [PATCH] gnome2-utils.eclass: Fix the documentation for cache update functions Date: Fri, 9 Feb 2018 10:42:15 +0100 Message-Id: <20180209094215.21195-1-mgorny@gentoo.org> X-Mailer: git-send-email 2.16.1 Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-dev@lists.gentoo.org Reply-to: gentoo-dev@lists.gentoo.org X-Archives-Salt: 691c98b9-215a-47a5-9fb0-2afb39444de7 X-Archives-Hash: dd36fbf2089cfdbe46e65912b093b65d Fix the documentation for recently changed cache update functions that no longer rely on their _savelist() counterpart to indicate that. --- eclass/gnome2-utils.eclass | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/eclass/gnome2-utils.eclass b/eclass/gnome2-utils.eclass index 9b4296c11fad..65076ae2d61e 100644 --- a/eclass/gnome2-utils.eclass +++ b/eclass/gnome2-utils.eclass @@ -207,7 +207,9 @@ gnome2_gconf_uninstall() { # @FUNCTION: gnome2_icon_savelist # @DESCRIPTION: # Find the icons that are about to be installed and save their location -# in the GNOME2_ECLASS_ICONS environment variable. +# in the GNOME2_ECLASS_ICONS environment variable. This is only +# necessary for eclass implementations that call +# gnome2_icon_cache_update conditionally. # This function should be called from pkg_preinst. gnome2_icon_savelist() { has ${EAPI:-0} 0 1 2 && ! use prefix && ED="${D}" @@ -218,8 +220,7 @@ gnome2_icon_savelist() { # @FUNCTION: gnome2_icon_cache_update # @DESCRIPTION: -# Updates Gtk+ icon cache files under /usr/share/icons if the current ebuild -# have installed anything under that location. +# Updates Gtk+ icon cache files under /usr/share/icons. # This function should be called from pkg_postinst and pkg_postrm. gnome2_icon_cache_update() { has ${EAPI:-0} 0 1 2 && ! use prefix && EROOT="${ROOT}" @@ -358,7 +359,8 @@ gnome2_scrollkeeper_update() { # @FUNCTION: gnome2_schemas_savelist # @DESCRIPTION: # Find if there is any GSettings schema to install and save the list in -# GNOME2_ECLASS_GLIB_SCHEMAS variable. +# GNOME2_ECLASS_GLIB_SCHEMAS variable. This is only necessary for eclass +# implementations that call gnome2_schemas_update conditionally. # This function should be called from pkg_preinst. gnome2_schemas_savelist() { has ${EAPI:-0} 0 1 2 && ! use prefix && ED="${D}" @@ -370,7 +372,7 @@ gnome2_schemas_savelist() { # @FUNCTION: gnome2_schemas_update # @USAGE: gnome2_schemas_update # @DESCRIPTION: -# Updates GSettings schemas if GNOME2_ECLASS_GLIB_SCHEMAS has some. +# Updates GSettings schemas. # This function should be called from pkg_postinst and pkg_postrm. gnome2_schemas_update() { has ${EAPI:-0} 0 1 2 && ! use prefix && EROOT="${ROOT}" -- 2.16.1