From nobody@FreeBSD.org  Wed Apr 24 21:58:08 2013
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
	by hub.freebsd.org (Postfix) with ESMTP id A1775583
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 24 Apr 2013 21:58:08 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id 92176105E
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 24 Apr 2013 21:58:08 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.5/8.14.5) with ESMTP id r3OLw83s099049
	for <freebsd-gnats-submit@FreeBSD.org>; Wed, 24 Apr 2013 21:58:08 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.5/8.14.5/Submit) id r3OLw89Q099048;
	Wed, 24 Apr 2013 21:58:08 GMT
	(envelope-from nobody)
Message-Id: <201304242158.r3OLw89Q099048@red.freebsd.org>
Date: Wed, 24 Apr 2013 21:58:08 GMT
From: Garrett Cooper <yaneurabeya@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: [ports] Porter's handbook lacks examples for using OptionsNG from make.conf, etc
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>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:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Apr 24 22:00:00 UTC 2013
>Closed-Date:    Thu Mar 27 06:09:23 CDT 2014
>Last-Modified:  Thu Mar 27 06:09:23 CDT 2014
>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:
State-Changed-From-To: open->closed 
State-Changed-By: bdrewery 
State-Changed-When: Thu Mar 27 06:09:22 CDT 2014 
State-Changed-Why:  
done 

http://www.freebsd.org/cgi/query-pr.cgi?pr=178119 
>Unformatted:
