git: 76366ad0257a - stable/13 - swi(9): clean up description of clk_intr_event

From: Mitchell Horne <mhorne_at_FreeBSD.org>
Date: Wed, 19 Oct 2022 13:50:32 UTC
The branch stable/13 has been updated by mhorne:

URL: https://cgit.FreeBSD.org/src/commit/?id=76366ad0257a24c142d18a53ccacd08c23721ae7

commit 76366ad0257a24c142d18a53ccacd08c23721ae7
Author:     Mitchell Horne <mhorne@FreeBSD.org>
AuthorDate: 2022-10-12 16:35:23 +0000
Commit:     Mitchell Horne <mhorne@FreeBSD.org>
CommitDate: 2022-10-19 13:46:28 +0000

    swi(9): clean up description of clk_intr_event
    
    From what I can tell, setdelayed() was removed so long ago that its
    mention is more likely to be confusing than helpful. We now have a
    manpage for hardclock(9), so reference that.
    
    Reviewed by:    markj
    MFC after:      1 week
    Sponsored by:   The FreeBSD Foundation
    Differential Revision:  https://reviews.freebsd.org/D36937
    
    (cherry picked from commit 96b76a6a1edd6d0e0d4fa07c37d11d5805e8b8b3)
---
 share/man/man9/swi.9 | 15 ++++-----------
 1 file changed, 4 insertions(+), 11 deletions(-)

diff --git a/share/man/man9/swi.9 b/share/man/man9/swi.9
index d86538e31fd1..0dfc924325d6 100644
--- a/share/man/man9/swi.9
+++ b/share/man/man9/swi.9
@@ -139,12 +139,6 @@ Instead,
 .Fa handler
 will be executed the next time that the software interrupt thread runs after
 being scheduled by another event.
-Attaching a handler to the clock software interrupt thread and using this flag
-when scheduling a software interrupt handler can be used to implement the
-functionality performed by
-.Fn setdelayed
-in earlier versions of
-.Fx .
 .It Dv SWI_FROMNMI
 Specifies that
 .Fn swi_sched
@@ -163,11 +157,9 @@ clock software interrupts, respectively.
 .Va tty_intr_event
 is used to hang tty software interrupt handlers off of the same thread.
 .Va clk_intr_event
-is used to hang delayed handlers off of the clock software interrupt thread so
-that the functionality of
-.Fn setdelayed
-can be obtained in conjunction with
-.Dv SWI_DELAY .
+is used to hang delayed handlers off of the clock interrupt, and is invoked
+directly by
+.Xr hardclock 9 .
 .Sh RETURN VALUES
 The
 .Fn swi_add
@@ -222,6 +214,7 @@ is
 .Dv NULL .
 .El
 .Sh SEE ALSO
+.Xr hardclock 9 ,
 .Xr ithread 9 ,
 .Xr taskqueue 9
 .Sh HISTORY