From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received-SPF: Permerror (SPF Permanent Error: More than 10 MX records returned) identity=mailfrom; client-ip=192.55.52.115; helo=mga14.intel.com; envelope-from=liming.gao@intel.com; receiver=edk2-devel@lists.01.org Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ml01.01.org (Postfix) with ESMTPS id 92DCA21A1099A for ; Tue, 12 Dec 2017 06:57:02 -0800 (PST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga002.jf.intel.com ([10.7.209.21]) by fmsmga103.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 12 Dec 2017 07:01:40 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.45,395,1508828400"; d="scan'208";a="17606117" Received: from fmsmsx104.amr.corp.intel.com ([10.18.124.202]) by orsmga002.jf.intel.com with ESMTP; 12 Dec 2017 07:01:39 -0800 Received: from fmsmsx156.amr.corp.intel.com (10.18.116.74) by fmsmsx104.amr.corp.intel.com (10.18.124.202) with Microsoft SMTP Server (TLS) id 14.3.319.2; Tue, 12 Dec 2017 07:01:37 -0800 Received: from shsmsx101.ccr.corp.intel.com (10.239.4.153) by fmsmsx156.amr.corp.intel.com (10.18.116.74) with Microsoft SMTP Server (TLS) id 14.3.319.2; Tue, 12 Dec 2017 07:01:37 -0800 Received: from shsmsx104.ccr.corp.intel.com ([169.254.5.152]) by SHSMSX101.ccr.corp.intel.com ([169.254.1.159]) with mapi id 14.03.0319.002; Tue, 12 Dec 2017 23:01:36 +0800 From: "Gao, Liming" To: Laszlo Ersek , Zenith432 , "edk2-devel@lists.01.org" CC: "Kinney, Michael D" Thread-Topic: [edk2] [PATCH] MdePkg: correct and clarify documentation of VA_LIST in Base.h Thread-Index: AQHTczNvzkudtXTBkUypRDdPIabImKM+/lYAgADPXbA= Date: Tue, 12 Dec 2017 15:01:35 +0000 Message-ID: <4A89E2EF3DFEDB4C8BFDE51014F606A14E191187@SHSMSX104.ccr.corp.intel.com> References: <1667068483.2112668.1512898346914.ref@mail.yahoo.com> <1667068483.2112668.1512898346914@mail.yahoo.com> <90e6e057-3fa3-eed9-46a2-44bb8a78e652@users.sourceforge.net> <147f3c39-cfc4-a0ad-44c8-a58487624c7f@redhat.com> In-Reply-To: <147f3c39-cfc4-a0ad-44c8-a58487624c7f@redhat.com> Accept-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-version: 11.0.0.116 dlp-reaction: no-action x-originating-ip: [10.239.127.40] MIME-Version: 1.0 Subject: Re: [PATCH] MdePkg: correct and clarify documentation of VA_LIST in Base.h X-BeenThere: edk2-devel@lists.01.org X-Mailman-Version: 2.1.22 Precedence: list List-Id: EDK II Development List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 12 Dec 2017 14:57:02 -0000 Content-Language: en-US Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 TGFzemxvOg0KICBUaGFua3MhDQoNClJldmlld2VkLWJ5OiBMaW1pbmcgR2FvIDxsaW1pbmcuZ2Fv QGludGVsLmNvbT4NCg0KPiAtLS0tLU9yaWdpbmFsIE1lc3NhZ2UtLS0tLQ0KPiBGcm9tOiBlZGsy LWRldmVsIFttYWlsdG86ZWRrMi1kZXZlbC1ib3VuY2VzQGxpc3RzLjAxLm9yZ10gT24gQmVoYWxm IE9mIExhc3psbyBFcnNlaw0KPiBTZW50OiBUdWVzZGF5LCBEZWNlbWJlciAxMiwgMjAxNyA2OjM5 IFBNDQo+IFRvOiBaZW5pdGg0MzIgPHplbml0aDQzMkB1c2Vycy5zb3VyY2Vmb3JnZS5uZXQ+OyBl ZGsyLWRldmVsQGxpc3RzLjAxLm9yZw0KPiBDYzogS2lubmV5LCBNaWNoYWVsIEQgPG1pY2hhZWwu ZC5raW5uZXlAaW50ZWwuY29tPjsgR2FvLCBMaW1pbmcgPGxpbWluZy5nYW9AaW50ZWwuY29tPg0K PiBTdWJqZWN0OiBSZTogW2VkazJdIFtQQVRDSF0gTWRlUGtnOiBjb3JyZWN0IGFuZCBjbGFyaWZ5 IGRvY3VtZW50YXRpb24gb2YgVkFfTElTVCBpbiBCYXNlLmgNCj4gDQo+IE9uIDEyLzEyLzE3IDEx OjI0LCBaZW5pdGg0MzIgd3JvdGU6DQo+ID4gQmVsb3cgaXMgYW4gYW1lbmRlZCBwYXRjaC4NCj4g Pg0KPiA+IEkgY2hhbmdlZCB0aGUgd29yZGluZyBpbiB0aGUgbm90ZXMgYSBsaXR0bGUgdG8gZXhj bHVkZSBhIG5vbi12YXJpYWRpYw0KPiA+IGZ1bmN0aW9uIHVzaW5nIFZBX1NUQVJULCBhbmQgdG8g cmVtaW5kIHRoYXQgVkFfQ09QWSBzaG91bGQgYWxzbyBiZQ0KPiA+IHBhaXJlZCB3aXRoIFZBX0VO RC4NCj4gPg0KPiA+IEFsc28sIGlmIEdDQyBnZXRzIGl0cyBWQV9DT1BZIHJlcGFpcmVkLCBkb2N1 bWVudGF0aW9uIG1heSBjaGFuZ2UgdG8NCj4gPiBhbGxvdyB0byB1c2luZyBWQV9DT1BZDQo+ID4g aW5zaWRlIG5vbi1FRklBUEkgYXMgd2VsbC4NCj4gPiAtLS0NCj4gPg0KPiA+IFRoaXMgaXMgdG8g cmVzb2x2ZSBidWcgNDU3Lg0KPiA+IGh0dHBzOi8vYnVnemlsbGEudGlhbm9jb3JlLm9yZy9zaG93 X2J1Zy5jZ2k/aWQ9NDU3DQo+ID4NCj4gPiBDb250cmlidXRlZC11bmRlcjogVGlhbm9Db3JlIENv bnRyaWJ1dGlvbiBBZ3JlZW1lbnQgMS4xDQo+ID4gU2lnbmVkLW9mZi1ieTogWmVuaXRoNDMyIDx6 ZW5pdGg0MzIgYXQgdXNlcnMuc291cmNlZm9yZ2UubmV0Pg0KPiA+IC0tLQ0KPiA+IMKgTWRlUGtn L0luY2x1ZGUvQmFzZS5oIHwgMjUgKysrKysrKysrKysrKysrKystLS0tLS0tLQ0KPiA+IMKgMSBm aWxlIGNoYW5nZWQsIDE3IGluc2VydGlvbnMoKyksIDggZGVsZXRpb25zKC0pDQo+ID4NCj4gPiBk aWZmIC0tZ2l0IGEvTWRlUGtnL0luY2x1ZGUvQmFzZS5oIGIvTWRlUGtnL0luY2x1ZGUvQmFzZS5o DQo+ID4gaW5kZXggMDIxNDBhNWEuLjRmZDUxNjFmIDEwMDY0NA0KPiA+IC0tLSBhL01kZVBrZy9J bmNsdWRlL0Jhc2UuaA0KPiA+ICsrKyBiL01kZVBrZy9JbmNsdWRlL0Jhc2UuaA0KPiA+IEBAIC01 NTIsMjEgKzU1MiwyNCBAQCBzdHJ1Y3QgX0xJU1RfRU5UUlkgew0KPiA+IMKgI2RlZmluZcKgIEJB U0VfOEVCwqDCoMKgIDB4ODAwMDAwMDAwMDAwMDAwMFVMTA0KPiA+DQo+ID4gwqAvLw0KPiA+IC0v L8KgIFN1cHBvcnQgZm9yIHZhcmlhYmxlIGxlbmd0aCBhcmd1bWVudCBsaXN0cyB1c2luZyB0aGUg QU5TSSBzdGFuZGFyZC4NCj4gPiArLy/CoCBTdXBwb3J0IGZvciB2YXJpYWJsZSBhcmd1bWVudCBs aXN0cyBpbiBmcmVlc3RhbmRpbmcgZWRrMiBtb2R1bGVzLg0KPiA+IMKgLy8NCj4gPiAtLy/CoCBT aW5jZSB3ZSBhcmUgdXNpbmcgdGhlIEFOU0kgc3RhbmRhcmQgd2UgdXNlZCB0aGUgc3RhbmRhcmQg bmFtaW5nIGFuZA0KPiA+IC0vL8KgIGRpZCBub3QgZm9sbG93IHRoZSBjb2RpbmcgY29udmVudGlv bg0KPiA+ICsvL8KgIEZvciBtb2R1bGVzIHRoYXQgdXNlIHRoZSBJU08gQyBsaWJyYXJ5IGludGVy ZmFjZXMgZm9yIHZhcmlhYmxlDQo+ID4gKy8vwqAgYXJndW1lbnQgbGlzdHMsIHJlZmVyIHRvICJT dGRMaWIvSW5jbHVkZS9zdGRhcmcuaCIuDQo+ID4gwqAvLw0KPiA+IMKgLy/CoCBWQV9MSVNUwqAg LSB0eXBlZGVmIGZvciBhcmd1bWVudCBsaXN0Lg0KPiA+IMKgLy/CoCBWQV9TVEFSVCAoVkFfTElT VCBNYXJrZXIsIGFyZ3VtZW50IGJlZm9yZSB0aGUgLi4uKSAtIEluaXQgTWFya2VyDQo+ID4gZm9y IHVzZS4NCj4gPiDCoC8vwqAgVkFfRU5EIChWQV9MSVNUIE1hcmtlcikgLSBDbGVhciBNYXJrZXIN Cj4gPiAtLy/CoCBWQV9BUkcgKFZBX0xJU1QgTWFya2VyLCB2YXIgYXJnIHNpemUpIC0gVXNlIE1h cmtlciB0byBnZXQgYW4NCj4gPiBhcmd1bWVudCBmcm9tDQo+ID4gLS8vwqDCoMKgIHRoZSAuLi4g bGlzdC4gWW91IG11c3Qga25vdyB0aGUgc2l6ZSBhbmQgcGFzcyBpdCBpbiB0aGlzIG1hY3JvLg0K PiA+ICsvL8KgIFZBX0FSRyAoVkFfTElTVCBNYXJrZXIsIHZhciBhcmcgdHlwZSkgLSBVc2UgTWFy a2VyIHRvIGdldCBhbg0KPiA+IGFyZ3VtZW50IGZyb20NCj4gPiArLy/CoMKgwqAgdGhlIC4uLiBs aXN0LiBZb3UgbXVzdCBrbm93IHRoZSB0eXBlIGFuZCBwYXNzIGl0IGluIHRoaXMgbWFjcm8uDQo+ ID4gVHlwZQ0KPiA+ICsvL8KgwqDCoCBtdXN0IGJlIGNvbXBhdGlibGUgd2l0aCB0aGUgdHlwZSBv ZiB0aGUgYWN0dWFsIG5leHQgYXJndW1lbnQgKGFzDQo+ID4gcHJvbW90ZWQNCj4gPiArLy/CoMKg wqAgYWNjb3JkaW5nIHRvIHRoZSBkZWZhdWx0IGFyZ3VtZW50IHByb21vdGlvbnMuKQ0KPiA+IMKg Ly/CoCBWQV9DT1BZIChWQV9MSVNUIERlc3QsIFZBX0xJU1QgU3RhcnQpIC0gSW5pdGlhbGl6ZSBE ZXN0IGFzIGEgY29weQ0KPiA+IG9mIFN0YXJ0Lg0KPiA+IMKgLy8NCj4gPiAtLy/CoCBleGFtcGxl Og0KPiA+ICsvL8KgIEV4YW1wbGU6DQo+ID4gwqAvLw0KPiA+IMKgLy/CoCBVSU5UTg0KPiA+ICsv L8KgIEVGSUFQSQ0KPiA+IMKgLy/CoCBFeGFtcGxlVmFyQXJnICgNCj4gPiDCoC8vwqDCoMKgIElO IFVJTlROwqAgTnVtYmVyT2ZBcmdzLA0KPiA+IMKgLy/CoMKgwqAgLi4uDQo+ID4gQEAgLTU4Miwx NSArNTg1LDIxIEBAIHN0cnVjdCBfTElTVF9FTlRSWSB7DQo+ID4gwqAvL8KgwqDCoCBWQV9TVEFS VCAoTWFya2VyLCBOdW1iZXJPZkFyZ3MpOw0KPiA+IMKgLy/CoMKgwqAgZm9yIChJbmRleCA9IDAs IFJlc3VsdCA9IDA7IEluZGV4IDwgTnVtYmVyT2ZBcmdzOyBJbmRleCsrKSB7DQo+ID4gwqAvL8Kg wqDCoMKgwqAgLy8NCj4gPiAtLy/CoMKgwqDCoMKgIC8vIFRoZSAuLi4gbGlzdCBpcyBhIHNlcmll cyBvZiBVSU5UTiB2YWx1ZXMsIHNvIGF2ZXJhZ2UgdGhlbSB1cC4NCj4gPiArLy/CoMKgwqDCoMKg IC8vIFRoZSAuLi4gbGlzdCBpcyBhIHNlcmllcyBvZiBVSU5UTiB2YWx1ZXMsIHNvIHN1bSB0aGVt IHVwLg0KPiA+IMKgLy/CoMKgwqDCoMKgIC8vDQo+ID4gwqAvL8KgwqDCoMKgwqAgUmVzdWx0ICs9 IFZBX0FSRyAoTWFya2VyLCBVSU5UTik7DQo+ID4gwqAvL8KgwqDCoCB9DQo+ID4gwqAvLw0KPiA+ IMKgLy/CoMKgwqAgVkFfRU5EIChNYXJrZXIpOw0KPiA+IC0vL8KgwqDCoCByZXR1cm4gUmVzdWx0 DQo+ID4gKy8vwqDCoMKgIHJldHVybiBSZXN1bHQ7DQo+ID4gwqAvL8KgIH0NCj4gPiDCoC8vDQo+ ID4gKy8vwqAgTm90ZXM6DQo+ID4gKy8vwqAgLSBGdW5jdGlvbnMgdGhhdCBjYWxsIFZBX1NUQVJU KCkgLyBWQV9FTkQoKSBtdXN0IGhhdmUgYSB2YXJpYWJsZQ0KPiA+ICsvL8KgwqDCoCBhcmd1bWVu dCBsaXN0IGFuZCBtdXN0IGJlIGRlY2xhcmVkIEVGSUFQSS4NCj4gPiArLy/CoCAtIEZ1bmN0aW9u cyB0aGF0IGNhbGwgVkFfQ09QWSgpIC8gVkFfRU5EKCkgbXVzdCBiZSBkZWNsYXJlZCBFRklBUEku DQo+ID4gKy8vwqAgLSBGdW5jdGlvbnMgdGhhdCBvbmx5IHVzZSBWQV9MSVNUIGFuZCBWQV9BUkco KSBuZWVkIG5vdCBiZSBFRklBUEkuDQo+ID4gKy8vDQo+ID4NCj4gPiDCoC8qKg0KPiA+IMKgwqAg UmV0dXJuIHRoZSBzaXplIG9mIGFyZ3VtZW50IHRoYXQgaGFzIGJlZW4gYWxpZ25lZCB0byBzaXpl b2YgKFVJTlROKS4NCj4gDQo+IFJldmlld2VkLWJ5OiBMYXN6bG8gRXJzZWsgPGxlcnNla0ByZWRo YXQuY29tPg0KPiANCj4gKExpbWluZywgSSBjYW4gaGVscCB3aXRoIGFwcGx5aW5nIHRoaXMgcGF0 Y2gsIGlmIHlvdSB3YW50IHRoYXQuKQ0KPiANCj4gVGhhbmtzIQ0KPiBMYXN6bG8NCj4gX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18NCj4gZWRrMi1kZXZlbCBt YWlsaW5nIGxpc3QNCj4gZWRrMi1kZXZlbEBsaXN0cy4wMS5vcmcNCj4gaHR0cHM6Ly9saXN0cy4w MS5vcmcvbWFpbG1hbi9saXN0aW5mby9lZGsyLWRldmVsDQo=