On Mon, Sep 19, 2016 at 2:43 PM, Conrad E. Meyer <c...@freebsd.org> wrote:
> Author: cem
> Date: Mon Sep 19 20:43:03 2016
> New Revision: 305998
> URL: https://svnweb.freebsd.org/changeset/base/305998
> Log:
>   Move sys/capsicum.h includes after types.h or param.h
>   This is not actually documented or even implied in style(9).  Make the 
> change
>   to match convention.  Someone should document this convention in style(9).

style(9) should be read as an annotated example. It comes first in the
example, therefore, it's convention. It is documented, just poorly.
There's many examples in style(9) that are treated this way and it
takes much careful study to understand it. It's tribal knowledge, and
sometimes the only way to learn is to transgress.

Attempts to modify style(9) are fraught with politics, intrigue and
generally a lot of flames even when all that's being done is codifying
existing practice. When I tried to do this last it was a shit storm,
and generally things devolve into a shit storm with no real gain.

svn-src-all@freebsd.org mailing list
To unsubscribe, send any mail to "svn-src-all-unsubscr...@freebsd.org"

Reply via email to