From owner-svn-src-head@freebsd.org  Sat Jul 28 19:08:01 2018
Return-Path: <owner-svn-src-head@freebsd.org>
Delivered-To: svn-src-head@mailman.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1])
 by mailman.ysv.freebsd.org (Postfix) with ESMTP id 84239105AC42;
 Sat, 28 Jul 2018 19:08:01 +0000 (UTC) (envelope-from cem@FreeBSD.org)
Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org
 [IPv6:2610:1c1:1:606c::19:3])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client CN "mxrelay.nyi.freebsd.org",
 Issuer "Let's Encrypt Authority X3" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id 3A6C97B1D8;
 Sat, 28 Jul 2018 19:08:01 +0000 (UTC) (envelope-from cem@FreeBSD.org)
Received: from repo.freebsd.org (repo.freebsd.org
 [IPv6:2610:1c1:1:6068::e6a:0])
 (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))
 (Client did not present a certificate)
 by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 1CD602BDA;
 Sat, 28 Jul 2018 19:08:01 +0000 (UTC) (envelope-from cem@FreeBSD.org)
Received: from repo.freebsd.org ([127.0.1.37])
 by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w6SJ800n089860;
 Sat, 28 Jul 2018 19:08:00 GMT (envelope-from cem@FreeBSD.org)
Received: (from cem@localhost)
 by repo.freebsd.org (8.15.2/8.15.2/Submit) id w6SJ80qo089859;
 Sat, 28 Jul 2018 19:08:00 GMT (envelope-from cem@FreeBSD.org)
Message-Id: <201807281908.w6SJ80qo089859@repo.freebsd.org>
X-Authentication-Warning: repo.freebsd.org: cem set sender to cem@FreeBSD.org
 using -f
From: Conrad Meyer <cem@FreeBSD.org>
Date: Sat, 28 Jul 2018 19:08:00 +0000 (UTC)
To: src-committers@freebsd.org, svn-src-all@freebsd.org,
 svn-src-head@freebsd.org
Subject: svn commit: r336835 - head/lib/libc/gen
X-SVN-Group: head
X-SVN-Commit-Author: cem
X-SVN-Commit-Paths: head/lib/libc/gen
X-SVN-Commit-Revision: 336835
X-SVN-Commit-Repository: base
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
X-BeenThere: svn-src-head@freebsd.org
X-Mailman-Version: 2.1.27
Precedence: list
List-Id: SVN commit messages for the src tree for head/-current
 <svn-src-head.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/svn-src-head>,
 <mailto:svn-src-head-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/svn-src-head/>
List-Post: <mailto:svn-src-head@freebsd.org>
List-Help: <mailto:svn-src-head-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/svn-src-head>,
 <mailto:svn-src-head-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sat, 28 Jul 2018 19:08:01 -0000

Author: cem
Date: Sat Jul 28 19:08:00 2018
New Revision: 336835
URL: https://svnweb.freebsd.org/changeset/base/336835

Log:
  Clean up execl*(3) manual page prototype formatting
  
  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).

Modified:
  head/lib/libc/gen/exec.3

Modified: head/lib/libc/gen/exec.3
==============================================================================
--- head/lib/libc/gen/exec.3	Sat Jul 28 17:21:34 2018	(r336834)
+++ head/lib/libc/gen/exec.3	Sat Jul 28 19:08:00 2018	(r336835)
@@ -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[]"