From owner-cvs-src@FreeBSD.ORG  Wed Jan  5 21:43:09 2005
Return-Path: <owner-cvs-src@FreeBSD.ORG>
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 10C3216A4CF; Wed,  5 Jan 2005 21:43:09 +0000 (GMT)
Received: from critter.freebsd.dk (f170.freebsd.dk [212.242.86.170])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id 24D4E43D48; Wed,  5 Jan 2005 21:43:08 +0000 (GMT)
	(envelope-from phk@critter.freebsd.dk)
Received: from critter.freebsd.dk (localhost [127.0.0.1])
	by critter.freebsd.dk (8.13.1/8.13.1) with ESMTP id j05Lh61L040696;
	Wed, 5 Jan 2005 22:43:06 +0100 (CET)
	(envelope-from phk@critter.freebsd.dk)
To: John Baldwin <jhb@FreeBSD.org>
From: "Poul-Henning Kamp" <phk@phk.freebsd.dk>
In-Reply-To: Your message of "Wed, 05 Jan 2005 15:21:08 EST."
             <200501051521.08617.jhb@FreeBSD.org> 
Date: Wed, 05 Jan 2005 22:43:06 +0100
Message-ID: <40695.1104961386@critter.freebsd.dk>
Sender: phk@critter.freebsd.dk
cc: cvs-src@FreeBSD.org
cc: src-committers@FreeBSD.org
cc: Warner Losh <imp@FreeBSD.org>
cc: cvs-all@FreeBSD.org
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 <cvs-src.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-src>,
	<mailto:cvs-src-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/cvs-src>
List-Post: <mailto:cvs-src@freebsd.org>
List-Help: <mailto:cvs-src-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/cvs-src>,
	<mailto:cvs-src-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 05 Jan 2005 21:43:09 -0000

In message <200501051521.08617.jhb@FreeBSD.org>, John Baldwin writes:
>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.

That's not really a big problem since the copyright should always be the
first comment in the file.

A harder problem is to detect when the copyright ends.

It could be an idea to add a convention for explicitly marking the
start and end of "file restrictions" but then again it could also
be wast overkill.

-- 
Poul-Henning Kamp       | UNIX since Zilog Zeus 3.20
phk@FreeBSD.ORG         | TCP/IP since RFC 956
FreeBSD committer       | BSD since 4.3-tahoe    
Never attribute to malice what can adequately be explained by incompetence.