aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGiorgos Keramidas <keramida@FreeBSD.org>2004-12-23 23:45:25 +0000
committerGiorgos Keramidas <keramida@FreeBSD.org>2004-12-23 23:45:25 +0000
commitf56be64fb212db4e89a512ad0d2ed135f7dad8b3 (patch)
treefa17121d9a635b571177c32da68d0670990b2c96
parentff08c098f2193a8376c02f86c72621df546a82f1 (diff)
downloadsrc-f56be64fb212db4e89a512ad0d2ed135f7dad8b3.tar.gz
src-f56be64fb212db4e89a512ad0d2ed135f7dad8b3.zip
``NULL is a specific instance of a null pointer constant; the generic is
a "null pointer".'' Making good use of the excellent explanations sent to me by Ruslan Ermilov, Garrett Wollman and Bruce Evans, correct the descriptions of null pointers. They are just "null pointers", not nil, not NULL or ".Dv NULL". Suggested by: ru, wollman, bde Reviewed by: ru, wollman Pointy hat: keramida
Notes
Notes: svn path=/head/; revision=139253
-rw-r--r--lib/libc/sys/acct.24
-rw-r--r--lib/libc/sys/adjtime.24
-rw-r--r--lib/libc/sys/aio_suspend.210
-rw-r--r--lib/libc/sys/getitimer.24
-rw-r--r--lib/libc/sys/recv.25
-rw-r--r--lib/libc/sys/select.215
6 files changed, 12 insertions, 30 deletions
diff --git a/lib/libc/sys/acct.2 b/lib/libc/sys/acct.2
index 1119bbecf070..4f371d3fdf65 100644
--- a/lib/libc/sys/acct.2
+++ b/lib/libc/sys/acct.2
@@ -51,9 +51,7 @@ system call enables or disables the collection of system accounting
records.
If the argument
.Fa file
-is a
-.Dv NULL
-pointer, accounting is disabled.
+is a null pointer, accounting is disabled.
If
.Fa file
is an
diff --git a/lib/libc/sys/adjtime.2 b/lib/libc/sys/adjtime.2
index a5f873e8067a..5794a3295563 100644
--- a/lib/libc/sys/adjtime.2
+++ b/lib/libc/sys/adjtime.2
@@ -72,9 +72,7 @@ may not be finished when
is called again.
If
.Fa olddelta
-is not a
-.Dv NULL
-pointer,
+is not a null pointer,
the structure pointed to will contain, upon return, the
number of microseconds still to be corrected
from the earlier call.
diff --git a/lib/libc/sys/aio_suspend.2 b/lib/libc/sys/aio_suspend.2
index 77d8ec565eff..db704f137d1c 100644
--- a/lib/libc/sys/aio_suspend.2
+++ b/lib/libc/sys/aio_suspend.2
@@ -52,18 +52,14 @@ is an array of
.Fa niocb
pointers to asynchronous I/O requests.
Array members containing
-NULL will be silently ignored.
+null pointers will be silently ignored.
.Pp
If
.Fa timeout
-is not a
-.Dv NULL
-pointer, it specifies a maximum interval to suspend.
+is not a null pointer, it specifies a maximum interval to suspend.
If
.Fa timeout
-is a
-.Dv NULL
-pointer, the suspend blocks indefinitely.
+is a null pointer, the suspend blocks indefinitely.
To effect a
poll, the
.Fa timeout
diff --git a/lib/libc/sys/getitimer.2 b/lib/libc/sys/getitimer.2
index 2efb0f8472b1..90f49770bdfc 100644
--- a/lib/libc/sys/getitimer.2
+++ b/lib/libc/sys/getitimer.2
@@ -66,9 +66,7 @@ system call sets a timer to the specified
.Fa value
(returning the previous value of the timer if
.Fa ovalue
-is not a
-.Dv NULL
-pointer).
+is not a null pointer).
.Pp
A timer value is defined by the
.Fa itimerval
diff --git a/lib/libc/sys/recv.2 b/lib/libc/sys/recv.2
index 8c3e1b6aaf65..6833a59f5586 100644
--- a/lib/libc/sys/recv.2
+++ b/lib/libc/sys/recv.2
@@ -63,8 +63,7 @@ it is connection-oriented.
.Pp
If
.Fa from
-is not
-.Dv NULL ,
+is not a null pointer
and the socket is not connection-oriented,
the source address of the message is filled in.
The
@@ -85,7 +84,7 @@ socket (see
and is identical to
.Fn recvfrom
with a
-.Dv NULL
+null pointer passed as its
.Fa from
argument.
As it is redundant, it may not be supported in future releases.
diff --git a/lib/libc/sys/select.2 b/lib/libc/sys/select.2
index 193c90345a46..d90d521af8fb 100644
--- a/lib/libc/sys/select.2
+++ b/lib/libc/sys/select.2
@@ -108,23 +108,18 @@ to the maximum number of descriptors supported by the system.
.Pp
If
.Fa timeout
-is not a
-.Dv NULL
-pointer, it specifies the maximum interval to wait for the
+is not a null pointer, it specifies the maximum interval to wait for the
selection to complete.
System activity can lengthen the interval by
an indeterminate amount.
.Pp
If
.Fa timeout
-is a
-.Dv NULL
-pointer, the select blocks indefinitely.
+is a null pointer, the select blocks indefinitely.
.Pp
To effect a poll, the
.Fa timeout
-argument should not be
-.Dv NULL ,
+argument should not be a null pointer,
but it should point to a zero-valued timeval structure.
.Pp
Any of
@@ -132,9 +127,7 @@ Any of
.Fa writefds ,
and
.Fa exceptfds
-may be given as
-.Dv NULL
-pointers if no descriptors are of interest.
+may be given as null pointers if no descriptors are of interest.
.Sh RETURN VALUES
The
.Fn select