git: 4f711f9085b8 - main - bus_generic_detach.9: Update for new semantics

The branch main has been updated by jhb:

URL: https://cgit.FreeBSD.org/src/commit/?id=4f711f9085b82988cf3ed464ec0bb842d39d4e5a

commit 4f711f9085b82988cf3ed464ec0bb842d39d4e5a
Author:     John Baldwin <jhb@FreeBSD.org>
AuthorDate: 2025-02-05 19:48:29 +0000
Commit:     John Baldwin <jhb@FreeBSD.org>
CommitDate: 2025-02-05 19:48:51 +0000

    bus_generic_detach.9: Update for new semantics
    
    bus_generic_detach now deletes children after detaching them.
    
    Reviewed by:    ziaee
    Differential Revision:  https://reviews.freebsd.org/D48371
---
 share/man/man9/bus_generic_detach.9 | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/share/man/man9/bus_generic_detach.9 b/share/man/man9/bus_generic_detach.9
index 590cd26486e4..b7a2aa6e6105 100644
--- a/share/man/man9/bus_generic_detach.9
+++ b/share/man/man9/bus_generic_detach.9
@@ -26,7 +26,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd January 15, 2017
+.Dd February 5, 2025
 .Dt BUS_GENERIC_DETACH 9
 .Os
 .Sh NAME
@@ -44,13 +44,23 @@ This function provides an implementation of the
 .Xr DEVICE_DETACH 9
 method
 which can be used by most bus code.
-It simply calls the
-.Xr DEVICE_DETACH 9
-method of each child device attached to the bus.
+It uses
+.Xr bus_detach_children 9
+to detach drivers from all child devices giving them a chance to veto the
+detach request.
+If
+.Fn bus_detach_children
+succeeds,
+.Fn bus_generic_detach
+calls
+.Xr device_delete_children 9
+to delete all child devices.
 .Sh RETURN VALUES
 Zero is returned on success, otherwise an appropriate error is returned.
 .Sh SEE ALSO
+.Xr bus_detach_children 9 ,
 .Xr device 9 ,
+.Xr device_delete_children 9 ,
 .Xr driver 9
 .Sh AUTHORS
 This manual page was written by