[src/trunk]: src/share/man/man9 Make it clear that we should use not callout_...

[ozaki-r <ozaki-r%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/eaf269eb60b1
branches:  trunk
changeset: 333876:eaf269eb60b1
user:      ozaki-r <ozaki-r%NetBSD.org@localhost>
date:      Thu Nov 20 15:43:52 2014 +0000

description:
Make it clear that we should use not callout_stop but callout_halt before callout_destroy

diffstat:

 share/man/man9/callout.9 |  10 +++++++---
 1 files changed, 7 insertions(+), 3 deletions(-)

diffs (31 lines):

diff -r 8953aa260473 -r eaf269eb60b1 share/man/man9/callout.9
--- a/share/man/man9/callout.9  Thu Nov 20 14:35:01 2014 +0000
+++ b/share/man/man9/callout.9  Thu Nov 20 15:43:52 2014 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: callout.9,v 1.27 2014/07/27 21:35:07 riastradh Exp $
+.\"    $NetBSD: callout.9,v 1.28 2014/11/20 15:43:52 ozaki-r Exp $
 .\"
 .\" Copyright (c) 2000, 2003, 2009 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd February 2, 2013
+.Dd November 21, 2014
 .Dt CALLOUT 9
 .Os
 .Sh NAME
@@ -116,7 +116,11 @@
 when a device is being detached).
 The callout should be stopped before
 .Fn callout_destroy
-is called.
+is called by calling
+.Fn callout_halt .
+Note that
+.Fn callout_stop
+shouldn't be used for this purpose.
 .Pp
 The
 .Fn callout_reset