[gentoo-commits] repo/gentoo:master commit in: eclass/

[Mike Gilbert]

commit:     9b977bfdb07b76e108bd962c998421353a40e131
Author:     Mike Gilbert <floppym <AT> gentoo <DOT> org>
AuthorDate: Sat Jun  4 13:47:29 2022 +0000
Commit:     Mike Gilbert <floppym <AT> gentoo <DOT> org>
CommitDate: Wed Jun  8 00:24:56 2022 +0000
URL:        https://gitweb.gentoo.org/repo/gentoo.git/commit/?id=9b977bfd

udev.eclass: document when udev_reload should be called

Closes: https://bugs.gentoo.org/847436
Signed-off-by: Mike Gilbert <floppym <AT> gentoo.org>

 eclass/udev.eclass | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/eclass/udev.eclass b/eclass/udev.eclass
index 073e5d8acbc9..830e3eeb125e 100644
--- a/eclass/udev.eclass
+++ b/eclass/udev.eclass
@@ -1,4 +1,4 @@
-# Copyright 1999-2021 Gentoo Authors
+# Copyright 1999-2022 Gentoo Authors
 # Distributed under the terms of the GNU General Public License v2
 
 # @ECLASS: udev.eclass
@@ -26,6 +26,14 @@
 #	# udev_dorules contrib/99-foomatic
 #	# udev_newrules contrib/98-foomatic 99-foomatic
 # }
+#
+# pkg_postinst() {
+#	udev_reload
+# }
+#
+# pkg_postrm() {
+#	udev_reload
+# }
 # @CODE
 
 case ${EAPI} in
@@ -110,7 +118,9 @@ udev_newrules() {
 
 # @FUNCTION: udev_reload
 # @DESCRIPTION:
-# Run udevadm control --reload to refresh rules and databases
+# Run "udevadm control --reload" to refresh rules and databases.
+# Should be called from pkg_postinst and pkg_postrm in packages which install
+# udev rules or hwdb data.
 udev_reload() {
 	if [[ -n ${ROOT%/} ]]; then
 		return 0