Re: kern/60288: callout(9) does not document callout_schedule()

["Thomas Klausner via gnats" <gnats-admin%NetBSD.org@localhost>]

The following reply was made to PR kern/60288; it has been noted by GNATS.

From: Thomas Klausner <wiz%netbsd.org@localhost>
To: NetBSD bugtracking <gnats-bugs%netbsd.org@localhost>
Cc: uwe%netbsd.org@localhost
Subject: Re: kern/60288: callout(9) does not document callout_schedule()
Date: Sat, 23 May 2026 23:49:23 +0200

 On Sat, May 23, 2026 at 09:40:02PM +0100, Valery Ushakov via gnats wrote:
 >  Doesn't it?
 
 Not like the other functions, no.
 All the other functions have a section of the type:
 
 The foo() function does something...
 
 but callout_schedule is only referenced in the descripton of
 callout_setfunc(), to wit:
 
      The callout_setfunc() function sets the function and argument of the
      callout handle c to func and arg respectively.  The callout handle must
      already be initialized.  If a callout will always be used with the same
      function and argument, then callout_setfunc() used in conjunction with
      callout_schedule() is slightly more efficient than using callout_reset().
 
 I'd like to see a paragraph about callout_schedule itself.
  Thomas