Date: Fri, 16 Aug 2002 11:51:27 +0200 From: Robert Drehmel <robert@ferrari-electronic.de> To: Bruce Evans <bde@zeta.org.au> Cc: Robert Drehmel <robert@FreeBSD.org>, 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> In-Reply-To: <20020816175616.U6226-100000@gamplex.bde.org> References: <200208152033.g7FKXi6V003503@freefall.freebsd.org> <20020816175616.U6226-100000@gamplex.bde.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20020816115127.A3354>