Also allow and document a "build" ordering for variables.

Both "product" and "build" ordering are rampant in /usr/src.  This document
is not indented to be as strict as style(9) as historically BSD hasn't been
as consistent about Makefile as C code.  Also there are too many variations,
exceptions and allowances in out existing Makefile style to be strict.
However there is a general level of consensus on what the general BSD style
of our Makefiles is.  This manpage documents that "smell".
This commit is contained in:
David E. O'Brien 2003-03-02 02:51:40 +00:00
parent a250a46170
commit ed403545fc

View File

@ -64,7 +64,12 @@ Special variables (i.e.,
etc.) are listed in order of
.Dq product ,
then building and installing a binary.
The general order is:
It is also allowable to list special variables in
.Dq build
order: i.e., ones for the primary program (or library) first.
The general
.Dq product
order is:
.Va PROG Ns / Ns Va LIB Ns / Ns Va SCRIPT
.Va FILES
.Va LINKS
@ -76,6 +81,20 @@ The general order is:
.Va CFLAGS
.Va DPADD
.Va LDADD .
The general
.Dq build
order is:
.Va PROG Ns / Ns Va LIB Ns / Ns Va SCRIPT
.Va SRCS
.Va WARNS
.Va CFLAGS
.Va DPADD
.Va LDADD
.Va INCS
.Va FILES
.Va LINKS
.Oo Va NO Oc Ns Va MAN
.Va MLINKS.
.It
Omit
.Va SRCS