[src/trunk]: src/lib/libc/sys Document the destiny for these functions.

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

details:   https://anonhg.NetBSD.org/src/rev/ec70024a2448
branches:  trunk
changeset: 844863:ec70024a2448
user:      sevan <sevan%NetBSD.org@localhost>
date:      Sat Sep 07 12:40:17 2019 +0000

description:
Document the destiny for these functions.

diffstat:

 lib/libc/sys/brk.2 |  6 ++++--
 1 files changed, 4 insertions(+), 2 deletions(-)

diffs (20 lines):

diff -r 24c134e320ed -r ec70024a2448 lib/libc/sys/brk.2
--- a/lib/libc/sys/brk.2        Sat Sep 07 12:17:10 2019 +0000
+++ b/lib/libc/sys/brk.2        Sat Sep 07 12:40:17 2019 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: brk.2,v 1.35 2019/09/07 11:59:42 sevan Exp $
+.\"    $NetBSD: brk.2,v 1.36 2019/09/07 12:40:17 sevan Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -47,7 +47,9 @@
 .Sh DESCRIPTION
 .Bf -symbolic
 The brk and sbrk functions are legacy interfaces from before the
-advent of modern virtual memory management.
+advent of modern virtual memory management. brk is subject to removal and sbrk
+is destined for full compat, where the system call will exist in the kernel, but
+no longer exposed.
 .Ef
 .Pp
 The