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

[Bruce Evans]

On Tue, 17 Jun 2003, 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.

But we do run it through C compilers.  I ran it through a C compiler
to find the bug fixed in rev.1.5.  Automated checking of synopses in
man pages found hundreds of wrong ones.

Also, C programmers know how to parse C; they don't know how to parse
pseudo-C unambiguously.

Bruce