From owner-freebsd-doc@FreeBSD.ORG Wed Apr 24 19:22:03 2013 Return-Path: Delivered-To: www@freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id A2BD1561 for ; Wed, 24 Apr 2013 19:22:03 +0000 (UTC) (envelope-from 32zB4UQkJA64gYmZOaqqqUaOWZ.QcakkkTfSSPgR.cfU@maestro.bounces.google.com) Received: from mail-ob0-x248.google.com (mail-ob0-x248.google.com [IPv6:2607:f8b0:4003:c01::248]) by mx1.freebsd.org (Postfix) with ESMTP id 774351869 for ; Wed, 24 Apr 2013 19:22:03 +0000 (UTC) Received: by mail-ob0-f200.google.com with SMTP id wd20so11138424obb.11 for ; Wed, 24 Apr 2013 12:22:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:x-received:message-id:date:subject:from:to :content-type; bh=Z3wnb93flRCQdJlJcZFFP+OAB5TOFL8XPorTaFAUTIY=; b=gt5hg3a2eJXTrviLnCUC3jsHQy8zSZZb1CU8KMHfUWx4o2EqRStM86cQF3cVOZz+j6 N2l26c82KfcyOCy0RzoGygBWychZMAjipHu7klsrPb+L0fcbTA0UDGsHhkSluFS52GuG kT9FrkrM1Qxpn/AuP3l63oEE1SKqyyPIamHaod+UzXryfJ7oCkaOsTMhRKe46nRK6rOD YzdpAz3VGqdTupffPAH0TeCLIVaZEJ/WuP38Yv/zBNBaQ7ZybcUQ31P0tRuPVvXsvmKE fmzHEB+PDPSiJVsnXS9mwwHTTqaLNhSl5YwnRj5PGIWRjUkaGCs2ddfAWWl0ceEk+M1p Dhgw== MIME-Version: 1.0 X-Received: by 10.50.134.67 with SMTP id pi3mr30668226igb.7.1366831323013; Wed, 24 Apr 2013 12:22:03 -0700 (PDT) Message-ID: <047d7b3a984e79eb1d04db203761@google.com> Date: Wed, 24 Apr 2013 19:22:03 +0000 Subject: 1st Ranking On the Google From: Fiona Campbell To: www@freebsd.org Content-Type: text/plain; charset=ISO-8859-1; format=flowed; delsp=yes Content-Transfer-Encoding: base64 X-Content-Filtered-By: Mailman/MimeDel 2.1.14 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 24 Apr 2013 19:22:03 -0000 PHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxNC4wcHQ7Y29sb3I6 bmF2eSI+SGksIG15IG5hbWUgIA0KaXMNCkZpb25hIENhbXBiZWxsIGFuZCBJIGFtIGFuIE9ubGlu ZSBTdHJhdGVnaXN0LiA8L3NwYW4+PC9wPg0KDQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBz dHlsZT0iZm9udC1zaXplOjE0LjBwdDtjb2xvcjpuYXZ5Ij6gPC9zcGFuPjwvcD4NCg0KPHAgY2xh c3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxNC4wcHQ7Y29sb3I6bmF2eSI+ VGhlIHJlYXNvbiAgDQpmb3IgbXkNCmVtYWlsIGlzIEkgaGF2ZSBjb21lIGFjcm9zcyB5b3VyIHNp dGUgoDxpPjx1Pnd3dy5mcmVlYnNkLm9yZzwvdT48L2k+DQphbmQgZGVjaWRlZCB0byBydW4gYW4g YW5hbHlzaXMgb24geW91ciBjb21wZXRpdGlvbiBhbmQgeW91ciBjdXJyZW50IHNlYXJjaA0KcmFu a2luZ3MuIEkgYWxzbyB0cmllZCB0byBsb29rIGZvciB5b3VyIGJ1c2luZXNzIG9uIHZhcmlvdXMg c29jaWFsIG1lZGlhICANCnNpdGVzDQphbmQgcmVhbGx5IGNvdWxkbiYjMzk7dCBmaW5kIG11Y2gg ZWxzZSBhYm91dCB5b3UuPC9zcGFuPjwvcD4NCg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4g c3R5bGU9ImZvbnQtc2l6ZToxNC4wcHQ7Y29sb3I6bmF2eSI+PC9zcGFuPjwvcD4NCg0KPHAgY2xh c3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxNC4wcHQ7Y29sb3I6bmF2eSI+ oDwvc3Bhbj48L3A+DQoNCjxwIGNsYXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNp emU6MTQuMHB0O2NvbG9yOm5hdnkiPk92ZXIgdGhlICANCmxhc3QgMTINCm1vbnRocyBHT09HTEUg aGFzIHBsYWNlZCBzbyBtdWNoIGltcG9ydGFuY2Ugb24gQ29udGVudCBDcmVhdGlvbiAmYW1wOyBT b2NpYWwNCk1lZGlhIFBlcmZvcm1hbmNlIHRoYXQgaWYgeW91ciBidXNpbmVzcyBpc24mIzM5O3Qg Y3JlYXRpbmcgdmFsdWFibGUgY29udGVudCAgDQpvciBldmVuDQp2aXNpYmxlIGFjcm9zcyBzb2Np YWwgbWVkaWEgcGxhdGZvcm1zIHlvdSBoYXZlIGJhc2ljYWxseSBubyBjaGFuY2Ugb2YgYmVpbmcN CnNlZW4gb24gYW55IHNlYXJjaCBlbmdpbmUgZm9yIGtleXdvcmRzIHlvdXIgY3VzdG9tZXJzIGFy ZSB1c2luZyB0byBmaW5kDQpidXNpbmVzc2VzIGxpa2UgeW91Ljwvc3Bhbj48L3A+DQoNCjxwIGNs YXNzPSJNc29Ob3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTQuMHB0O2NvbG9yOm5hdnki PqA8L3NwYW4+PC9wPg0KDQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iZm9udC1z aXplOjE0LjBwdDtjb2xvcjpuYXZ5Ij5XaXRoIGEgc29saWQgIA0KcGxhbg0KYW5kIHN0cmF0ZWd5 IEkgaG9uZXN0bHkgYmVsaWV2ZSBJIGNhbiBoZWxwIGdldCB5b3VyIHdlYnNpdGUgcmFua2luZyBo aWdoZXIgIA0Kb24NCkdPT0dMRSBhbmQgZ2V0dGluZyBjdXN0b21lcnMgdG8gaW50ZXJhY3Qgd2l0 aCB5b3VyIGJ1c2luZXNzIG9uIFNvY2lhbCBNZWRpYSAgDQp0bw0KcmVhbGx5IGJ1aWxkIHlvdXIg YnJhbmQuPC9zcGFuPjwvcD4NCg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gc3R5bGU9ImZv bnQtc2l6ZToxNC4wcHQ7Y29sb3I6bmF2eSI+oDwvc3Bhbj48L3A+DQoNCjxwIGNsYXNzPSJNc29O b3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTQuMHB0O2NvbG9yOm5hdnkiPkRvbiYjMzk7 dCAgDQpnZXQgbWUgd3JvbmcNCnRoaXMgd29uJiMzOTt0IGJlIGVhc3kgKG9yIGV2ZXJ5b25lIHdv dWxkIGJlIGRvaW5nIGl0KSBidXQgSSB3b3VsZCBsb3ZlIHRvICANCmhlbHAgb3V0DQp3aXRoIG5v IG9ibGlnYXRpb25zIG9yIGNvbW1pdG1lbnRzLjwvc3Bhbj48L3A+DQoNCjxwIGNsYXNzPSJNc29O b3JtYWwiPjxzcGFuIHN0eWxlPSJmb250LXNpemU6MTQuMHB0O2NvbG9yOm5hdnkiPqA8L3NwYW4+ PC9wPg0KDQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjE0LjBw dDtjb2xvcjpuYXZ5Ij5DYW4gSSBjYWxsICANCnlvdSBhbmQNCnJ1biBzb21lIGlkZWFzIEkgaGF2 ZSB0byBoZWxwIHlvdXIgYnVzaW5lc3MgZ3Jvdz88L3NwYW4+PC9wPg0KDQo8cCBjbGFzcz0iTXNv Tm9ybWFsIj48c3BhbiBzdHlsZT0iZm9udC1zaXplOjE0LjBwdDtjb2xvcjpuYXZ5Ij6gPC9zcGFu PjwvcD4NCg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+PHNwYW4gIA0Kc3R5bGU9ImZvbnQtc2l6ZTox NC4wcHQ7Zm9udC1mYW1pbHk6QXJpYWw7Y29sb3I6bmF2eSI+UmVnYXJkcyw8L3NwYW4+PC9wPg0K DQo8cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiAgDQpzdHlsZT0iZm9udC1zaXplOjE0LjBwdDtm b250LWZhbWlseTpBcmlhbDtjb2xvcjpuYXZ5Ij48YnI+DQo8L3NwYW4+PHNwYW4gc3R5bGU9ImZv bnQtc2l6ZToxNC4wcHQ7Y29sb3I6bmF2eSI+RmlvbmEgQ2FtcGJlbGw8L3NwYW4+PC9wPg0KDQo8 cCBjbGFzcz0iTXNvTm9ybWFsIj48c3BhbiAgDQpzdHlsZT0iZm9udC1zaXplOjE0LjBwdDtmb250 LWZhbWlseTpBcmlhbDtjb2xvcjpuYXZ5Ij6gPC9zcGFuPjxzcGFuICANCnN0eWxlPSJmb250LXNp emU6MTQuMHB0O2NvbG9yOm5hdnkiPjwvc3Bhbj48L3A+DQoNCjxwIGNsYXNzPSJNc29Ob3JtYWwi PjxzcGFuICANCnN0eWxlPSJmb250LXNpemU6MTQuMHB0O2ZvbnQtZmFtaWx5OkFyaWFsO2NvbG9y Om5hdnkiPjxicj4NClNFTyBDby1vcmRpbmF0b3I8L3NwYW4+PHNwYW4gc3R5bGU9ImZvbnQtc2l6 ZToxNC4wcHQ7Y29sb3I6bmF2eSI+PC9zcGFuPjwvcD4NCg0KPHAgY2xhc3M9Ik1zb05vcm1hbCI+ PHNwYW4gc3R5bGU9ImZvbnQtc2l6ZToxNC4wcHQ7Y29sb3I6bmF2eSI+oDwvc3Bhbj48L3A+DQo= From owner-freebsd-doc@FreeBSD.ORG Wed Apr 24 22:00:00 2013 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id C543A59E for ; Wed, 24 Apr 2013 22:00:00 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id 92A9E106B for ; Wed, 24 Apr 2013 22:00:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.6/8.14.6) with ESMTP id r3OM006r009227 for ; Wed, 24 Apr 2013 22:00:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.6/8.14.6/Submit) id r3OM00p1009226; Wed, 24 Apr 2013 22:00:00 GMT (envelope-from gnats) Resent-Date: Wed, 24 Apr 2013 22:00:00 GMT Resent-Message-Id: <201304242200.r3OM00p1009226@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Garrett Cooper Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id A1775583 for ; 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 ; 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 ; 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 To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Subject: docs/178119: [ports] Porter's handbook lacks examples for using OptionsNG from make.conf, etc X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 24 Apr 2013 22:00:00 -0000 >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: