From owner-freebsd-doc@FreeBSD.ORG Sun May 27 16:02:03 2012 Return-Path: Delivered-To: doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 2CA99106566B; Sun, 27 May 2012 16:02:03 +0000 (UTC) (envelope-from wblock@wonkity.com) Received: from wonkity.com (wonkity.com [67.158.26.137]) by mx1.freebsd.org (Postfix) with ESMTP id C19058FC0C; Sun, 27 May 2012 16:02:02 +0000 (UTC) Received: from wonkity.com (localhost [127.0.0.1]) by wonkity.com (8.14.5/8.14.5) with ESMTP id q4RG21PR049078; Sun, 27 May 2012 10:02:01 -0600 (MDT) (envelope-from wblock@wonkity.com) Received: from localhost (wblock@localhost) by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id q4RG21tt049075; Sun, 27 May 2012 10:02:01 -0600 (MDT) (envelope-from wblock@wonkity.com) Date: Sun, 27 May 2012 10:02:01 -0600 (MDT) From: Warren Block To: Chris Rees In-Reply-To: Message-ID: References: User-Agent: Alpine 2.00 (BSF 1167 2008-08-23) MIME-Version: 1.0 Content-Type: MULTIPART/MIXED; BOUNDARY="-902635197-1144049882-1338134521=:48564" X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7 (wonkity.com [127.0.0.1]); Sun, 27 May 2012 10:02:01 -0600 (MDT) Cc: doc@freebsd.org, portmgr@freebsd.org Subject: Re: New docs for OPTIONS X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 27 May 2012 16:02:03 -0000 This message is in MIME format. The first part should be readable text, while the remaining parts are likely unreadable without MIME-aware tools. ---902635197-1144049882-1338134521=:48564 Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed On Sat, 26 May 2012, Chris Rees wrote: > We have a new world order for OPTIONS in ports (exciting, isn't it??), > and would very much like to document it. > > I've prepared the following patch which has had fairly extensive > review, apart from not having a formal approval by a docs person. > > Would anyone mind giving it a check and approving it please? Bapt > plans to commit the code later this week, and it'd be great to have > approval by then! > > Thanks, > > Chris > > > http://www.bayofrum.net/~crees/patches/optionsng-docs-patch.diff > > http://www.bayofrum.net/~crees/rendered/porters-optionsng.html Attached is a full patch that builds on that. Some simplifications and clarifications, and an added tip on helpful descriptions. ---902635197-1144049882-1338134521=:48564 Content-Type: TEXT/PLAIN; charset=US-ASCII; name=patch-porters-options-1.diff Content-Transfer-Encoding: BASE64 Content-ID: Content-Description: Content-Disposition: attachment; filename=patch-porters-options-1.diff SW5kZXg6IGRvYy9lbl9VUy5JU084ODU5LTEvYm9va3MvcG9ydGVycy1oYW5k Ym9vay9ib29rLnNnbWwNCj09PT09PT09PT09PT09PT09PT09PT09PT09PT09 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0NCi0tLSBk b2MvZW5fVVMuSVNPODg1OS0xL2Jvb2tzL3BvcnRlcnMtaGFuZGJvb2svYm9v ay5zZ21sCShyZXZpc2lvbiAzODg5MSkNCisrKyBkb2MvZW5fVVMuSVNPODg1 OS0xL2Jvb2tzL3BvcnRlcnMtaGFuZGJvb2svYm9vay5zZ21sCSh3b3JraW5n IGNvcHkpDQpAQCAtMzY2MywxOSArMzY2MywxNyBAQA0KICAgICAgIDxzZWN0 MiBpZD0idXNlLXZhcnMiPg0KIAk8dGl0bGU+PG1ha2V2YXI+VVNFXzxyZXBs YWNlYWJsZT4qPC9yZXBsYWNlYWJsZT48L21ha2V2YXI+PC90aXRsZT4NCiAN Ci0JPHBhcmE+QSBudW1iZXIgb2YgdmFyaWFibGVzIGV4aXN0IGluIG9yZGVy IHRvIGVuY2Fwc3VsYXRlDQotCSAgY29tbW9uIGRlcGVuZGVuY2llcyB0aGF0 IG1hbnkgcG9ydHMgaGF2ZS4gIEFsdGhvdWdoIHRoZWlyDQotCSAgdXNlIGlz IG9wdGlvbmFsLCB0aGV5IGNhbiBoZWxwIHRvIHJlZHVjZSB0aGUgdmVyYm9z aXR5IG9mDQorCTxwYXJhPlNldmVyYWwgdmFyaWFibGVzIGV4aXN0IHRvIGRl ZmluZQ0KKwkgIGNvbW1vbiBkZXBlbmRlbmNpZXMgc2hhcmVkIGJ5IG1hbnkg cG9ydHMuICBUaGVpcg0KKwkgIHVzZSBpcyBvcHRpb25hbCwgYnV0IGhlbHBz IHRvIHJlZHVjZSB0aGUgdmVyYm9zaXR5IG9mDQogCSAgdGhlIHBvcnQgPGZp bGVuYW1lPk1ha2VmaWxlPC9maWxlbmFtZT5zLiAgRWFjaCBvZiB0aGVtIGlz DQogCSAgc3R5bGVkIGFzDQotCSAgPG1ha2V2YXI+VVNFXzxyZXBsYWNlYWJs ZT4qPC9yZXBsYWNlYWJsZT48L21ha2V2YXI+LiAgVGhlDQotCSAgdXNhZ2Ug b2YgdGhlc2UgdmFyaWFibGVzIGlzIHJlc3RyaWN0ZWQgdG8gdGhlIHBvcnQN CisJICA8bWFrZXZhcj5VU0VfPHJlcGxhY2VhYmxlPio8L3JlcGxhY2VhYmxl PjwvbWFrZXZhcj4uDQorCSAgVGhlc2UgdmFyaWFibGVzIG1heSBiZSB1c2Vk IG9ubHkgaW4gdGhlIHBvcnQNCiAJICA8ZmlsZW5hbWU+TWFrZWZpbGU8L2Zp bGVuYW1lPnMgYW5kDQotCSAgPGZpbGVuYW1lPnBvcnRzL01rL2JzZC4qLm1r PC9maWxlbmFtZT4gYW5kIGlzIG5vdCBkZXNpZ25lZA0KLQkgIHRvIGVuY2Fw c3VsYXRlIHVzZXItc2V0dGFibGUgb3B0aW9ucyAmbWRhc2g7IHVzZQ0KLQkg IDxtYWtldmFyPldJVEhfPHJlcGxhY2VhYmxlPio8L3JlcGxhY2VhYmxlPjwv bWFrZXZhcj4gYW5kDQotCSAgPG1ha2V2YXI+V0lUSE9VVF88cmVwbGFjZWFi bGU+KjwvcmVwbGFjZWFibGU+PC9tYWtldmFyPiBmb3INCi0JICB0aGF0IHB1 cnBvc2UuPC9wYXJhPg0KKwkgIDxmaWxlbmFtZT5wb3J0cy9Nay9ic2QuKi5t azwvZmlsZW5hbWU+LiAgVGhleSBhcmUgbm90IG1lYW50DQorCSAgZm9yIHVz ZXItc2V0dGFibGUgb3B0aW9ucyAmbWRhc2g7IHVzZQ0KKwkgIDxtYWtldmFy PlBPUlRfT1BUSU9OUzwvbWFrZXZhcj4gZm9yIHRoYXQgcHVycG9zZS48L3Bh cmE+DQogDQogCTxub3RlPg0KIAkgIDxwYXJhPkl0IGlzIDxlbXBoYXNpcz5h bHdheXM8L2VtcGhhc2lzPiBpbmNvcnJlY3QgdG8gc2V0IGFueQ0KQEAgLTM4 ODAsMTEgKzM4NzgsMTIgQEANCiAJPGV4YW1wbGU+DQogCSAgPHRpdGxlPkNv cnJlY3QgRGVjbGFyYXRpb24gb2YgYW4gT3B0aW9uYWwgRGVwZW5kZW5jeTwv dGl0bGU+DQogDQotCSAgPHByb2dyYW1saXN0aW5nPk9QVElPTlM9CUJBUgki RW5hYmxlIGJhciBzdXBwb3J0IiBvZmYNCisJICA8cHJvZ3JhbWxpc3Rpbmc+ T1BUSU9OU19ERUZJTkU9CUJBUg0KK0JBUl9ERVNDPQlFbmFibGUgYmFyIHN1 cHBvcnQNCiANCi0uaW5jbHVkZSAmbHQ7YnNkLnBvcnQucHJlLm1rJmd0Ow0K Ky5pbmNsdWRlICZsdDtic2QucG9ydC5vcHRpb25zLm1rJmd0Ow0KIA0KLS5p ZiBkZWZpbmVkKFdJVEhfQkFSKSAmJiAhZGVmaW5lZChXSVRIT1VUX0JBUikN CisuaWYgJHtQT1JUT1BUSU9OUzpNQkFSfQ0KIExJQl9ERVBFTkRTPQliYXI6 JHtQT1JUU0RJUn0vZm9vL2Jhcg0KIC5lbmRpZjwvcHJvZ3JhbWxpc3Rpbmc+ DQogCTwvZXhhbXBsZT4NCkBAIC00MDg5LDE1ICs0MDg4LDE0IEBADQogICAg IDxzZWN0MSBpZD0ibWFrZWZpbGUtb3B0aW9ucyI+DQogICAgICAgPHRpdGxl Pk1ha2VmaWxlIE9wdGlvbnM8L3RpdGxlPg0KIA0KLSAgICAgIDxwYXJhPlNv bWUgbGFyZ2UgYXBwbGljYXRpb25zIGNhbiBiZSBidWlsdCBpbiBhIG51bWJl ciBvZg0KLQljb25maWd1cmF0aW9ucywgYWRkaW5nIGZ1bmN0aW9uYWxpdHkg aWYgb25lIG9mIGEgbnVtYmVyIG9mDQotCWxpYnJhcmllcyBvciBhcHBsaWNh dGlvbnMgaXMgYXZhaWxhYmxlLiAgRXhhbXBsZXMgaW5jbHVkZQ0KKyAgICAg IDxwYXJhPk1hbnkgYXBwbGljYXRpb25zIGNhbiBiZSBidWlsdCB3aXRoIG9w dGlvbmFsIG9yIGRpZmZlcmluZw0KKwljb25maWd1cmF0aW9ucy4gIEV4YW1w bGVzIGluY2x1ZGUNCiAJY2hvaWNlIG9mIG5hdHVyYWwgKGh1bWFuKSBsYW5n dWFnZSwgR1VJIHZlcnN1cyBjb21tYW5kLWxpbmUsDQotCW9yIHR5cGUgb2Yg ZGF0YWJhc2UgdG8gc3VwcG9ydC4gIFNpbmNlIG5vdCBhbGwgdXNlcnMgd2Fu dA0KLQl0aG9zZSBsaWJyYXJpZXMgb3IgYXBwbGljYXRpb25zLCB0aGUgcG9y dHMgc3lzdGVtIHByb3ZpZGVzDQotCWhvb2tzIHRoYXQgdGhlIHBvcnQgYXV0 aG9yIGNhbiB1c2UgdG8gY29udHJvbCB3aGljaA0KLQljb25maWd1cmF0aW9u IHNob3VsZCBiZSBidWlsdC4gIFN1cHBvcnRpbmcgdGhlc2UgcHJvcGVybHkg d2lsbA0KLQltYWtlIHVzZXJzIGhhcHB5LCBhbmQgZWZmZWN0aXZlbHkgcHJv dmlkZSAyIG9yIG1vcmUgcG9ydHMgZm9yDQorCW9yIHR5cGUgb2YgZGF0YWJh c2UgdG8gc3VwcG9ydC4gIFVzZXJzIG1heSBuZWVkIGEgZGlmZmVyZW50DQor CWNvbmZpZ3VyYXRpb24gdGhhbiB0aGUgZGVmYXVsdCwgc28gdGhlIHBvcnRz IHN5c3RlbSBwcm92aWRlcw0KKwlob29rcyB0aGUgcG9ydCBhdXRob3IgY2Fu IHVzZSB0byBjb250cm9sIHdoaWNoIHZhcmlhdGlvbg0KKwl3aWxsIGJlIGJ1 aWx0LiAgU3VwcG9ydGluZyB0aGVzZSBvcHRpb25zIHByb3Blcmx5IHdpbGwN CisJbWFrZSB1c2VycyBoYXBweSwgYW5kIGVmZmVjdGl2ZWx5IHByb3ZpZGUg dHdvIG9yIG1vcmUgcG9ydHMgZm9yDQogCXRoZSBwcmljZSBvZiBvbmUuPC9w YXJhPg0KIA0KICAgICAgIDxzZWN0Mj4NCkBAIC00MTA5LDcgKzQxMDcsNyBA QA0KIAkgICAgPG1ha2V2YXI+V0lUSE9VVF88cmVwbGFjZWFibGU+KjwvcmVw bGFjZWFibGU+PC9tYWtldmFyPjwvdGl0bGU+DQogDQogCSAgPHBhcmE+VGhl c2UgdmFyaWFibGVzIGFyZSBkZXNpZ25lZCB0byBiZSBzZXQgYnkgdGhlIHN5 c3RlbQ0KLQkgICAgYWRtaW5pc3RyYXRvci4gIFRoZXJlIGFyZSBtYW55IHRo YXQgYXJlIHN0YW5kYXJkaXplZCBpbg0KKwkgICAgYWRtaW5pc3RyYXRvci4g IFRoZXJlIGFyZSBtYW55IHRoYXQgYXJlIHN0YW5kYXJkaXplZCBpbiB0aGUN CiAJICAgIDx1bGluaw0KIAkgICAgICB1cmw9Imh0dHA6Ly93d3cuZnJlZWJz ZC5vcmcvY2dpL2N2c3dlYi5jZ2kvcG9ydHMvS05PQlM/cmV2PUhFQUQmYW1w O2NvbnRlbnQtdHlwZT10ZXh0L3gtY3Zzd2ViLW1hcmt1cCI+PGZpbGVuYW1l PnBvcnRzL0tOT0JTPC9maWxlbmFtZT48L3VsaW5rPg0KIAkgICAgZmlsZS48 L3BhcmE+DQpAQCAtNDEzMSw3ICs0MTI5LDcgQEANCiAJICA8bm90ZT4NCiAJ ICAgIDxwYXJhPlVubGVzcyBvdGhlcndpc2Ugc3BlY2lmaWVkLCB0aGVzZSB2 YXJpYWJsZXMgYXJlIG9ubHkNCiAJICAgICAgdGVzdGVkIGZvciBiZWluZyBz ZXQgb3Igbm90IHNldCwgcmF0aGVyIHRoYW4gYmVpbmcgc2V0DQotCSAgICAg IHRvIHNvbWUga2luZCBvZiB2YXJpYWJsZSBzdWNoIGFzIDxsaXRlcmFsPllF UzwvbGl0ZXJhbD4NCisJICAgICAgdG8gYSBzcGVjaWZpYyB2YWx1ZSBzdWNo IGFzIDxsaXRlcmFsPllFUzwvbGl0ZXJhbD4NCiAJICAgICAgb3IgPGxpdGVy YWw+Tk88L2xpdGVyYWw+LjwvcGFyYT4NCiAJICA8L25vdGU+DQogDQpAQCAt NDE3MywxMSArNDE3MSwxMSBAQA0KIA0KIAkJPHJvdz4NCiAJCSAgPGVudHJ5 PjxtYWtldmFyPldJVEhPVVRfWDExPC9tYWtldmFyPjwvZW50cnk+DQotCQkg IDxlbnRyeT5JZiB0aGUgcG9ydCBjYW4gYmUgYnVpbHQgYm90aCB3aXRoIGFu ZA0KLQkJICAgIHdpdGhvdXQgWCBzdXBwb3J0LCB0aGVuIGl0IHNob3VsZCBu b3JtYWxseSBiZQ0KKwkJICA8ZW50cnk+UG9ydHMgdGhhdCBjYW4gYmUgYnVp bHQgYm90aCB3aXRoIGFuZA0KKwkJICAgIHdpdGhvdXQgWCBzdXBwb3J0IGFy ZSBub3JtYWxseQ0KIAkJICAgIGJ1aWx0IHdpdGggWCBzdXBwb3J0LiAgSWYg dGhpcyB2YXJpYWJsZSBpcw0KIAkJICAgIGRlZmluZWQsIHRoZW4gdGhlIHZl cnNpb24gdGhhdCBkb2VzIG5vdCBoYXZlIFgNCi0JCSAgICBzdXBwb3J0IHNo b3VsZCBiZSBidWlsdCBpbnN0ZWFkLjwvZW50cnk+DQorCQkgICAgc3VwcG9y dCB3aWxsIGJlIGJ1aWx0IGluc3RlYWQuPC9lbnRyeT4NCiAJCTwvcm93Pg0K IAkgICAgICA8L3Rib2R5Pg0KIAkgICAgPC90Z3JvdXA+DQpAQCAtNDE4Nyw3 ICs0MTg1LDcgQEANCiAJPHNlY3QzPg0KIAkgIDx0aXRsZT5Lbm9iIE5hbWlu ZzwvdGl0bGU+DQogDQotCSAgPHBhcmE+SXQgaXMgcmVjb21tZW5kZWQgdGhh dCBwb3J0ZXJzIHVzZSBsaWtlLW5hbWVkIGtub2JzLA0KKwkgIDxwYXJhPlBv cnRlcnMgc2hvdWxkIHVzZSBsaWtlLW5hbWVkIGtub2JzLCBib3RoDQogCSAg ICBmb3IgdGhlIGJlbmVmaXQgb2YgZW5kLXVzZXJzIGFuZCB0byBoZWxwIGtl ZXAgdGhlIG51bWJlcg0KIAkgICAgb2Yga25vYiBuYW1lcyBkb3duLiAgQSBs aXN0IG9mIHBvcHVsYXIga25vYiBuYW1lcyBjYW4gYmUNCiAJICAgIGZvdW5k IGluIHRoZSA8dWxpbmsNCkBAIC00MjA3LDM0ICs0MjA1LDMwIEBADQogCTxz ZWN0Mz4NCiAJICA8dGl0bGU+QmFja2dyb3VuZDwvdGl0bGU+DQogDQotCSAg PHBhcmE+VGhlIDxtYWtldmFyPk9QVElPTlM8L21ha2V2YXI+IHZhcmlhYmxl IGdpdmVzIHRoZSB1c2VyDQotCSAgICB3aG8gaW5zdGFsbHMgdGhlIHBvcnQg YSBkaWFsb2cgd2l0aCB0aGUgYXZhaWxhYmxlIG9wdGlvbnMNCi0JICAgIGFu ZCBzYXZlcyB0aGVtIHRvDQotCSAgICA8ZmlsZW5hbWU+L3Zhci9kYi9wb3J0 cy88cmVwbGFjZWFibGU+cG9ydG5hbWU8L3JlcGxhY2VhYmxlPi9vcHRpb25z PC9maWxlbmFtZT4uDQotCSAgICBOZXh0IHRpbWUgd2hlbiB0aGUgcG9ydCBo YXMgdG8gYmUgcmVidWlsZCwgdGhlIG9wdGlvbnMgYXJlDQotCSAgICByZXVz ZWQuICBOZXZlciBhZ2FpbiB5b3Ugd2lsbCBoYXZlIHRvIHJlbWVtYmVyIGFs bCB0aGUNCi0JICAgIHR3ZW50eQ0KLQkgICAgPG1ha2V2YXI+V0lUSF88cmVw bGFjZWFibGU+KjwvcmVwbGFjZWFibGU+PC9tYWtldmFyPiBhbmQNCi0JICAg IDxtYWtldmFyPldJVEhPVVRfPHJlcGxhY2VhYmxlPio8L3JlcGxhY2VhYmxl PjwvbWFrZXZhcj4NCi0JICAgIG9wdGlvbnMgeW91IHVzZWQgdG8gYnVpbGQg dGhpcyBwb3J0ITwvcGFyYT4NCisJICA8cGFyYT5UaGUgPG1ha2V2YXI+T1BU SU9OU18qPC9tYWtldmFyPiB2YXJpYWJsZXMgZ2l2ZSB0aGUgdXNlcg0KKwkg ICAgaW5zdGFsbGluZyB0aGUgcG9ydCBhIGRpYWxvZyBzaG93aW5nIHRoZSBh dmFpbGFibGUgb3B0aW9ucywNCisJICAgIGFuZCB0aGVuIHNhdmVzIHRob3Nl IG9wdGlvbnMgdG8NCisJICAgIDxmaWxlbmFtZT4vdmFyL2RiL3BvcnRzLzxt YWtldmFyPiR7VU5JUVVFTkFNRX08L21ha2V2YXI+L29wdGlvbnM8L2ZpbGVu YW1lPi4NCisJICAgIFRoZSBuZXh0IHRpbWUgdGhlIHBvcnQgaXMgYnVpbHQs IHRoZSBvcHRpb25zIGFyZQ0KKwkgICAgcmV1c2VkLjwvcGFyYT4NCiANCiAJ ICA8cGFyYT5XaGVuIHRoZSB1c2VyIHJ1bnMgPGNvbW1hbmQ+bWFrZSBjb25m aWc8L2NvbW1hbmQ+IChvcg0KIAkgICAgcnVucyA8Y29tbWFuZD5tYWtlIGJ1 aWxkPC9jb21tYW5kPiBmb3IgdGhlIGZpcnN0IHRpbWUpLA0KLQkgICAgdGhl IGZyYW1ld29yayB3aWxsIGNoZWNrIGZvcg0KLQkgICAgPGZpbGVuYW1lPi92 YXIvZGIvcG9ydHMvPHJlcGxhY2VhYmxlPnBvcnRuYW1lPC9yZXBsYWNlYWJs ZT4vb3B0aW9uczwvZmlsZW5hbWU+Lg0KLQkgICAgSWYgdGhhdCBmaWxlIGRv ZXMgbm90IGV4aXN0LCBpdCB3aWxsIHVzZSB0aGUgdmFsdWVzIG9mDQotCSAg ICA8bWFrZXZhcj5PUFRJT05TPC9tYWtldmFyPiB0byBjcmVhdGUgYSBkaWFs b2cgYm94IHdoZXJlDQorCSAgICB0aGUgZnJhbWV3b3JrIGNoZWNrcyBmb3IN CisJICAgIDxmaWxlbmFtZT4vdmFyL2RiL3BvcnRzLzxtYWtldmFyPiR7VU5J UVVFTkFNRX08L21ha2V2YXI+L29wdGlvbnM8L2ZpbGVuYW1lPi4NCisJICAg IElmIHRoYXQgZmlsZSBkb2VzIG5vdCBleGlzdCwgdGhlIHZhbHVlcyBvZg0K KwkgICAgPG1ha2V2YXI+T1BUSU9OU18qPC9tYWtldmFyPiBhcmUgdXNlZCwg YW5kIGEgZGlhbG9nIGJveCBpcyBkaXNwbGF5ZWQgd2hlcmUNCiAJICAgIHRo ZSBvcHRpb25zIGNhbiBiZSBlbmFibGVkIG9yIGRpc2FibGVkLiAgVGhlbiB0 aGUNCiAJICAgIDxmaWxlbmFtZT5vcHRpb25zPC9maWxlbmFtZT4gZmlsZSBp cyBzYXZlZCBhbmQgdGhlDQotCSAgICBzZWxlY3RlZCB2YXJpYWJsZXMgd2ls bCBiZSB1c2VkIHdoZW4gYnVpbGRpbmcgdGhlDQorCSAgICBjb25maWd1cmVk IHZhcmlhYmxlcyBhcmUgdXNlZCB3aGVuIGJ1aWxkaW5nIHRoZQ0KIAkgICAg cG9ydC48L3BhcmE+DQogDQogCSAgPHBhcmE+SWYgYSBuZXcgdmVyc2lvbiBv ZiB0aGUgcG9ydCBhZGRzIG5ldw0KIAkgICAgPG1ha2V2YXI+T1BUSU9OUzwv bWFrZXZhcj4sIHRoZSBkaWFsb2cgd2lsbCBiZSBwcmVzZW50ZWQNCi0JICAg IHRvIHRoZSB1c2VyLCB3aXRoIHRoZSBzYXZlZCB2YWx1ZXMgb2Ygb2xkDQor CSAgICB0byB0aGUgdXNlciB3aXRoIHRoZSBzYXZlZCB2YWx1ZXMgb2Ygb2xk DQogCSAgICA8bWFrZXZhcj5PUFRJT05TPC9tYWtldmFyPiBwcmVmaWxsZWQu PC9wYXJhPg0KIA0KLQkgIDxwYXJhPlVzZSA8Y29tbWFuZD5tYWtlIHNob3dj b25maWc8L2NvbW1hbmQ+IHRvIHNlZSB0aGUNCisJICA8cGFyYT48Y29tbWFu ZD5tYWtlIHNob3djb25maWc8L2NvbW1hbmQ+IHNob3dzIHRoZQ0KIAkgICAg c2F2ZWQgY29uZmlndXJhdGlvbi4gIFVzZSA8Y29tbWFuZD5tYWtlIHJtY29u ZmlnPC9jb21tYW5kPg0KIAkgICAgdG8gcmVtb3ZlIHRoZSBzYXZlZCBjb25m aWd1cmF0aW9uLjwvcGFyYT4NCiAJPC9zZWN0Mz4NCkBAIC00MjQyLDUwICs0 MjM2LDE0MSBAQA0KIAk8c2VjdDM+DQogCSAgPHRpdGxlPlN5bnRheDwvdGl0 bGU+DQogDQotCSAgPHBhcmE+VGhlIHN5bnRheCBmb3IgdGhlIDxtYWtldmFy Pk9QVElPTlM8L21ha2V2YXI+IHZhcmlhYmxlDQotCSAgICBpczo8L3BhcmE+ DQorCSAgPHBhcmE+PG1ha2V2YXI+T1BUSU9OU19ERUZJTkU8L21ha2V2YXI+ IGNvbnRhaW5zIGEgbGlzdCBvZg0KKwkgICAgPG1ha2V2YXI+T1BUSU9OUzwv bWFrZXZhcj4gdG8gYmUgdXNlZC4gIFRoZXNlIGFyZSBpbmRlcGVuZGVudA0K KwkgICAgb2YgZWFjaCBvdGhlciBhbmQgYXJlIG5vdCBncm91cGVkOjwvcGFy YT4NCiANCi0JICA8cHJvZ3JhbWxpc3Rpbmc+T1BUSU9OUz0JT1BUSU9OCSJk ZXNjcmlwdGl2ZSB0ZXh0IiBkZWZhdWx0IC4uLjwvcHJvZ3JhbWxpc3Rpbmc+ DQorCSAgPHByb2dyYW1saXN0aW5nPk9QVElPTlNfREVGSU5FPQlPUFQxIE9Q VDI8L3Byb2dyYW1saXN0aW5nPg0KIA0KLQkgIDxwYXJhPlRoZSB2YWx1ZSBm b3IgZGVmYXVsdCBpcyBlaXRoZXIgPGxpdGVyYWw+T048L2xpdGVyYWw+DQot CSAgICBvciA8bGl0ZXJhbD5PRkY8L2xpdGVyYWw+LiAgTXVsdGlwbGUgcmVw ZXRpdGlvbnMgb2YgdGhlc2UNCi0JICAgIHRocmVlIGZpZWxkcyBhcmUgYWxs b3dlZC48L3BhcmE+DQorCSAgPHBhcmE+T25jZSBkZWZpbmVkLCA8bWFrZXZh cj5PUFRJT05TPC9tYWtldmFyPiBhcmUNCisJICAgIGRlc2NyaWJlZCAob3B0 aW9uYWwsIGJ1dCBzdHJvbmdseSByZWNvbW1lbmRlZCk6PC9wYXJhPg0KIA0K LQkgIDxwYXJhPjxtYWtldmFyPk9QVElPTlM8L21ha2V2YXI+IGRlZmluaXRp b24gbXVzdCBhcHBlYXINCisJICA8cHJvZ3JhbWxpc3Rpbmc+T1BUMV9ERVND PQlEZXNjcmliZSBPUFQxDQorT1BUMl9ERVNDPQlEZXNjcmliZSBPUFQyDQor T1BUM19ERVNDPQlEZXNjcmliZSBPUFQzDQorT1BUNF9ERVNDPQlEZXNjcmli ZSBPUFQ0DQorT1BUNV9ERVNDPQlEZXNjcmliZSBPUFQ1DQorT1BUNl9ERVND PQlEZXNjcmliZSBPUFQ2PC9wcm9ncmFtbGlzdGluZz4NCisNCisJICA8dGlw Pg0KKwkgICAgPHBhcmE+PGZpbGVuYW1lPnBvcnRzL01rL2JzZC5vcHRpb25z LmRlc2MubWs8L2ZpbGVuYW1lPg0KKwkgICAgICBoYXMgZGVzY3JpcHRpb25z IGZvciBtYW55IGNvbW1vbg0KKwkgICAgICA8bWFrZXZhcj5PUFRJT05TPC9t YWtldmFyPjsgdGhlcmUgaXMgdXN1YWxseSBubyBuZWVkDQorCSAgICAgIHRv IG92ZXJyaWRlIHRoZXNlLjwvcGFyYT4NCisJICA8L3RpcD4NCisNCisJICA8 dGlwPg0KKwkgICAgPHBhcmE+V2hlbiBkZXNjcmliaW5nIG9wdGlvbnMsIHZp ZXcgaXQgZnJvbSB0aGUNCisJICAgICAgcGVyc3BlY3RpdmUgb2YgdGhlIHVz ZXI6IDxxdW90ZT5XaGF0IGRvZXMgaXQgZG8/PC9xdW90ZT4NCisJICAgICAg YW5kIDxxdW90ZT5XaHkgd291bGQgSSB3YW50IHRvIGVuYWJsZSB0aGlzPzwv cXVvdGU+IERvDQorCSAgICAgIG5vdCBqdXN0IHJlcGVhdCB0aGUgbmFtZS4g IEZvciBleGFtcGxlLCBkZXNjcmliaW5nIHRoZQ0KKwkgICAgICA8bGl0ZXJh bD5OTFM8L2xpdGVyYWw+IG9wdGlvbiBhcw0KKwkgICAgICA8cXVvdGU+aW5j bHVkZSBOTFMgc3VwcG9ydDwvcXVvdGU+IGRvZXMgbm90IGhlbHAgdGhlDQor CSAgICAgIHVzZXIgd2hvIGNhbiBhbHJlYWR5IHNlZSB0aGUgb3B0aW9uIG5h bWUgYnV0IG1heSBub3QNCisNCisJICAgICAga25vdyB3aGF0IGl0IG1lYW5z LiAgRGVzY3JpYmluZyBpdCBhcyA8cXVvdGU+TmF0aXZlDQorCQlMYW5ndWFn ZSBTdXBwb3J0IHZpYSBnZXR0ZXh0IHV0aWxpdGllczwvcXVvdGU+IGlzDQor CSAgICAgIG11Y2ggbW9yZSBoZWxwZnVsLjwvcGFyYT4NCisJICA8L3RpcD4N CisNCisJICA8cGFyYT48bWFrZXZhcj5PUFRJT05TPC9tYWtldmFyPiBjYW4g YmUgZ3JvdXBlZCBhcyByYWRpbw0KKwkgICAgY2hvaWNlcywgd2hlcmUgb25s eSBvbmUgY2hvaWNlIGZyb20gZWFjaCBncm91cCBpcw0KKwkgICAgYWxsb3dl ZDo8L3BhcmE+DQorDQorCSAgPHByb2dyYW1saXN0aW5nPk9QVElPTlNfU0lO R0xFPQkJU0cxDQorT1BUSU9OU19TSU5HTEVfU0cxPQlPUFQzIE9QVDQ8L3By b2dyYW1saXN0aW5nPg0KKw0KKwkgIDxwYXJhPjxtYWtldmFyPk9QVElPTlM8 L21ha2V2YXI+IGNhbiBhbHNvIGJlIGdyb3VwZWQgYXMNCisJICAgIDxxdW90 ZT5tdWx0aXBsZS1jaG9pY2U8L3F1b3RlPiBsaXN0cywgd2hlcmUNCisJICAg IDxlbXBoYXNpcz5hdCBsZWFzdCBvbmU8L2VtcGhhc2lzPiBvcHRpb24gbXVz dCBiZQ0KKwkgICAgZW5hYmxlZDo8L3BhcmE+DQorDQorCSAgPHByb2dyYW1s aXN0aW5nPk9QVElPTlNfTVVMVEk9CQlNRzENCitPUFRJT05TX01VTFRJX01H MT0JT1BUNSBPUFQ2PC9wcm9ncmFtbGlzdGluZz4NCisNCisJICA8cGFyYT48 bWFrZXZhcj5PUFRJT05TPC9tYWtldmFyPiBhcmUgdW5zZXQgYnkgZGVmYXVs dCwNCisJICAgIHVubGVzcyB0aGV5IGFyZSBsaXN0ZWQgaW4NCisJICAgIDxt YWtldmFyPk9QVElPTlNfREVGQVVMVDwvbWFrZXZhcj46PC9wYXJhPg0KKw0K KwkgIDxwcm9ncmFtbGlzdGluZz5PUFRJT05TX0RFRkFVTFQ9CU9QVDEgT1BU MyBPUFQ2PC9wcm9ncmFtbGlzdGluZz4NCisNCisJICA8cGFyYT48bWFrZXZh cj5PUFRJT05TPC9tYWtldmFyPiBkZWZpbml0aW9ucyBtdXN0IGFwcGVhcg0K IAkgICAgYmVmb3JlIHRoZSBpbmNsdXNpb24gb2YNCiAJICAgIDxmaWxlbmFt ZT5ic2QucG9ydC5vcHRpb25zLm1rPC9maWxlbmFtZT4uICBUaGUNCi0JICAg IDxtYWtldmFyPldJVEhfKjwvbWFrZXZhcj4gYW5kIDxtYWtldmFyPldJVEhP VVRfKjwvbWFrZXZhcj4NCi0JICAgIHZhcmlhYmxlcyBjYW4gb25seSBiZSB0 ZXN0ZWQgYWZ0ZXIgdGhlIGluY2x1c2lvbiBvZg0KKwkgICAgPG1ha2V2YXI+ UE9SVF9PUFRJT05TPC9tYWtldmFyPiB2YXJpYWJsZSBjYW4gb25seSBiZQ0K KwkgICAgdGVzdGVkIGFmdGVyIHRoZSBpbmNsdXNpb24gb2YNCiAJICAgIDxm aWxlbmFtZT5ic2QucG9ydC5vcHRpb25zLm1rPC9maWxlbmFtZT4uICBJbmNs dXNpb24gb2YNCiAJICAgIDxmaWxlbmFtZT5ic2QucG9ydC5wcmUubWs8L2Zp bGVuYW1lPiBjYW4gYmUgdXNlZCBpbnN0ZWFkLA0KIAkgICAgdG9vLCBhbmQg aXMgc3RpbGwgd2lkZWx5IHVzZWQgaW4gcG9ydHMgd3JpdHRlbiBiZWZvcmUg dGhlDQogCSAgICBpbnRyb2R1Y3Rpb24gb2YgPGZpbGVuYW1lPmJzZC5wb3J0 Lm9wdGlvbnMubWs8L2ZpbGVuYW1lPi4NCiAJICAgIEJ1dCBiZSBhd2FyZSB0 aGF0IHNvbWUgdmFyaWFibGVzIHdpbGwgbm90IHdvcmsgYXMgZXhwZWN0ZWQN CiAJICAgIGFmdGVyIHRoZSBpbmNsdXNpb24gb2YNCi0JICAgIDxmaWxlbmFt ZT5ic2QucG9ydC5wcmUubWs8L2ZpbGVuYW1lPiwgdHlwaWNhbGx5DQorCSAg ICA8ZmlsZW5hbWU+YnNkLnBvcnQucHJlLm1rPC9maWxlbmFtZT4sIHR5cGlj YWxseSBzb21lDQogCSAgICA8bWFrZXZhcj5VU0VfKjwvbWFrZXZhcj4gZmxh Z3MuPC9wYXJhPg0KIA0KIAkgIDxleGFtcGxlIGlkPSJwb3J0cy1vcHRpb25z LXNpbXBsZS11c2UiPg0KIAkgICAgPHRpdGxlPlNpbXBsZSBVc2Ugb2YgPG1h a2V2YXI+T1BUSU9OUzwvbWFrZXZhcj48L3RpdGxlPg0KIA0KLQkgICAgPHBy b2dyYW1saXN0aW5nPk9QVElPTlM9CUZPTyAiRW5hYmxlIG9wdGlvbiBmb28i IE9uIFwNCi0JCUJBUiAiU3VwcG9ydCBmZWF0dXJlIGJhciIgT2ZmDQorCSAg ICA8cHJvZ3JhbWxpc3Rpbmc+T1BUSU9OU19ERUZJTkU9CUZPTyBCQVINCitG T09fREVTQz0JRW5hYmxlIG9wdGlvbiBmb28NCitCQVJfREVTQz0JU3VwcG9y dCBmZWF0dXJlIGJhcg0KIA0KK09QVElPTlNfREVGQVVMVD1GT08NCisNCiAu aW5jbHVkZSAmbHQ7YnNkLnBvcnQub3B0aW9ucy5tayZndDsNCiANCi0uaWYg ZGVmaW5lZChXSVRIT1VUX0ZPTykNCi1DT05GSUdVUkVfQVJHUys9CS0td2l0 aG91dC1mb28NCisuaWYgJHtQT1JUX09QVElPTlM6TUZPT30NCitDT05GSUdV UkVfQVJHUys9LS13aXRob3V0LWZvbw0KIC5lbHNlDQotQ09ORklHVVJFX0FS R1MrPQktLXdpdGgtZm9vDQorQ09ORklHVVJFX0FSR1MrPS0td2l0aC1mb28N CiAuZW5kaWYNCiANCi0uaWYgZGVmaW5lZChXSVRIX0JBUikNCisuaWYgJHtQ T1JUX09QVElPTlM6TUJBUn0NCiBSVU5fREVQRU5EUys9CWJhcjoke1BPUlRT RElSfS9iYXIvYmFyDQogLmVuZGlmDQogDQogLmluY2x1ZGUgJmx0O2JzZC5w b3J0Lm1rJmd0OzwvcHJvZ3JhbWxpc3Rpbmc+DQogCSAgPC9leGFtcGxlPg0K IA0KKwkgIDxleGFtcGxlIGlkPSJwb3J0cy1vcHRpb25zLXByYWN0aWNhbC11 c2UiPg0KKwkgICAgPHRpdGxlPlByYWN0aWNhbCBVc2Ugb2YgPG1ha2V2YXI+ T1BUSU9OUzwvbWFrZXZhcj48L3RpdGxlPg0KKw0KKwkgICAgPHByb2dyYW1s aXN0aW5nPk9QVElPTlNfREVGSU5FPQkJRVhBTVBMRVMNCisNCitPUFRJT05T X1NJTkdMRT0JCUJBQ0tFTkQNCitPUFRJT05TX1NJTkdMRV9CQUNLRU5EPQlN WVNRTCBQR1NRTCBCREINCisNCitPUFRJT05TX01VTFRJPQkJQVVUSA0KK09Q VElPTlNfTVVMVElfQVVUSD0JTERBUCBQQU0gU1NMDQorDQorRVhBTVBMRVNf REVTQz0JCUluc3RhbGwgZXh0cmEgZXhhbXBsZXMNCitNWVNRTF9ERVNDPQkJ VXNlIE15U1FMIGFzIGJhY2tlbmQNCitQR1NRTF9ERVNDPQkJVXNlIFBvc3Rn cmVTUUwgYXMgYmFja2VuZA0KK0JEQl9ERVNDPQkJVXNlIEJlcmtlbGV5IERC IGFzIGJhY2tlbmQNCitMREFQX0RFU0M9CQlCdWlsZCB3aXRoIExEQVAgYXV0 aGVudGljYXRpb24gc3VwcG9ydA0KK1BBTV9ERVNDPQkJQnVpbGQgd2l0aCBQ QU0gc3VwcG9ydA0KK1NTTF9ERVNDPQkJQnVpbGQgd2l0aCBPcGVuU1NMIHN1 cHBvcnQNCisNCitPUFRJT05TX0RFRkFVTFQ9CVBHU1FMIExEQVAgU1NMDQor DQorLmluY2x1ZGUgJmx0O2JzZC5wb3J0Lm9wdGlvbnMubWsmZ3Q7DQorDQor LmlmICR7UE9SVF9PUFRJT05TOk1QR1NRTH0NCitVU0VfUEdTUUw9CQl5ZXMN CitDT05GSUdVUkVfQVJHUys9CS0td2l0aC1wb3N0Z3Jlcw0KKy5lbHNlDQor Q09ORklHVVJFX0FSR1MrPQktLXdpdGhvdXQtcG9zdGdyZXMNCisuZW5kaWYN CisNCisuaWYgJHtQT1JUX09QVElPTlM6TUlDVX0NCitMSUJfREVQRU5EUys9 CWljdXVjOiR7UE9SVFNESVJ9L2RldmVsL2ljdQ0KKy5lbmRpZg0KKw0KKyMg Q2hlY2sgb3RoZXIgT1BUSU9OUw0KKw0KKy5pbmNsdWRlICZsdDtic2QucG9y dC5tayZndDs8L3Byb2dyYW1saXN0aW5nPg0KKwkgIDwvZXhhbXBsZT4NCisN CiAJICA8ZXhhbXBsZSBpZD0icG9ydHMtb3B0aW9ucy1vbGQtc3R5bGUtdXNl Ij4NCiAJICAgIDx0aXRsZT5PbGQtU3R5bGUgVXNlIG9mIDxtYWtldmFyPk9Q VElPTlM8L21ha2V2YXI+PC90aXRsZT4NCiANCkBAIC00MzAxLDYgKzQzODYs MTIgQEANCiANCiAuaW5jbHVkZSAmbHQ7YnNkLnBvcnQucG9zdC5tayZndDs8 L3Byb2dyYW1saXN0aW5nPg0KIAkgIDwvZXhhbXBsZT4NCisNCisJICA8aW1w b3J0YW50Pg0KKwkgICAgPHBhcmE+VGhpcyBtZXRob2Qgb2YgdXNpbmcgPG1h a2V2YXI+T1BUSU9OUzwvbWFrZXZhcj4NCisJICAgICAgaXMgZGVwcmVjYXRl ZCwgYW5kIHdpbGwgYmUgcmVtb3ZlZCBhdCBzb21lIHBvaW50Lg0KKwkgICAg ICBEbyBub3QgdXNlIHRoaXMgbWV0aG9kIGZvciBuZXcgcG9ydHMuPC9wYXJh Pg0KKwkgIDwvaW1wb3J0YW50Pg0KIAk8L3NlY3QzPg0KICAgICAgIDwvc2Vj dDI+DQogDQpAQCAtNDMxNyw3ICs0NDA4LDcgQEANCiAJPGV4YW1wbGU+DQog CSAgPHRpdGxlPldyb25nIEhhbmRsaW5nIG9mIGFuIE9wdGlvbjwvdGl0bGU+ DQogDQotCSAgPHByb2dyYW1saXN0aW5nPi5pZiBkZWZpbmVkKFdJVEhfRk9P KQ0KKwkgIDxwcm9ncmFtbGlzdGluZz4uaWYgJHtQT1JUX09QVElPTlM6TUZP T30NCiBMSUJfREVQRU5EUys9CQlmb28uMDoke1BPUlRTRElSfS9kZXZlbC9m b28NCiBDT05GSUdVUkVfQVJHUys9CS0tZW5hYmxlLWZvbw0KIC5lbmRpZjwv cHJvZ3JhbWxpc3Rpbmc+DQpAQCAtNDMzNiw3ICs0NDI3LDcgQEANCiAJPGV4 YW1wbGU+DQogCSAgPHRpdGxlPkNvcnJlY3QgSGFuZGxpbmcgb2YgYW4gT3B0 aW9uPC90aXRsZT4NCiANCi0JICA8cHJvZ3JhbWxpc3Rpbmc+LmlmIGRlZmlu ZWQoV0lUSF9GT08pDQorCSAgPHByb2dyYW1saXN0aW5nPi5pZiAke1BPUlRf T1BUSU9OUzpNRk9PfQ0KIExJQl9ERVBFTkRTKz0JCWZvby4wOiR7UE9SVFNE SVJ9L2RldmVsL2Zvbw0KIENPTkZJR1VSRV9BUkdTKz0JLS1lbmFibGUtZm9v DQogLmVsc2UNCkBAIC03OTg3LDcgKzgwNzgsNyBAQA0KIA0KIC5pbmNsdWRl ICZsdDtic2QucG9ydC5wcmUubWsmZ3Q7DQogDQotLmlmIGRlZmluZWQoV0lU SF9XWCkgfHwgJHtIQVZFX1dYOk13eC0yLjR9ICE9ICIiDQorLmlmIGRlZmlu ZWQoV0lUSF9XWCkgfHwgIWVtcHR5KFBPUlRfT1BUSU9OUzpNV1gpIHx8ICFl bXB0eShIQVZFX1dYOk13eC0yLjQpDQogVVNFX1dYPQkJCTIuNA0KIENPTkZJ R1VSRV9BUkdTKz0JLS1lbmFibGUtd3gNCiAuZW5kaWY8L3Byb2dyYW1saXN0 aW5nPg0KQEAgLTgwMDQsNyArODA5NSw3IEBADQogDQogLmluY2x1ZGUgJmx0 O2JzZC5wb3J0LnByZS5tayZndDsNCiANCi0uaWYgZGVmaW5lZChXSVRIX1dY UFlUSE9OKSB8fCAke0hBVkVfV1g6TXB5dGhvbn0gIT0gIiINCisuaWYgZGVm aW5lZChXSVRIX1dYUFlUSE9OKSB8fCAhZW1wdHkoUE9SVF9PUFRJT05TOk1X WFBZVEhPTikgfHwgIWVtcHR5KEhBVkVfV1g6TXB5dGhvbikNCiBXWF9DT01Q Uys9CQlweXRob24NCiBDT05GSUdVUkVfQVJHUys9CS0tZW5hYmxlLXd4cHl0 aG9uDQogLmVuZGlmPC9wcm9ncmFtbGlzdGluZz4NCkBAIC04NDk1LDcgKzg1 ODYsNyBAQA0KIA0KIC5pbmNsdWRlICZsdDtic2QucG9ydC5wcmUubWsmZ3Q7 DQogDQotLmlmIGRlZmluZWQoV0lUSF9MVUE1KSB8fCAke0hBVkVfTFVBOk1s dWEtNS5bMDFdfSAhPSAiIg0KKy5pZiBkZWZpbmVkKFdJVEhfTFVBNSkgfHwg IWVtcHR5KFBPUlRfT1BUSU9OUzpNTFVBNSkgfHwgIWVtcHR5KEhBVkVfTFVB Ok1sdWEtNS5bMDFdKQ0KIFVTRV9MVUE9CQk1LjAtNS4xDQogQ09ORklHVVJF X0FSR1MrPQktLWVuYWJsZS1sdWE1DQogLmVuZGlmPC9wcm9ncmFtbGlzdGlu Zz4NCkBAIC04NTEyLDcgKzg2MDMsNyBAQA0KIA0KIC5pbmNsdWRlICZsdDti c2QucG9ydC5wcmUubWsmZ3Q7DQogDQotLmlmIGRlZmluZWQoV0lUSF9UT0xV QSkgfHwgJHtIQVZFX0xVQTpNdG9sdWF9ICE9ICIiDQorLmlmIGRlZmluZWQo V0lUSF9UT0xVQSkgfHwgIWVtcHR5KFBPUlRfT1BUSU9OUzpNVE9MVUEpIHx8 ICFlbXB0eShIQVZFX0xVQTpNdG9sdWEpDQogTFVBX0NPTVBTKz0JCXRvbHVh DQogQ09ORklHVVJFX0FSR1MrPQktLWVuYWJsZS10b2x1YQ0KIC5lbmRpZjwv cHJvZ3JhbWxpc3Rpbmc+DQo= ---902635197-1144049882-1338134521=:48564--