proper use of bsd.port.options.mk

[Warren Block]

On Sun, 15 May 2011, Doug Barton wrote:

> I'm confused (yeah, I know, nothing new about that). From 
> ports/Mk/bsd.port.options.mk:
>
> # usage:
> #
> #       .include "bsd.port.options.mk"
> #       <deal with user options>
> #       .include "bsd.port.pre.mk"
> #       <other work, including adjusting dependencies>
> #       .include "bsd.port.post.mk"
>
>
> However the ports I've looked at so far all do:
>
> OPTIONS=	blah
>
> .include <bsd.port.options.mk>
>
> blah
>
> .include <bsd.port.mk>
> EOF
>
> I assume that this method works, since it seems like so many ports use it. 
> Should the notes in options.mk be updated?

Yes, it should be updated.  See examples "5.8 Simple use of OPTIONS" and 
"5.9 Old style use of OPTIONS" in the Porter's Handbook:

http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-options.html