Clarify /*- convention.

This commit is contained in:
imp 2005-01-05 21:27:01 +00:00
parent 65d4d80800
commit c00855c99f

View File

@ -1,4 +1,5 @@
.\" Copyright (c) 1995-2001 FreeBSD Inc.
.\"-
.\" Copyright (c) 1995-2005 The FreeBSD Project
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
@ -22,7 +23,6 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"
.Dd December 7, 2001
.Dt STYLE 9
.Os
@ -62,11 +62,21 @@ The copyright header should be a muli-line comment, with the first
line of the comment having a dash after the star like so:
.Bd -literal
/*-
* Copyright 1942 M. Warner Losh. All Rights Reserved.
* Copyright (c) 1984-2025 John Q. Public. All Rights Reserved.
*
* Long, boring license goes here, but redacted for brevity
*/
.Ed
An automatic script collects license information from the tree for
all comments that start in the first column with
.Dq Li "/*-" .
If you desire to flag
.Xr indent 1
to not reformat a comment that starts in the first column which is not a
license or copyright notice, change the dash to a star for those
comments.
Coments starting in columns other than the first comment are never
considered license statements.
.Pp
After any copyright header, there is a blank line, and the
.Va rcsid