Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 05 Jan 2005 22:43:06 +0100
From:      "Poul-Henning Kamp" <phk@phk.freebsd.dk>
To:        John Baldwin <jhb@FreeBSD.org>
Cc:        cvs-all@FreeBSD.org
Subject:   Re: cvs commit: src/share/man/man9 style.9 
Message-ID:  <40695.1104961386@critter.freebsd.dk>
In-Reply-To: Your message of "Wed, 05 Jan 2005 15:21:08 EST." <200501051521.08617.jhb@FreeBSD.org> 

next in thread | previous in thread | raw e-mail | index | archive | help
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.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?40695.1104961386>