Re: style(9) questions about Copyright comment

Warner Losh <[email protected]> Sat, 1 Aug 2026 15:43:08 -0600
Newsgroups gmane.os.freebsd.devel.hackers
Message-ID <CANCZdfpddGEaLNUtdMEu0kLupziyvYGMS9vELXjAznx8__+x9w@mail.gmail.com>
--000000000000afe112065803316f
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

=E2=81=B9

On Sat, Aug 1, 2026, 12:29=E2=80=AFPM Steve Kargl <[email protected]> wrot=
e:

> In reading style(9), it states the comment with the
> the Copyright should appear as
>
> /*
>   * Copyright (c) 1984-2025 John Q. Public
>   *
>   * SPDX-License-Identifier: BSD-2-Clause
>   */
>
> which appears contrary with regards to practice.  The
> opening line for a Copyright comment contains a minus
> sign, i.e.,
>
> /*-
>   * Copyright (c) 1984-2025 John Q. Public
>   *
>   * SPDX-License-Identifier: BSD-2-Clause
>   */
>
> Should style(9) be fixed?
>

No. Both orders are common.

I just updated and consolidated out copyright and licensing stuff too.

https://docs.freebsd.org/en/articles/license-guide/

I think things are consistent now, but if I've missed anything please let
me know.

Warner

--=20
> steve
>
>

--000000000000afe112065803316f
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"auto"><div>=E2=81=B9<br><br><div class=3D"gmail_quote gmail_quo=
te_container"><div dir=3D"ltr" class=3D"gmail_attr">On Sat, Aug 1, 2026, 12=
:29=E2=80=AFPM Steve Kargl &lt;<a href=3D"mailto:[email protected]">kargls=
@comcast.net</a>&gt; wrote:<br></div><blockquote class=3D"gmail_quote" styl=
e=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">In read=
ing style(9), it states the comment with the<br>
the Copyright should appear as<br>
<br>
/*<br>
=C2=A0 * Copyright (c) 1984-2025 John Q. Public<br>
=C2=A0 *<br>
=C2=A0 * SPDX-License-Identifier: BSD-2-Clause<br>
=C2=A0 */<br>
<br>
which appears contrary with regards to practice.=C2=A0 The<br>
opening line for a Copyright comment contains a minus<br>
sign, i.e.,<br>
<br>
/*-<br>
=C2=A0 * Copyright (c) 1984-2025 John Q. Public<br>
=C2=A0 *<br>
=C2=A0 * SPDX-License-Identifier: BSD-2-Clause<br>
=C2=A0 */<br>
<br>
Should style(9) be fixed?<br></blockquote></div></div><div dir=3D"auto"><br=
></div><div dir=3D"auto">No. Both orders are common.</div><div dir=3D"auto"=
><br></div><div dir=3D"auto">I just updated and consolidated out copyright =
and licensing stuff too.</div><div dir=3D"auto"><br></div><div dir=3D"auto"=
><a href=3D"https://docs.freebsd.org/en/articles/license-guide/">https://do=
cs.freebsd.org/en/articles/license-guide/</a></div><div dir=3D"auto"><br></=
div><div dir=3D"auto">I think things are consistent now, but if I&#39;ve=C2=
=A0missed anything please let me know.=C2=A0</div><div dir=3D"auto"><br></d=
iv><div dir=3D"auto">Warner</div><div dir=3D"auto"><br></div><div dir=3D"au=
to"><div class=3D"gmail_quote gmail_quote_container"><blockquote class=3D"g=
mail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-l=
eft:1ex">
-- <br>
steve<br>
<br>
</blockquote></div></div></div>

--000000000000afe112065803316f--