diff options
author | Giorgos Keramidas <keramida@FreeBSD.org> | 2004-12-23 23:45:25 +0000 |
---|---|---|
committer | Giorgos Keramidas <keramida@FreeBSD.org> | 2004-12-23 23:45:25 +0000 |
commit | f56be64fb212db4e89a512ad0d2ed135f7dad8b3 (patch) | |
tree | fa17121d9a635b571177c32da68d0670990b2c96 | |
parent | ff08c098f2193a8376c02f86c72621df546a82f1 (diff) | |
download | src-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.2 | 4 | ||||
-rw-r--r-- | lib/libc/sys/adjtime.2 | 4 | ||||
-rw-r--r-- | lib/libc/sys/aio_suspend.2 | 10 | ||||
-rw-r--r-- | lib/libc/sys/getitimer.2 | 4 | ||||
-rw-r--r-- | lib/libc/sys/recv.2 | 5 | ||||
-rw-r--r-- | lib/libc/sys/select.2 | 15 |
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 |