d/freebsd-dev
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Clean up execl*(3) manual page prototype formatting

Browse Source 
Rendering of execle was missing a comma between the NULL argument and envp.

For unclear reasons, POSIX' definition of these routines comments out the
mandatory trailing NULL argument.  That seems unnecessary and probably
(reasonably) confuses mdoc.

For unclear reasons, POSIX' definition of these routines spells NULL as
"(char *)0."  This is needlessly unclear.  One guess might be that POSIX
targets more exotic computer architectures than FreeBSD does.  Fortunately,
there is no such problem on any reasonable platform for FreeBSD to support.
Spell NULL as NULL.

The comma was probably removed in r117204 while the comment and creative
spelling of NULL were added in r116537 (both 15 years ago).
This commit is contained in:
Conrad Meyer 2018-07-28 19:08:00 +00:00
parent cb5ce014d4
commit bbc5c8ee32
Notes: svn2git 2020-12-20 02:59:44 +00:00 
svn path=/head/; revision=336835
1 changed files with 4 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
lib/libc/gen/exec.3
View File

@ -28,7 +28,7 @@
.\" @(#)exec.3 8.3 (Berkeley) 1/24/94
.\" $FreeBSD$
.\"
.Dd January 5, 2016
.Dd July 28, 2018
.Dt EXEC 3
.Os
.Sh NAME
@ -46,16 +46,11 @@
.In unistd.h
.Vt extern char **environ ;
.Ft int
.Fn execl "const char *path" "const char *arg" ... /* "(char *)0" */
.Fn execl "const char *path" "const char *arg" ... NULL
.Ft int
.Fn execlp "const char *file" "const char *arg" ... /* "(char *)0" */
.Fn execlp "const char *file" "const char *arg" ... NULL
.Ft int
.Fo execle
.Fa "const char *path" "const char *arg" ...
.Fa /*
.Bk -words
.Fa "(char *)0" "char *const envp[]" */
.Ek
.Fn execle "const char *path" "const char *arg" ... NULL "char *const envp[]"
.Fc
.Ft int
.Fn exect "const char *path" "char *const argv[]" "char *const envp[]"