docs/178119: [ports] Porter's handbook lacks examples for using OptionsNG from make.conf, etc

[Garrett Cooper]

>Number:         178119
>Category:       docs
>Synopsis:       [ports] Porter's handbook lacks examples for using OptionsNG from make.conf, etc
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Apr 24 22:00:00 UTC 2013
>Closed-Date:
>Last-Modified:
>Originator:     Garrett Cooper
>Release:        n/a
>Organization:
EMC Isilon
>Environment:
n/a
>Description:
How OptionsNG could/should be used via make.conf, isn't documented in the Porters Handbook ( http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/makefile-options.html, under OPTIONS ), even though USE_* and KNOBS have sufficient developer and end-user examples for using them.

The best comprehensive example for using OptionsNG I found was on the forums: http://forums.freebsd.org/showthread.php?t=34019 .

Basically, it would be nice for there to be a Makefile in ports that's used as a template for the explanation and would be worked into a full blown "here is how you tweak the port options via the command-line/make.conf" explanation.
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted: