From owner-cvs-share Thu Mar 20 12:21:31 1997 Return-Path: Received: (from root@localhost) by freefall.freebsd.org (8.8.5/8.8.5) id MAA04705 for cvs-share-outgoing; Thu, 20 Mar 1997 12:21:31 -0800 (PST) Received: from relay.nuxi.com (nuxi.ucdavis.edu [128.120.175.23]) by freefall.freebsd.org (8.8.5/8.8.5) with ESMTP id MAA04700; Thu, 20 Mar 1997 12:21:28 -0800 (PST) Received: from dragon.nuxi.com (dav1-19.calweb.com [207.211.82.19]) by relay.nuxi.com (8.8.5/8.6.12) with ESMTP id MAA04906; Thu, 20 Mar 1997 12:23:56 GMT Received: (from obrien@localhost) by dragon.nuxi.com (8.8.5/8.7.3) id UAA07920; Thu, 20 Mar 1997 20:21:22 GMT Message-ID: <19970320122121.52629@dragon.nuxi.com> Date: Thu, 20 Mar 1997 12:21:21 -0800 From: "David O'Brien" To: CVS-committers@freefall.freebsd.org, cvs-all@freefall.freebsd.org, cvs-share@freefall.freebsd.org Subject: Re: cvs commit: src/share/man/man3 fpgetround.3 References: <199703192042.MAA20789@freefall.freebsd.org> <199703192114.NAA22739@freefall.freebsd.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.66 Reply-To: obrien@NUXI.com X-Warning: Mutt Bites! Organization: The NUXI *BSD group X-PGP-Fingerprint: B7 4D 3E E9 11 39 5F A3 90 76 5D 69 58 D9 98 7A X-Pgp-Keyid: 34F9F9D5 Sender: owner-cvs-share@FreeBSD.ORG X-Loop: FreeBSD.org Precedence: bulk On Wed, Mar 19, 1997 at 01:13:59PM -0800, Mike Pritchard wrote: > > Log: > > Fixed misuse of .Ft for enum members. (.Fa seems to be the best > > available macro for enum, struct and union members. .Ft seems to > > be the best available macro for enum, struct and union tags and > > types). > > I was trying to figure out the best way to do this, and I'm leaning > towards removing this type of thing from the SYNOPSIS section. > I think they are better placed in the main manual page text, and > defined within literal text blocks. Someone who is just checking the If this changes a large number of man pages, they should be left alone IMHO. If it is just a few of them that abuse the SYNOPSIS section, then cool. If it is a lot of man pages that do this, then that implies this usage was the intention of the CSRG. I was drawn to *BSD vs. Linux for folklore and history reason. It was only after trying FreeBSD that I found all the other reasons to use it over Linux. So I really like keeping our heritage alone when there isn't a completing reason not to. -- -- David (obrien@NUXI.com -or- obrien@FreeBSD.org)