[src/trunk]: src/share/man/man9 Explicitly mark mb(9) as deprecated, as it ha...

[riastradh <riastradh%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/dd6ff23502ac
branches:  trunk
changeset: 827786:dd6ff23502ac
user:      riastradh <riastradh%NetBSD.org@localhost>
date:      Sun Nov 12 21:20:20 2017 +0000

description:
Explicitly mark mb(9) as deprecated, as it has been for a decade.

diffstat:

 share/man/man9/mb.9 |  9 ++++++++-
 1 files changed, 8 insertions(+), 1 deletions(-)

diffs (30 lines):

diff -r d890dd59e535 -r dd6ff23502ac share/man/man9/mb.9
--- a/share/man/man9/mb.9       Sun Nov 12 21:14:33 2017 +0000
+++ b/share/man/man9/mb.9       Sun Nov 12 21:20:20 2017 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: mb.9,v 1.6 2011/01/02 07:14:02 jruoho Exp $
+.\"    $NetBSD: mb.9,v 1.7 2017/11/12 21:20:20 riastradh Exp $
 .\"
 .\" Copyright (c) 2007 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -45,6 +45,12 @@
 .Ft void
 .Fn mb_write "void"
 .Sh DESCRIPTION
+.Em The
+.Nm
+.Em API is deprecated; use
+.Xr membar_ops 3
+.Em instead.
+.Pp
 Many types of processor can execute instructions in a different order
 than issued by the compiler or assembler.
 On a uniprocessor system, out of order execution is transparent
@@ -111,6 +117,7 @@
 .El
 .Sh SEE ALSO
 .Xr __insn_barrier 3 ,
+.Xr membar_ops 3 ,
 .Xr bus_dma 9 ,
 .Xr bus_space 9 ,
 .Xr mutex 9 ,