From mboxrd@z Thu Jan  1 00:00:00 1970
From: Jani Nikula <jani.nikula@linux.intel.com>
Subject: Re: [PATCH] drm/i915: Clean up ancient doc comments for
 i915_ioc32.c
Date: Wed, 14 Feb 2018 18:09:16 +0200
Message-ID: <871shnlfir.fsf@intel.com>
References: <20180214152911.9242-1-chris@chris-wilson.co.uk>
 <877erflgr6.fsf@intel.com>
 <151862323792.31524.11951211980011331188@mail.alporthouse.com>
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Return-path: <intel-gfx-bounces@lists.freedesktop.org>
Received: from mga12.intel.com (mga12.intel.com [192.55.52.136])
 by gabe.freedesktop.org (Postfix) with ESMTPS id BE0578993B
 for <intel-gfx@lists.freedesktop.org>; Wed, 14 Feb 2018 16:09:23 +0000 (UTC)
In-Reply-To: <151862323792.31524.11951211980011331188@mail.alporthouse.com>
List-Unsubscribe: <https://lists.freedesktop.org/mailman/options/intel-gfx>,
 <mailto:intel-gfx-request@lists.freedesktop.org?subject=unsubscribe>
List-Archive: <https://lists.freedesktop.org/archives/intel-gfx>
List-Post: <mailto:intel-gfx@lists.freedesktop.org>
List-Help: <mailto:intel-gfx-request@lists.freedesktop.org?subject=help>
List-Subscribe: <https://lists.freedesktop.org/mailman/listinfo/intel-gfx>,
 <mailto:intel-gfx-request@lists.freedesktop.org?subject=subscribe>
Errors-To: intel-gfx-bounces@lists.freedesktop.org
Sender: "Intel-gfx" <intel-gfx-bounces@lists.freedesktop.org>
To: Chris Wilson <chris@chris-wilson.co.uk>, intel-gfx@lists.freedesktop.org
List-Id: intel-gfx@lists.freedesktop.org

T24gV2VkLCAxNCBGZWIgMjAxOCwgQ2hyaXMgV2lsc29uIDxjaHJpc0BjaHJpcy13aWxzb24uY28u
dWs+IHdyb3RlOgo+IFF1b3RpbmcgSmFuaSBOaWt1bGEgKDIwMTgtMDItMTQgMTU6NDI6MzcpCj4+
IE9uIFdlZCwgMTQgRmViIDIwMTgsIENocmlzIFdpbHNvbiA8Y2hyaXNAY2hyaXMtd2lsc29uLmNv
LnVrPiB3cm90ZToKPj4gPiBBcyBiZWZpdHRpbmcgYSBmaWxlIGRlZGljYXRlZCB0byB0aGUgbWlz
dGFrZXMgb2YgdGhlIHBhc3QsCj4+ID4KPj4gPiBkcml2ZXJzL2dwdS9kcm0vaTkxNS9pOTE1X2lv
YzMyLmM6Mjogd2FybmluZzogQ2Fubm90IHVuZGVyc3RhbmQgICogXGZpbGUgaTkxNV9pb2MzMi5j
Cj4+ID4gIG9uIGxpbmUgMiAtIEkgdGhvdWdodCBpdCB3YXMgYSBkb2MgbGluZQo+PiA+IGRyaXZl
cnMvZ3B1L2RybS9pOTE1L2k5MTVfaW9jMzIuYzo4Mjogd2FybmluZzogRnVuY3Rpb24gcGFyYW1l
dGVyIG9yIG1lbWJlciAnZmlscCcgbm90IGRlc2NyaWJlZCBpbiAnaTkxNV9jb21wYXRfaW9jdGwn
Cj4+ID4gZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV9pb2MzMi5jOjgyOiB3YXJuaW5nOiBGdW5j
dGlvbiBwYXJhbWV0ZXIgb3IgbWVtYmVyICdjbWQnIG5vdCBkZXNjcmliZWQgaW4gJ2k5MTVfY29t
cGF0X2lvY3RsJwo+PiA+IGRyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfaW9jMzIuYzo4Mjogd2Fy
bmluZzogRnVuY3Rpb24gcGFyYW1ldGVyIG9yIG1lbWJlciAnYXJnJyBub3QgZGVzY3JpYmVkIGlu
ICdpOTE1X2NvbXBhdF9pb2N0bCcKPj4gPgo+PiA+IFNpZ25lZC1vZmYtYnk6IENocmlzIFdpbHNv
biA8Y2hyaXNAY2hyaXMtd2lsc29uLmNvLnVrPgo+PiA+IC0tLQo+PiA+ICBkcml2ZXJzL2dwdS9k
cm0vaTkxNS9pOTE1X2lvYzMyLmMgfCAzOCArKysrKysrKysrKysrKysrLS0tLS0tLS0tLS0tLS0t
LS0tLS0tLQo+PiA+ICAxIGZpbGUgY2hhbmdlZCwgMTYgaW5zZXJ0aW9ucygrKSwgMjIgZGVsZXRp
b25zKC0pCj4+ID4KPj4gPiBkaWZmIC0tZ2l0IGEvZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV9p
b2MzMi5jIGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV9pb2MzMi5jCj4+ID4gaW5kZXggOTdm
M2E1NjQwMjg5Li43MzU5OWJlNjQxZTcgMTAwNjQ0Cj4+ID4gLS0tIGEvZHJpdmVycy9ncHUvZHJt
L2k5MTUvaTkxNV9pb2MzMi5jCj4+ID4gKysrIGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV9p
b2MzMi5jCj4+ID4gQEAgLTEsMTEgKzEsNiBAQAo+PiA+IC0vKioKPj4gPiAtICogXGZpbGUgaTkx
NV9pb2MzMi5jCj4+ID4gLSAqCj4+ID4gKy8qCj4+ID4gICAqIDMyLWJpdCBpb2N0bCBjb21wYXRp
YmlsaXR5IHJvdXRpbmVzIGZvciB0aGUgaTkxNSBEUk0uCj4+ID4gICAqCj4+ID4gLSAqIFxhdXRo
b3IgQWxhbiBIb3VyaWhhbmUgPGFsYW5oQGZhaXJsaXRlLmRlbW9uLmNvLnVrPgo+PiA+IC0gKgo+
PiA+IC0gKgo+PiA+ICAgKiBDb3B5cmlnaHQgKEMpIFBhdWwgTWFja2VycmFzIDIwMDUKPj4gPiAg
ICogQ29weXJpZ2h0IChDKSBBbGFuIEhvdXJpaGFuZSAyMDA1Cj4+ID4gICAqIEFsbCBSaWdodHMg
UmVzZXJ2ZWQuCj4+ID4gQEAgLTI4LDYgKzIzLDggQEAKPj4gPiAgICogV0hFVEhFUiBJTiBBTiBB
Q1RJT04gT0YgQ09OVFJBQ1QsIFRPUlQgT1IgT1RIRVJXSVNFLCBBUklTSU5HIEZST00sCj4+ID4g
ICAqIE9VVCBPRiBPUiBJTiBDT05ORUNUSU9OIFdJVEggVEhFIFNPRlRXQVJFIE9SIFRIRSBVU0Ug
T1IgT1RIRVIgREVBTElOR1MKPj4gPiAgICogSU4gVEhFIFNPRlRXQVJFLgo+PiA+ICsgKgo+PiA+
ICsgKiBBdXRob3I6IEFsYW4gSG91cmloYW5lIDxhbGFuaEBmYWlybGl0ZS5kZW1vbi5jby51az4K
Pj4gPiAgICovCj4+ID4gICNpbmNsdWRlIDxsaW51eC9jb21wYXQuaD4KPj4gPiAgCj4+ID4gQEAg
LTU1LDkgKzUyLDkgQEAgc3RhdGljIGludCBjb21wYXRfaTkxNV9nZXRwYXJhbShzdHJ1Y3QgZmls
ZSAqZmlsZSwgdW5zaWduZWQgaW50IGNtZCwKPj4gPiAgICAgICAgICAgICAgIHJldHVybiAtRUZB
VUxUOwo+PiA+ICAKPj4gPiAgICAgICByZXF1ZXN0ID0gY29tcGF0X2FsbG9jX3VzZXJfc3BhY2Uo
c2l6ZW9mKCpyZXF1ZXN0KSk7Cj4+ID4gLSAgICAgaWYgKCFhY2Nlc3Nfb2soVkVSSUZZX1dSSVRF
LCByZXF1ZXN0LCBzaXplb2YoKnJlcXVlc3QpKQo+PiA+IC0gICAgICAgICB8fCBfX3B1dF91c2Vy
KHJlcTMyLnBhcmFtLCAmcmVxdWVzdC0+cGFyYW0pCj4+ID4gLSAgICAgICAgIHx8IF9fcHV0X3Vz
ZXIoKHZvaWQgX191c2VyICopKHVuc2lnbmVkIGxvbmcpcmVxMzIudmFsdWUsCj4+ID4gKyAgICAg
aWYgKCFhY2Nlc3Nfb2soVkVSSUZZX1dSSVRFLCByZXF1ZXN0LCBzaXplb2YoKnJlcXVlc3QpKSB8
fAo+PiA+ICsgICAgICAgICBfX3B1dF91c2VyKHJlcTMyLnBhcmFtLCAmcmVxdWVzdC0+cGFyYW0p
IHx8Cj4+ID4gKyAgICAgICAgIF9fcHV0X3VzZXIoKHZvaWQgX191c2VyICopKHVuc2lnbmVkIGxv
bmcpcmVxMzIudmFsdWUsCj4+ID4gICAgICAgICAgICAgICAgICAgICAgICAgJnJlcXVlc3QtPnZh
bHVlKSkKPj4gPiAgICAgICAgICAgICAgIHJldHVybiAtRUZBVUxUOwo+PiA+ICAKPj4gPiBAQCAt
NzAsMzAgKzY3LDI3IEBAIHN0YXRpYyBkcm1faW9jdGxfY29tcGF0X3QgKmk5MTVfY29tcGF0X2lv
Y3Rsc1tdID0gewo+PiA+ICB9Owo+PiA+ICAKPj4gPiAgLyoqCj4+ID4gKyAqIGk5MTVfY29tcGF0
X2lvY3RsIC0gaGFuZGxlIHRoZSBtaXN0YWtlcyBvZiB0aGUgcGFzdAo+PiA+ICsgKiBAZmlscDog
dGhlIGZpbGUgcG9pbnRlcgo+PiA+ICsgKiBAY21kOiB0aGUgaW9jdGwgY29tbWFuZCAoYW5kIGVu
Y29kZWQgZmxhZ3MpCj4+ID4gKyAqIEBhcmc6IHRoZSBpb2N0bCBhcmd1bWVudCAoZnJvbSB1c2Vy
c3BhY2UpCj4+ID4gKyAqCj4+ID4gICAqIENhbGxlZCB3aGVuZXZlciBhIDMyLWJpdCBwcm9jZXNz
IHJ1bm5pbmcgdW5kZXIgYSA2NC1iaXQga2VybmVsCj4+ID4gICAqIHBlcmZvcm1zIGFuIGlvY3Rs
IG9uIC9kZXYvZHJpL2NhcmQ8bj4uCj4+ID4gLSAqCj4+ID4gLSAqIFxwYXJhbSBmaWxwIGZpbGUg
cG9pbnRlci4KPj4gPiAtICogXHBhcmFtIGNtZCBjb21tYW5kLgo+PiA+IC0gKiBccGFyYW0gYXJn
IHVzZXIgYXJndW1lbnQuCj4+ID4gLSAqIFxyZXR1cm4gemVybyBvbiBzdWNjZXNzIG9yIG5lZ2F0
aXZlIG51bWJlciBvbiBmYWlsdXJlLgo+PiA+ICAgKi8KPj4gPiAgbG9uZyBpOTE1X2NvbXBhdF9p
b2N0bChzdHJ1Y3QgZmlsZSAqZmlscCwgdW5zaWduZWQgaW50IGNtZCwgdW5zaWduZWQgbG9uZyBh
cmcpCj4+ID4gIHsKPj4gPiAgICAgICB1bnNpZ25lZCBpbnQgbnIgPSBEUk1fSU9DVExfTlIoY21k
KTsKPj4gPiAtICAgICBkcm1faW9jdGxfY29tcGF0X3QgKmZuID0gTlVMTDsKPj4gPiAtICAgICBp
bnQgcmV0Owo+PiA+ICsgICAgIGRybV9pb2N0bF9jb21wYXRfdCAqZm47Cj4+ID4gIAo+PiA+ICAg
ICAgIGlmIChuciA8IERSTV9DT01NQU5EX0JBU0UgfHwgbnIgPj0gRFJNX0NPTU1BTkRfRU5EKQo+
PiA+ICAgICAgICAgICAgICAgcmV0dXJuIGRybV9jb21wYXRfaW9jdGwoZmlscCwgY21kLCBhcmcp
Owo+PiA+ICAKPj4gPiArICAgICBmbiA9IE5VTEw7Cj4+ID4gICAgICAgaWYgKG5yIDwgRFJNX0NP
TU1BTkRfQkFTRSArIEFSUkFZX1NJWkUoaTkxNV9jb21wYXRfaW9jdGxzKSkKPj4gPiAgICAgICAg
ICAgICAgIGZuID0gaTkxNV9jb21wYXRfaW9jdGxzW25yIC0gRFJNX0NPTU1BTkRfQkFTRV07Cj4+
ID4gKyAgICAgaWYgKGZuKQo+PiA+ICsgICAgICAgICAgICAgcmV0dXJuIGZuKGZpbHAsIGNtZCwg
YXJnKTsKPj4gCj4+IE5vdCByZWFsbHkgZm9uZCBvZiBjb2RlIGp1Z2dsaW5nIGluIGEgcGF0Y2gg
dGhhdCdzIHN1cHBvc2VkIHRvIGJlIGFib3V0Cj4+IGRvYyBjb21tZW50IHVwZGF0ZXMuCj4+IAo+
PiBCdXQgaWYgeW91IGRvIHRoaXMsIHlvdSBtaWdodCBqdXN0IGFzIHdlbGwgbW92ZSB0aGUgaWYg
KGZuKSBjaGVjayB3aXRoaW4KPj4gdGhlIHByZWNlZGluZyBpZiBibG9jaywgYW5kIGdldCByaWQg
b2YgdGhlIGZuID0gTlVMTCBpbml0aWFsaXphdGlvbgo+PiBhbHRvZ2hldGVyLgo+Cj4gSW4gdGhl
IGVuZCBJIHdhbnQgaXQgdG8gYmVjb21lIHNvbWV0aGluZyBsaWtlCgpTbyBob3cgYWJvdXQgbm90
IGp1Z2dsaW5nIGl0IGluIHRoZSBwYXRjaCBhdCBoYW5kLCBhbmQgZG9pbmcgaXQgcHJvcGVybHkK
aW4gYSBzZXBhcmF0ZSBwYXRjaCBpbnN0ZWFkLi4uPyBJIGtpbmQgb2YgZGlzbGlrZSB3aGF0IGRy
aXZlLWJ5IGNsZWFudXBzCmRvIHRvIGdpdCBibGFtZS4KCkJSLApKYW5pLgoKPgo+ICAgICAgICAg
Zm4gPSBOVUxMOwo+ICAgICAgICAgaWYgKG5yIDwgQVJSQVlfU0laRShpOTE1X2NvbXBhdF9pb2N0
bHMpKQo+ICAgICAgICAgICAgICAgICBmbiA9IGk5MTVfY29tcGF0X2lvY3Rsc1tucl07Cj4gICAg
ICAgICBpZiAoIWZuKSB7Cj4gICAgICAgICAgICAgICAgIGNvbnN0IHN0cnVjdCBkcm1faW9jdGxf
ZGVzYyAqaW9jdGw7Cj4KPiAgICAgICAgICAgICAgICAgaW9jdGwgPSAmaTkxNV9pb2N0bHNbbnJd
Owo+ICAgICAgICAgICAgICAgICBpZiAoaW9jdGwtPmZsYWdzICYgRFJNX0RSSVZFUl9JT0NUTCkK
PiAgICAgICAgICAgICAgICAgICAgICAgICBmbiA9IGlvY3RsLT5pb2N0bDsKPiAgICAgICAgICAg
ICAgICAgZWxzZQo+ICAgICAgICAgICAgICAgICAgICAgICAgIGZuID0gZHJtX2lvY3RsOwo+ICAg
ICAgICAgfQo+Cj4gICAgICAgICByZXR1cm4gZm4oZmlscCwgY21kLCBhcmcpOwoKLS0gCkphbmkg
TmlrdWxhLCBJbnRlbCBPcGVuIFNvdXJjZSBUZWNobm9sb2d5IENlbnRlcgpfX19fX19fX19fX19f
X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpJbnRlbC1nZnggbWFpbGluZyBsaXN0
CkludGVsLWdmeEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVlZGVza3Rv
cC5vcmcvbWFpbG1hbi9saXN0aW5mby9pbnRlbC1nZngK