From owner-cvs-all@FreeBSD.ORG Wed Jan 5 21:15:27 2005 Return-Path: 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 21A7716A4CE; Wed, 5 Jan 2005 21:15:27 +0000 (GMT) Received: from harmony.village.org (rover.village.org [168.103.84.182]) by mx1.FreeBSD.org (Postfix) with ESMTP id AFEAB43D1F; Wed, 5 Jan 2005 21:15:26 +0000 (GMT) (envelope-from imp@harmony.village.org) Received: from localhost (localhost [IPv6:::1]) by harmony.village.org (8.13.1/8.13.1) with ESMTP id j05LEes5013018; Wed, 5 Jan 2005 14:14:40 -0700 (MST) (envelope-from imp@harmony.village.org) Date: Wed, 05 Jan 2005 14:14:39 -0700 (MST) Message-Id: <20050105.141439.74745436.imp@harmony.village.org> To: jhb@FreeBSD.org From: Warner Losh In-Reply-To: <200501051521.08617.jhb@FreeBSD.org> References: <200501051916.j05JG1iH029185@repoman.freebsd.org> <200501051521.08617.jhb@FreeBSD.org> 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: cvs-src@FreeBSD.org cc: src-committers@FreeBSD.org cc: imp@FreeBSD.org cc: cvs-all@FreeBSD.org Subject: Re: cvs commit: src/share/man/man9 style.9 X-BeenThere: cvs-all@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 05 Jan 2005 21:15:27 -0000 > On Wednesday 05 January 2005 02:16 pm, Warner Losh wrote: > > imp 2005-01-05 19:16:01 UTC > > > > FreeBSD src repository > > > > Modified files: > > share/man/man9 style.9 > > Log: > > A large majority of the source files in the tree start their license > > and copyright statements in a comment that begins with /*-. Document > > this tradition. A strict adherence to this rule will help resellers > > that wish to publish all copyright notices, generated automatically > > from the tree. There are too many variant licenses to do it purely > > by more complicated pattern matching. > > I thought the reason for the - is that it prevented indent(1) from trying to > reindent that comment block and thus there might be comment blocks with a > leading '/*-' that aren't copyrights. There might be, yes, and I've added a note to style(9) in my tree explaining that. In a quick straw poll of the source tree, I found no comments starting in column 1 that weren't a license statement. That's true that's what the /*- is for, but if any come to light, you can change it to /** just as easily. There are dozens in the tree that aren't in the first column, and hundreds that should have it marked, but don't. None of these are affected by this slight change of convention. Warner