From owner-cvs-all@FreeBSD.ORG  Tue Jun 17 15:34:56 2003
Return-Path: <owner-cvs-all@FreeBSD.ORG>
Delivered-To: cvs-all@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id CEA9137B401; Tue, 17 Jun 2003 15:34:56 -0700 (PDT)
Received: from mailman.zeta.org.au (mailman.zeta.org.au [203.26.10.16])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id ED7D143FBD; Tue, 17 Jun 2003 15:34:54 -0700 (PDT)
	(envelope-from bde@zeta.org.au)
Received: from katana.zip.com.au (katana.zip.com.au [61.8.7.246])
	by mailman.zeta.org.au (8.9.3p2/8.8.7) with ESMTP id IAA30236;
	Wed, 18 Jun 2003 08:34:41 +1000
Date: Wed, 18 Jun 2003 08:34:40 +1000 (EST)
From: Bruce Evans <bde@zeta.org.au>
X-X-Sender: bde@gamplex.bde.org
To: Poul-Henning Kamp <phk@phk.freebsd.dk>
In-Reply-To: <26822.1055844688@critter.freebsd.dk>
Message-ID: <20030618083344.E33797@gamplex.bde.org>
References: <26822.1055844688@critter.freebsd.dk>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
cc: cvs-src@FreeBSD.org
cc: src-committers@FreeBSD.org
cc: cvs-all@FreeBSD.org
Subject: Re: cvs commit: src/lib/libc/gen exec.3 
X-BeenThere: cvs-all@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: CVS commit messages for the entire tree <cvs-all.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-all>
List-Post: <mailto:cvs-all@freebsd.org>
List-Help: <mailto:cvs-all-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-all>,
	<mailto:cvs-all-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 17 Jun 2003 22:34:57 -0000

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