[src/trunk]: src/lib/libc/stdlib Uppercase Dt argument; \-1, not -1; sort SEE...

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

details:   https://anonhg.NetBSD.org/src/rev/9586fd05493f
branches:  trunk
changeset: 567021:9586fd05493f
user:      wiz <wiz%NetBSD.org@localhost>
date:      Fri May 28 00:10:57 2004 +0000

description:
Uppercase Dt argument; \-1, not -1; sort SEE ALSO; & -> \*[Am].

diffstat:

 lib/libc/stdlib/grantpt.3      |   6 +++---
 lib/libc/stdlib/posix_openpt.3 |  18 +++++++++---------
 lib/libc/stdlib/ptsname.3      |   9 +++++----
 lib/libc/stdlib/unlockpt.3     |   6 +++---
 4 files changed, 20 insertions(+), 19 deletions(-)

diffs (137 lines):

diff -r b1ef4d8416e8 -r 9586fd05493f lib/libc/stdlib/grantpt.3
--- a/lib/libc/stdlib/grantpt.3 Fri May 28 00:06:50 2004 +0000
+++ b/lib/libc/stdlib/grantpt.3 Fri May 28 00:10:57 2004 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: grantpt.3,v 1.2 2004/05/28 00:06:50 wiz Exp $
+.\" $NetBSD: grantpt.3,v 1.3 2004/05/28 00:10:57 wiz Exp $
 .\"
 .\" Copyright (c) 2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -35,7 +35,7 @@
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .Dd May 25, 2004
-.Dt grantpt 3
+.Dt GRANTPT 3
 .Os
 .Sh NAME
 .Nm grantpt
@@ -61,7 +61,7 @@
 .Sh RETURN VALUES
 If successful,
 .Fn grantpt
-returns 0; otherwise a value of -1 is returned and
+returns 0; otherwise a value of \-1 is returned and
 .Va errno
 is set to indicate the error.
 .Sh ERRORS
diff -r b1ef4d8416e8 -r 9586fd05493f lib/libc/stdlib/posix_openpt.3
--- a/lib/libc/stdlib/posix_openpt.3    Fri May 28 00:06:50 2004 +0000
+++ b/lib/libc/stdlib/posix_openpt.3    Fri May 28 00:10:57 2004 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: posix_openpt.3,v 1.2 2004/05/28 00:06:51 wiz Exp $
+.\" $NetBSD: posix_openpt.3,v 1.3 2004/05/28 00:10:57 wiz Exp $
 .\"
 .\" Copyright (c) 2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -35,7 +35,7 @@
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .Dd May 25, 2004
-.Dt posix_openpt 3
+.Dt POSIX_OPENPT 3
 .Os
 .Sh NAME
 .Nm posix_openpt
@@ -60,20 +60,20 @@
 If successful,
 .Fn posix_openpt
 returns a non-negative integer, which corresponds to a file descriptor
-pointing to the master pseudo-terminal device.  Otherwise, a value of -1
-is returned and
+pointing to the master pseudo-terminal device.
+Otherwise, a value of \-1 is returned and
 .Va errno
 is set to indicate the error.
 .Sh SEE ALSO
+.Xr ioctl 2 ,
+.Xr open 2 ,
 .Xr grantpt 3 ,
-.Xr unlockpt 3 ,
 .Xr ptsname 3 ,
-.Xr ioctl 2 ,
-.Xr open 2
+.Xr unlockpt 3
 .Sh RATIONALE
 The standards committee did not want to directly expose the cloning device,
-thus decided to wrap the functionality in this function. The equivalent
-code would be:
+thus decided to wrap the functionality in this function.
+The equivalent code would be:
 .Bd -literal
        int
        posix_openpt(int oflag) {
diff -r b1ef4d8416e8 -r 9586fd05493f lib/libc/stdlib/ptsname.3
--- a/lib/libc/stdlib/ptsname.3 Fri May 28 00:06:50 2004 +0000
+++ b/lib/libc/stdlib/ptsname.3 Fri May 28 00:10:57 2004 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: ptsname.3,v 1.2 2004/05/28 00:06:51 wiz Exp $
+.\" $NetBSD: ptsname.3,v 1.3 2004/05/28 00:10:57 wiz Exp $
 .\"
 .\" Copyright (c) 2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -35,7 +35,7 @@
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .Dd May 25, 2004
-.Dt ptsname 3
+.Dt PTSNAME 3
 .Os
 .Sh NAME
 .Nm ptsname
@@ -59,7 +59,8 @@
 If successful,
 .Fn ptsname
 returns a pointer to a nul-terminated string containing the pathname
-of the slave pseudo-terminal device. If an error occurs
+of the slave pseudo-terminal device.
+If an error occurs
 .Fn ptsname
 will return
 .Dv NULL
@@ -91,7 +92,7 @@
 function is equivalent to:
 .Bd -literal
        struct ptmget pm;
-       return ioctl(masterfd, TIOCPTSNAME, &pm) == -1 ? NULL : pm.ps;
+       return ioctl(masterfd, TIOCPTSNAME, \*[Am]pm) == -1 ? NULL : pm.ps;
 .Ed
 .Sh SEE ALSO
 .Xr ioctl 2 ,
diff -r b1ef4d8416e8 -r 9586fd05493f lib/libc/stdlib/unlockpt.3
--- a/lib/libc/stdlib/unlockpt.3        Fri May 28 00:06:50 2004 +0000
+++ b/lib/libc/stdlib/unlockpt.3        Fri May 28 00:10:57 2004 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: unlockpt.3,v 1.2 2004/05/28 00:06:51 wiz Exp $
+.\" $NetBSD: unlockpt.3,v 1.3 2004/05/28 00:10:57 wiz Exp $
 .\"
 .\" Copyright (c) 2004 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -35,7 +35,7 @@
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
 .Dd May 25, 2004
-.Dt unlockpt 3
+.Dt UNLOCKPT 3
 .Os
 .Sh NAME
 .Nm unlockpt
@@ -57,7 +57,7 @@
 .Sh RETURN VALUES
 If successful,
 .Fn unlockpt
-returns 0; otherwise a value of -1 is returned and
+returns 0; otherwise a value of \-1 is returned and
 .Va errno
 is set to indicate the error.
 .Sh ERRORS