• [gentoo-dev] [PATCH] udev.eclass: document when udev_reload should be c

    From Mike Gilbert@21:1/5 to All on Sat Jun 4 16:00:01 2022
    Closes: https://bugs.gentoo.org/847436
    Signed-off-by: Mike Gilbert <floppym@gentoo.org>
    ---
    eclass/udev.eclass | 14 ++++++++++++--
    1 file changed, 12 insertions(+), 2 deletions(-)

    diff --git a/eclass/udev.eclass b/eclass/udev.eclass
    index 073e5d8acbc..830e3eeb125 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 [