Date: Wed, 18 Jun 2003 08:34:40 +1000 (EST) From: Bruce Evans <bde@zeta.org.au> To: Poul-Henning Kamp <phk@phk.freebsd.dk> Cc: cvs-all@FreeBSD.org Subject: Re: cvs commit: src/lib/libc/gen exec.3 Message-ID: <20030618083344.E33797@gamplex.bde.org> In-Reply-To: <26822.1055844688@critter.freebsd.dk> References: <26822.1055844688@critter.freebsd.dk>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, 17 Jun 2003, Poul-Henning Kamp wrote: > In message <20030617192918.S31778@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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030618083344.E33797>