docs/114139: mbuf(9) has misleading comments on M_DONTWAIT and M_TRYWAIT

[Tom Rhodes]

The following reply was made to PR docs/114139; it has been noted by GNATS.

From: Tom Rhodes <trhodes at FreeBSD.org>
To: bug-followup at FreeBSD.org
Cc:  
Subject: Re: docs/114139: mbuf(9) has misleading comments on M_DONTWAIT and
 M_TRYWAIT
Date: Tue, 22 Jan 2008 11:06:00 -0500

 Hi,
 
 I'm not completely sure on the first point, I think the missing
 context not copied from mbuf(9) does point out why they are
 different.  Compare mbuf.9 to sys/mbuf.h and double check.
 
 For the second point, I sent this patch to another developer for
 review:
 
 Index: mbuf.9
 ===================================================================
 RCS file: /home/ncvs/src/share/man/man9/mbuf.9,v
 retrieving revision 1.65
 diff -u -u -r1.65 mbuf.9
 --- mbuf.9	26 Feb 2007 15:17:19 -0000	1.65
 +++ mbuf.9	22 Jan 2008 11:52:59 -0000
 @@ -24,7 +24,7 @@
  .\"
  .\" $FreeBSD: src/share/man/man9/mbuf.9,v 1.65 2007/02/26 15:17:19 bms Exp $
  .\"
 -.Dd February 26, 2007
 +.Dd January 22, 2008
  .Dt MBUF 9
  .Os
  .\"
 @@ -363,12 +363,8 @@
  .Fa how
  is set to
  .Dv M_TRYWAIT ,
 -a failed allocation will result in the caller being put
 -to sleep for a designated
 -kern.ipc.mbuf_wait
 -.Xr ( sysctl 8
 -tunable)
 -number of ticks.
 +a failed allocation will result in the caller blocking until
 +resources are available and thus never return NULL.
  A number of other functions and macros related to
  .Vt mbufs
  have the same argument because they may
 
 Thanks,
 -- 
 Tom Rhodes