Re: git: 9b7d2cee03e5 - main - safe(4): add gone_in 16.0

From: John Baldwin <jhb_at_FreeBSD.org>
Date: Mon, 10 Nov 2025 14:53:30 UTC 
On 11/7/25 15:12, David E. O'Brien wrote:
> The branch main has been updated by obrien:
> 
> URL: https://cgit.FreeBSD.org/src/commit/?id=9b7d2cee03e5d0b0723718047d4bc388d0745591
> 
> commit 9b7d2cee03e5d0b0723718047d4bc388d0745591
> Author:     David E. O'Brien <obrien@FreeBSD.org>
> AuthorDate: 2025-10-29 01:11:48 +0000
> Commit:     David E. O'Brien <obrien@FreeBSD.org>
> CommitDate: 2025-11-07 20:04:44 +0000
> 
>      safe(4): add gone_in 16.0
>      
>      Reviewed by:    emaste
>      Differential Revision:  https://reviews.freebsd.org/D53426
> ---
>   share/man/man4/safe.4 | 16 +++++++++++++++-
>   sys/dev/safe/safe.c   |  2 ++
>   2 files changed, 17 insertions(+), 1 deletion(-)
> 
> diff --git a/sys/dev/safe/safe.c b/sys/dev/safe/safe.c
> index c512f3fc62c0..569bbe51e125 100644
> --- a/sys/dev/safe/safe.c
> +++ b/sys/dev/safe/safe.c
> @@ -424,6 +424,8 @@ safe_attach(device_t dev)
>   #ifdef SAFE_DEBUG
>   	safec = sc;			/* for use by hw.safe.dump */
>   #endif
> +	gone_in(16, "%s(4) is deprecated in 15.0 and removed in 16.0\n",
> +	    safe_driver->name);
>   	return (0);

gone_in_dev(9) is the documented function to use in attach routines and is what
we consistently have done for all other driver deprecations in the past decade or
so.

FreeBSD users generally understand that device driver manpages are in
section 4 already.

-- 
John Baldwin