discourage the new use of malloc(9).

share/man/man9/malloc.9

@@ -1,4 +1,4 @@
-.\"	$NetBSD: malloc.9,v 1.40 2007/07/30 22:48:47 alc Exp $
+.\"	$NetBSD: malloc.9,v 1.41 2008/03/24 08:24:48 yamt Exp $
 .\"
 .\" Copyright (c) 1996, 2003 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,7 +34,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd March 29, 2007
+.Dd March 24, 2008
 .Dt MALLOC 9
 .Os
 .Sh NAME
@@ -78,6 +78,15 @@
 .Fn MALLOC_JUSTDEFINE "type" "shortdesc" "longdesc"
 .Fn MALLOC_DECLARE "type"
 .Sh DESCRIPTION
+.Bf -symbolic
+These interfaces are being obsoleted and their new use is discouraged.
+For new code, please consider to use
+.Xr kmem_alloc 9
+or
+.Xr pool_cache 9
+instead.
+.Ef
+.Pp
 The
 .Fn malloc
 function allocates uninitialized memory in kernel address space for an