[src/trunk]: src/lib/libc/stdio Improve the setbuf(3) man-page

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

details:   https://anonhg.NetBSD.org/src/rev/ec84daaa4891
branches:  trunk
changeset: 829965:ec84daaa4891
user:      kamil <kamil%NetBSD.org@localhost>
date:      Tue Feb 20 02:52:41 2018 +0000

description:
Improve the setbuf(3) man-page

Move historical lines to newly added HISTORY section.
Additional historical notes obtained from OpenBSD.

diffstat:

 lib/libc/stdio/setbuf.3 |  29 +++++++++++++++++------------
 1 files changed, 17 insertions(+), 12 deletions(-)

diffs (45 lines):

diff -r e580d6dc8b95 -r ec84daaa4891 lib/libc/stdio/setbuf.3
--- a/lib/libc/stdio/setbuf.3   Tue Feb 20 02:35:24 2018 +0000
+++ b/lib/libc/stdio/setbuf.3   Tue Feb 20 02:52:41 2018 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: setbuf.3,v 1.14 2015/07/15 19:08:43 christos Exp $
+.\"    $NetBSD: setbuf.3,v 1.15 2018/02/20 02:52:41 kamil Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"    The Regents of the University of California.  All rights reserved.
@@ -205,19 +205,24 @@
 functions
 conform to
 .St -ansiC .
-.Sh BUGS
+.Sh HISTORY
+The
+.Fn setbuf
+function first appeared in
+.At v7 .
 The
 .Fn setbuffer
-and
+function first appeared in
+.Bx 4.1c .
+The
 .Fn setlinebuf
-functions are not portable to versions of
-.Bx
-before
+function first appeared in
 .Bx 4.2 .
-On
-.Bx 4.2
-and
-.Bx 4.3
-systems,
+The
+.Fn setvbuf
+function first appeared in
+.Bx 4.4 .
+.Sh BUGS
+The
 .Fn setbuf
-always uses a suboptimal buffer size and should be avoided.
+function usually uses a suboptimal buffer size and should be avoided.