From owner-cvs-all Fri Aug 16 3: 2:17 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 3546D37B400; Fri, 16 Aug 2002 03:02:13 -0700 (PDT) Received: from alpha.develop.ferrari.net (host1.ferrari-electronic.de [62.159.79.193]) by mx1.FreeBSD.org (Postfix) with ESMTP id 40C7543E72; Fri, 16 Aug 2002 03:02:10 -0700 (PDT) (envelope-from robert@ferrari-electronic.de) Received: (from robert@localhost) by alpha.develop.ferrari.net (8.11.6/8.11.6/SuSE Linux 0.5) id g7G9pR303463; Fri, 16 Aug 2002 11:51:27 +0200 Date: Fri, 16 Aug 2002 11:51:27 +0200 From: Robert Drehmel To: Bruce Evans Cc: Robert Drehmel , cvs-committers@FreeBSD.org, cvs-all@FreeBSD.org Subject: Re: cvs commit: src/lib/libc/net inet.3 Message-ID: <20020816115127.A3354@alpha.develop.ferrari.net> References: <200208152033.g7FKXi6V003503@freefall.freebsd.org> <20020816175616.U6226-100000@gamplex.bde.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20020816175616.U6226-100000@gamplex.bde.org> User-Agent: Mutt/1.3.22.1i Sender: owner-cvs-all@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG On Fri, Aug 16, 2002 at 06:07:57PM +1000, Bruce Evans wrote: > 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. People seem to have differing opinions about that. ru basically told me that using ".Fo .Fa* .Fc" or ".Fn" is ok. I am now a bit confused about what construct to use, i.e. what style is preferred. > 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). In my opinion, that looks especially concise for functions with many arguments like vm_map_lookup() in sys/vm/vm_map.c. > 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.) ciao, -robert To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe cvs-all" in the body of the message