Index: share/man/man9/gone_in.9 =================================================================== --- share/man/man9/gone_in.9 +++ share/man/man9/gone_in.9 @@ -23,7 +23,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 June 24, 2025 +.Dd October 27, 2025 .Dt GONE_IN 9 .Os .Sh NAME @@ -44,9 +44,6 @@ removal in a future .Fx release. -The notice is sent to the kernel -.Xr dmesg 8 -log and will appear on the console. The .Fa major argument specifies the major version of the @@ -59,19 +56,30 @@ .Nm gone_in_dev will prepend driver name before the notice. .Pp +The +.Fn gone_in +and +.Fn gone_in_dev +functions take a +.Xr printf 9 +style format string and arguments. +The formatted notice is sent to the kernel +.Xr dmesg 8 +log and will appear on the console. +.Pp In releases before .Fa major -the provided notice will be appended with +these functions append a message .Do To be removed in FreeBSD -.Fa major Ns +.Fa major .Dc . .Sh EXAMPLES .Bd -literal -offset indent void example_api(foo_t *args) { - gone_in(16, "Warning! %s[%u] uses obsolete API. ", + gone_in(16, "Warning! %s[%u] uses obsolete API.\\n", curthread->td_proc->p_comm, curthread->td_proc->p_pid); /* API implementation omitted. */ @@ -82,7 +90,7 @@ { /* Attach code omitted. */ - gone_in_dev(sc->dev, 16, "driver is deprecated"); + gone_in_dev(sc->dev, 16, "driver is deprecated\\n"); } .Ed .Sh HISTORY