Page MenuHomeFreeBSD
Files F159946328

D51076.diff
No OneTemporary
Actions

D51076.diff
View Options

diff --git a/share/man/man9/gone_in.9 b/share/man/man9/gone_in.9
--- a/share/man/man9/gone_in.9
+++ b/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 August 16, 2021
+.Dd June 27, 2025
.Dt GONE_IN 9
.Os
.Sh NAME
@@ -33,9 +33,9 @@
.Sh SYNOPSIS
.In sys/systm.h
.Ft void
-.Fn gone_in "int major" "const char *msg"
+.Fn gone_in "int major" "const char *msg" ...
.Ft void
-.Fn gone_in_dev "device_t dev" "int major" "const char *msg"
+.Fn gone_in_dev "device_t dev" "int major" "const char *msg" ...
.Sh DESCRIPTION
The
.Fn gone_in
@@ -43,30 +43,35 @@
some other functionality that is deprecated, and will be removed in a future
.Fx
release.
-The notice is sent to the kernel
-.Xr dmesg 8
-log and will appear on the console.
+.Pp
The
.Fa major
argument specifies the major version of the
.Fx
release that will remove the deprecated functionality.
.Pp
-In releases before
-.Fa major
-the deprecation notice states
-.Do
-Deprecated code (to be removed in FreeBSD
-.Fa major Ns ):
-.Fa msg
-.Dc .
-In releases equal to and after
-.Fa major
-the notice states
-.Do
-Obsolete code will be removed soon:
+The message
.Fa msg
-.Dc .
+is a
+.Xr printf 3 Ns
+-style format string.
+The formatted message is sent to the kernel
+.Xr dmesg 8
+log and will appear on the console;
+it should state clearly what functionality is deprecated.
+.Pp
+Each instance of a
+.Fn gone_in
+deprecation notice will be printed no more than one time.
+.Pp
+The
+.Fn gone_in_dev
+function behaves identically to
+.Fn gone_in ,
+but it accepts an additional
+.Fa dev
+argument that will be passed to
+.Xr device_printf 9 .
.Sh EXAMPLES
.Bd -literal -offset indent
void
@@ -74,7 +79,7 @@
{
/* Initializaiton code omitted. */
- gone_in(14, "Giant-locked filesystem");
+ gone_in(16, "Giant-locked filesystem");
}
int
@@ -82,9 +87,13 @@
{
/* Attach code omitted. */
- gone_in_dev(sc->dev, 14, "Giant-locked driver");
+ gone_in_dev(sc->dev, 16, "Giant-locked driver");
}
.Ed
+.Sh SEE ALSO
+.Xr printf 3 ,
+.Xr device_printf 9 ,
+.Xr printf 9
.Sh HISTORY
The
.Nm

File Metadata

Mime Type
text/plain
Expires
Sat, Jun 20, 7:57 PM (19 m, 33 s)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
34127407
Default Alt Text
D51076.diff (2 KB)

Event Timeline