cvs commit: src/lib/libc/gen exec.3

[M. Warner Losh]

In message: <20030617111558.GC70321 at sunbay.com>
            Ruslan Ermilov <ru at FreeBSD.org> writes:
: On Tue, Jun 17, 2003 at 12:11:28PM +0200, Poul-Henning Kamp wrote:
: > In message <20030617192918.S31778 at gamplex.bde.org>, Bruce Evans writes:
: > >On Tue, 17 Jun 2003, Poul-Henning Kamp wrote:
: > >
: > >> phk         2003/06/17 01:57:37 PDT
: > >>
: > >>   FreeBSD src repository
: > >>
: > >>   Modified files:
: > >>     lib/libc/gen         exec.3
: > >>   Log:
: > >>   Fix the execle(3) synopsis to include the environment pointer.
: > >
: > >This just breaks the execle(3) synopsis again.  Synopsises for functions
: > >are C prototypes.  The synopsis for execle() wasn't a prototype in
: > >rev.1.1, but was fixed in rev.1.5.
: > 
: > I disagree: we don't run manual pages through C-compilers, we run
: > them through brains, and they should be optimized for that rather
: > than for the compilers that never see them.
: > 
: I have a solution that addresses both concerns, and it's also how
: this is prototyped in POSIX.1-2001, which is nice as well:
: 
: 	int
: 	execle(const char *path, const char *arg0, ...
: 	    /*, (char *)0, char *const envp[]*/);

I like it.

Warner