[src/trunk]: src Add a small summary page for <unistd.h>.

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

details:   https://anonhg.NetBSD.org/src/rev/35cea224e01d
branches:  trunk
changeset: 764002:35cea224e01d
user:      jruoho <jruoho%NetBSD.org@localhost>
date:      Sun Apr 10 09:58:00 2011 +0000

description:
Add a small summary page for <unistd.h>.

diffstat:

 distrib/sets/lists/comp/mi |    5 +-
 share/man/man3/Makefile    |    5 +-
 share/man/man3/unistd.3    |  107 +++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 114 insertions(+), 3 deletions(-)

diffs (163 lines):

diff -r 6022fd48b5d3 -r 35cea224e01d distrib/sets/lists/comp/mi
--- a/distrib/sets/lists/comp/mi        Sun Apr 10 09:55:08 2011 +0000
+++ b/distrib/sets/lists/comp/mi        Sun Apr 10 09:58:00 2011 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: mi,v 1.1612 2011/04/08 08:36:33 jruoho Exp $
+#      $NetBSD: mi,v 1.1613 2011/04/10 09:58:00 jruoho Exp $
 #
 # Note: don't delete entries from here - mark them as "obsolete" instead.
 #
@@ -8644,6 +8644,7 @@
 ./usr/share/man/cat3/ungetc.0                  comp-c-catman           .cat
 ./usr/share/man/cat3/ungetch.0                 comp-c-catman           .cat
 ./usr/share/man/cat3/ungetwc.0                 comp-c-catman           .cat
+./usr/share/man/cat3/unistd.0                  comp-c-catman           .cat
 ./usr/share/man/cat3/unlockpt.0                        comp-c-catman           .cat
 ./usr/share/man/cat3/unpost_form.0             comp-c-catman           .cat
 ./usr/share/man/cat3/unsetenv.0                        comp-c-catman           .cat
@@ -14650,6 +14651,7 @@
 ./usr/share/man/html3/ungetc.html              comp-c-htmlman          html
 ./usr/share/man/html3/ungetch.html             comp-c-htmlman          html
 ./usr/share/man/html3/ungetwc.html             comp-c-htmlman          html
+./usr/share/man/html3/unistd.html              comp-c-htmlman          html
 ./usr/share/man/html3/unlockpt.html            comp-c-htmlman          html
 ./usr/share/man/html3/unpost_form.html         comp-c-htmlman          html
 ./usr/share/man/html3/unsetenv.html            comp-c-htmlman          html
@@ -20724,6 +20726,7 @@
 ./usr/share/man/man3/ungetc.3                  comp-c-man              .man
 ./usr/share/man/man3/ungetch.3                 comp-c-man              .man
 ./usr/share/man/man3/ungetwc.3                 comp-c-man              .man
+./usr/share/man/man3/unistd.3                  comp-c-man              .man
 ./usr/share/man/man3/unlockpt.3                        comp-c-man              .man
 ./usr/share/man/man3/unpost_form.3             comp-c-man              .man
 ./usr/share/man/man3/unsetenv.3                        comp-c-man              .man
diff -r 6022fd48b5d3 -r 35cea224e01d share/man/man3/Makefile
--- a/share/man/man3/Makefile   Sun Apr 10 09:55:08 2011 +0000
+++ b/share/man/man3/Makefile   Sun Apr 10 09:58:00 2011 +0000
@@ -1,4 +1,4 @@
-#      $NetBSD: Makefile,v 1.73 2011/04/08 08:36:34 jruoho Exp $
+#      $NetBSD: Makefile,v 1.74 2011/04/10 09:58:01 jruoho Exp $
 #      @(#)Makefile    8.2 (Berkeley) 12/13/93
 
 MAN=   _DIAGASSERT.3 __CONCAT.3 __UNCONST.3 CMSG_DATA.3 \
@@ -12,7 +12,8 @@
        ilog2.3 intro.3 inttypes.3 iso646.3 \
        makedev.3 offsetof.3 param.3 paths.3 queue.3 rbtree.3 sigevent.3 \
        stdarg.3 stdbool.3 stddef.3 stdint.3 stdlib.3 sysexits.3 \
-       tgmath.3 timeradd.3 timeval.3 tree.3 typeof.3 types.3 varargs.3
+       tgmath.3 timeradd.3 timeval.3 tree.3 typeof.3 types.3 \
+       unistd.3 varargs.3
 
 USETBL=        # used by queue.3
 
diff -r 6022fd48b5d3 -r 35cea224e01d share/man/man3/unistd.3
--- /dev/null   Thu Jan 01 00:00:00 1970 +0000
+++ b/share/man/man3/unistd.3   Sun Apr 10 09:58:00 2011 +0000
@@ -0,0 +1,107 @@
+.\" $NetBSD: unistd.3,v 1.1 2011/04/10 09:58:01 jruoho Exp $
+.\"
+.\" Copyright (c) 2011 Jukka Ruohonen <jruohonen%iki.fi@localhost>
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd April 10, 2011
+.Dt UNISTD 3
+.Os
+.Sh NAME
+.Nm unistd
+.Nd standard symbolic constants and types
+.Sh SYNOPSIS
+.In unistd.h
+.Sh DESCRIPTION
+The
+.In unistd.h
+header forms the basis of the Portable Operating System Interface for Unix
+.Pq Tn POSIX
+.Tn API .
+It includes definitions for numerous functions, symbolic constants, and types.
+Among these are:
+.Bl -bullet -offset indent
+.It
+The implementation-defined
+.Dv NULL
+pointer constant.
+.It
+Types such as
+.Vt size_t ,
+.Vt ssize_t ,
+.Vt pid_t ,
+and
+.Vt intptr_t .
+.It
+Various limits and other symbolic constants described in
+.Xr pathconf 2
+and
+.Xr sysconf 2 .
+.It
+Prototypes for several important system calls such as
+.Xr alarm 2 ,
+.Xr execl 2 ,
+.Xr fork 2 ,
+.Xr link 2 ,
+.Xr pipe 2 ,
+.Xr setuid 2 ,
+and
+.Xr write 2 .
+.It
+The symbolic constant
+.Dv _POSIX_VERSION
+that defines the version of the
+.Tn POSIX
+standard to which the implementation conforms.
+.It
+Various other
+.Dv _POSIX
+-prefixed symbolic constants that indicate whether
+the system implements some optional part of the standard.
+Examples include such constants as
+.Dv _POSIX_IPV6
+for
+.Xr inet6 4
+functionality and
+.Dv _POSIX_ASYNCHRONOUS_IO
+for
+.Xr aio 3 .
+.El
+.Sh SEE ALSO
+.Xr stddef 3 ,
+.Xr stdint 3 ,
+.Xr stdlib 3 ,
+.Xr types 3
+.Sh STANDARDS
+The
+.In unistd.h
+header conforms to
+.St -p1003.1-2001 .
+.\"
+.\" XXX: fill this.
+.\"
+.\".Sh HISTORY
+.\" A
+.\" .In unistd.h
+.\" header first appeared in
+.\" ???