From owner-freebsd-doc Sat Apr 7 9:31:50 2001 Delivered-To: freebsd-doc@freebsd.org Received: from mailman.zeta.org.au (mailman.zeta.org.au [203.26.10.16]) by hub.freebsd.org (Postfix) with ESMTP id 1913237B42C; Sat, 7 Apr 2001 09:31:46 -0700 (PDT) (envelope-from bde@zeta.org.au) Received: from bde.zeta.org.au (bde.zeta.org.au [203.2.228.102]) by mailman.zeta.org.au (8.9.3/8.8.7) with ESMTP id CAA06598; Sun, 8 Apr 2001 02:31:43 +1000 Date: Sun, 8 Apr 2001 02:29:44 +1000 (EST) From: Bruce Evans X-Sender: bde@besplex.bde.org To: Ruslan Ermilov Cc: doc@FreeBSD.org, Bruce Evans , Sheldon Hearn , Mike Pritchard , Jeroen Ruigrok van der Werven Subject: Re: Please review: latest mdoc(7) fixes from CSRG In-Reply-To: <20010407153431.A65093@sunbay.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Sat, 7 Apr 2001, Ruslan Ermilov wrote: > I am about to bring in the latest CSRG revisions to -mdoc. > The only reason I am asking for a review here is that the > .Fn (and friends) macros were modified by CSRG to assert a > final semicolon (`;') after a function declaration in the > SYNOPSIS section. Does "assert" mean that they add this semicolon or check for it? From your later mail, I think it means that they add it. > If you have any ideas of why this should not be imported, > let me know now (I know some manpages abuse the .Fn macro > for cpp(1) macros declarations, but they basically need > this final `;' too). I'm not sure about that. The semicolon is a syntax error for a few (broken) declaration-like macros e.g., SYSINIT(). I think the change for actual functions is no worse than (ab)using .Fn for prototypes generally. If we ever have special markup for prototypes, it would be even more correct for it to add the semicolon than for .Fn. Bruce To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message