diff options
| author |   aaron <aaron@openbsd.org> | 1999-06-04 01:30:10 +0000 |
|---|---|---|
| committer | aaron <aaron@openbsd.org> | 1999-06-04 01:30:10 +0000 |
| commit | 545403d5ba85af10b0396609ee9da69f3c14f513 (patch) | |
| tree | ad6766d92500c863cf65c7f48b2bb6e4eeccae9c /lib/libc/gen/popen.3 | |
| parent | start swapping on the first swap device after initialization (diff) | |
| download | wireguard-openbsd-545403d5ba85af10b0396609ee9da69f3c14f513.tar.xz wireguard-openbsd-545403d5ba85af10b0396609ee9da69f3c14f513.zip | |
After some constructive criticism from pjanzen@ and some e-mail tag:
- only use the .Dv NULL form when referring explicitly to a function
argument or return value
- otherwise, use these forms:
o non-null
o null-terminated (hyphenated form for predicate adjective)
o else, null terminated, or null terminate, whichever the case
o null pointer, null byte, null string, etc.
- may use NUL to refer to an ASCII NUL, but it doesn't need a .Tn macro
In general, capitalizing the word "null" everywhere is unnecessary and makes
the man pages harder to read. The above is consistent with popular programming
texts (i.e., K&R, Stevens).
Diffstat (limited to 'lib/libc/gen/popen.3')
| -rw-r--r-- | lib/libc/gen/popen.3 | 6 |
1 files changed, 3 insertions, 3 deletions
diff --git a/lib/libc/gen/popen.3 b/lib/libc/gen/popen.3 index 1e553f5f480..f5000c955eb 100644 --- a/lib/libc/gen/popen.3 +++ b/lib/libc/gen/popen.3 @@ -1,4 +1,4 @@ -.\" $OpenBSD: popen.3,v 1.6 1999/06/03 10:03:22 aaron Exp $ +.\" $OpenBSD: popen.3,v 1.7 1999/06/04 01:30:11 aaron Exp $ .\" .\" Copyright (c) 1991, 1993 .\" The Regents of the University of California. All rights reserved. @@ -60,7 +60,7 @@ the resulting stream is correspondingly read-only or write-only. .Pp The .Fa command -argument is a pointer to a NUL-terminated +argument is a pointer to a null-terminated string containing a shell command line. This command is passed to .Pa /bin/sh @@ -69,7 +69,7 @@ using the flag; interpretation, if any, is performed by the shell. The .Fa mode -argument is a pointer to a NUL-terminated +argument is a pointer to a null-terminated string which must be either .Qq r for reading |