From owner-cvs-src@FreeBSD.ORG Fri Jan 7 17:37:00 2005 Return-Path: Delivered-To: cvs-src@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 4D64D16A4D6; Fri, 7 Jan 2005 17:36:59 +0000 (GMT) Received: from harmony.village.org (rover.village.org [168.103.84.182]) by mx1.FreeBSD.org (Postfix) with ESMTP id A004643D45; Fri, 7 Jan 2005 17:36:58 +0000 (GMT) (envelope-from imp@bsdimp.com) Received: from localhost (warner@rover2.village.org [10.0.0.1]) by harmony.village.org (8.13.1/8.13.1) with ESMTP id j07H8u5O001768; Fri, 7 Jan 2005 10:08:56 -0700 (MST) (envelope-from imp@bsdimp.com) Date: Fri, 07 Jan 2005 10:09:24 -0700 (MST) Message-Id: <20050107.100924.112818131.imp@bsdimp.com> To: paul@originative.co.uk From: "M. Warner Losh" In-Reply-To: <20050107111311.GC18004@myrddin.originative.co.uk> References: <20050106101233.GL16316@myrddin.originative.co.uk> <20050106.122059.74757197.imp@harmony.village.org> <20050107111311.GC18004@myrddin.originative.co.uk> X-Mailer: Mew version 3.3 on Emacs 21.3 / Mule 5.0 (SAKAKI) Mime-Version: 1.0 Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit cc: src-committers@freebsd.org cc: jhb@freebsd.org cc: cvs-src@freebsd.org cc: cvs-all@freebsd.org cc: phk@phk.freebsd.dk cc: colin.percival@wadham.ox.ac.uk Subject: Re: cvs commit: src/share/man/man9 style.9 X-BeenThere: cvs-src@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the src tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 07 Jan 2005 17:37:00 -0000 In message: <20050107111311.GC18004@myrddin.originative.co.uk> Paul Richards writes: : On Thu, Jan 06, 2005 at 12:20:59PM -0700, Warner Losh wrote: : > : > I've actually given the matter a lot of thought, and simpler : > definitely is better here. There are too many different kinds of : > licenses in the tree (hundreds of variations to the standard BSD : > license, the mit license, and all the my little pony licenses that : > likely will be headache for us one day) to do anything other than : > , which is what the - tag does for us : > unobtrusively. : : Yeah, that's what I'd have assumed for the license but there are : probably other things that could be marked up for processing as : well. I think Doug's been using Doxygen in some places in the tree. I think Doxygen is a great tool, and we should use it more. However, it isn't the right tool for this job... : > Having said that, if you are willing to step to the plate and do the : > work necessary to make a more complex scheme work, be my guest. I'm : > not presently planning on doing that. : : I don't mind doing some work in this area. My choice would be to : use XML though since that's an universal technology that we're : beginning to use in lots of other places as well, so to me it would : make sense to keep to the one technology. Adopting XML for XML's sake is silly. Had I done that, I'd have to commit to every single file, since nothing used that yet. As it was, I had to touch maybe 65% of the tree. The up side is that now I have a long list of files that have some issue or another with their notices... Also, like I said, there's no standard here. This project uses these tags, that project uses other tags. It would be hard to get anything 'complicated' integrated into other system, so I went with the simplest solution possible. A coworker wrote a command that nicely harvests all of the License notices, eliminates some of the mindless duplication, leaving only other kinds of duplication to worry about... Warner