From owner-cvs-all  Fri Aug 16  1: 1:11 2002
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 D6A5F37B400; Fri, 16 Aug 2002 01:01:05 -0700 (PDT)
Received: from mailman.zeta.org.au (mailman.zeta.org.au [203.26.10.16])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 592BC43E65; Fri, 16 Aug 2002 01:01:04 -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 IAA16775;
	Fri, 16 Aug 2002 08:01:01 GMT
Date: Fri, 16 Aug 2002 18:07:57 +1000 (EST)
From: Bruce Evans <bde@zeta.org.au>
X-X-Sender: bde@gamplex.bde.org
To: Robert Drehmel <robert@FreeBSD.org>
Cc: cvs-committers@FreeBSD.org, <cvs-all@FreeBSD.org>
Subject: Re: cvs commit: src/lib/libc/net inet.3
In-Reply-To: <200208152033.g7FKXi6V003503@freefall.freebsd.org>
Message-ID: <20020816175616.U6226-100000@gamplex.bde.org>
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-cvs-all@FreeBSD.ORG
Precedence: bulk
List-ID: <cvs-all.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20cvs-all>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20cvs-all>
X-Loop: FreeBSD.ORG

On Thu, 15 Aug 2002, Robert Drehmel wrote:

> robert      2002/08/15 13:33:44 PDT
>
>   Modified files:
>     lib/libc/net         inet.3
>   Log:
>   Put each function argument on its own line to keep lines shorter
>   than 80 columns.
>
>   Revision  Changes    Path
>   1.24      +6 -1      src/lib/libc/net/inet.3

The limit of 9 macro args was fixed a year or two ago, and backslash/newline
in man pages has worked for much longer, so man pages should be changed
away from using the ugly .Fo ... .Fc construct and not towards it.
Especially when you change the corresponding non-ugly C construct in the
opposite direction :-).  (Some people prefer old-style ANSI function
declarations (with one physical line per parameter) to new-style ANSI
function declarations (with all parameters on 1 longical line).  The
separate lines at least provide a good place to put comments on the
parameters in C declarations.  This advantage doesn't apply to prototypes
in either C code or man pages.)

Bruce


To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe cvs-all" in the body of the message