From dri-devel  Thu Jul 20 05:03:53 2023
From: Zack Rusin <zackr () vmware ! com>
Date: Thu, 20 Jul 2023 05:03:53 +0000
To: dri-devel
Subject: Re: [PATCH v5 9/9] drm: Introduce documentation for hotspot properties
Message-Id: <41590ef35281fbc54be1ee58d9187ede8bc44698.camel () vmware ! com>
X-MARC-Message: https://marc.info/?l=dri-devel&m=168982935627684

T24gV2VkLCAyMDIzLTA3LTE5IGF0IDExOjE1ICswMzAwLCBQZWtrYSBQYWFsYW5lbiB3cm90ZToN
Cj4gT24gVHVlLCAxOCBKdWwgMjAyMyAyMTo0MjoxOCAtMDQwMA0KPiBaYWNrIFJ1c2luIDx6YWNr
QGtkZS5vcmc+IHdyb3RlOg0KPiANCj4gPiBGcm9tOiBNaWNoYWVsIEJhbmFjayA8YmFuYWNrbUB2
bXdhcmUuY29tPg0KPiA+IA0KPiA+IFRvIGNsYXJpZnkgdGhlIGludGVudCBhbmQgcmVhc29uaW5n
IGJlaGluZCB0aGUgaG90c3BvdCBwcm9wZXJ0aWVzDQo+ID4gaW50cm9kdWNlIHVzZXJzcGFjZSBk
b2N1bWVudGF0aW9uIHRoYXQgZ29lcyBvdmVyIGN1cnNvciBoYW5kbGluZw0KPiA+IGluIHBhcmEt
dmlydHVhbGl6ZWQgZW52aXJvbm1lbnRzLg0KPiA+IA0KPiA+IFRoZSBkb2N1bWVudGF0aW9uIGlz
IGdlbmVyaWMgZW5vdWdoIHRvIG5vdCBzcGVjaWFsIGNhc2UgZm9yIGFueQ0KPiA+IHNwZWNpZmlj
IGh5cGVydmlzb3IgYW5kIHNob3VsZCBhcHBseSBlcXVhbGx5IHRvIGFsbC4NCj4gPiANCj4gPiBT
aWduZWQtb2ZmLWJ5OiBaYWNrIFJ1c2luIDx6YWNrckB2bXdhcmUuY29tPg0KPiA+IC0tLQ0KPiA+
IMKgRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy5yc3QgfMKgIDYgKysrKw0KPiA+IMKgZHJpdmVy
cy9ncHUvZHJtL2RybV9wbGFuZS5jwqDCoCB8IDU4ICsrKysrKysrKysrKysrKysrKysrKysrKysr
KysrKysrKystDQo+ID4gwqAyIGZpbGVzIGNoYW5nZWQsIDYzIGluc2VydGlvbnMoKyksIDEgZGVs
ZXRpb24oLSkNCj4gPiANCj4gPiBkaWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWtt
cy5yc3QgYi9Eb2N1bWVudGF0aW9uL2dwdS9kcm0ta21zLnJzdA0KPiA+IGluZGV4IGM5MmQ0MjVj
YjJkZC4uNzE1OWIzZTkwYThhIDEwMDY0NA0KPiA+IC0tLSBhL0RvY3VtZW50YXRpb24vZ3B1L2Ry
bS1rbXMucnN0DQo+ID4gKysrIGIvRG9jdW1lbnRhdGlvbi9ncHUvZHJtLWttcy5yc3QNCj4gPiBA
QCAtNTc3LDYgKzU3NywxMiBAQCBWYXJpYWJsZSBSZWZyZXNoIFByb3BlcnRpZXMNCj4gPiDCoC4u
IGtlcm5lbC1kb2M6OiBkcml2ZXJzL2dwdS9kcm0vZHJtX2Nvbm5lY3Rvci5jDQo+ID4gwqDCoMKg
IDpkb2M6IFZhcmlhYmxlIHJlZnJlc2ggcHJvcGVydGllcw0KPiA+IMKgDQo+ID4gK0N1cnNvciBI
b3RzcG90IFByb3BlcnRpZXMNCj4gPiArLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tDQo+ID4g
Kw0KPiA+ICsuLiBrZXJuZWwtZG9jOjogZHJpdmVycy9ncHUvZHJtL2RybV9wbGFuZS5jDQo+ID4g
K8KgwqAgOmRvYzogaG90c3BvdCBwcm9wZXJ0aWVzDQo+ID4gKw0KPiA+IMKgRXhpc3RpbmcgS01T
IFByb3BlcnRpZXMNCj4gPiDCoC0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tDQo+ID4gwqANCj4gPiBk
aWZmIC0tZ2l0IGEvZHJpdmVycy9ncHUvZHJtL2RybV9wbGFuZS5jIGIvZHJpdmVycy9ncHUvZHJt
L2RybV9wbGFuZS5jDQo+ID4gaW5kZXggMWRjMDBhZDRjMzNjLi5mM2YyZWFlODNjY2EgMTAwNjQ0
DQo+ID4gLS0tIGEvZHJpdmVycy9ncHUvZHJtL2RybV9wbGFuZS5jDQo+ID4gKysrIGIvZHJpdmVy
cy9ncHUvZHJtL2RybV9wbGFuZS5jDQo+ID4gQEAgLTIzMCw2ICsyMzAsNjEgQEAgc3RhdGljIGlu
dCBjcmVhdGVfaW5fZm9ybWF0X2Jsb2Ioc3RydWN0IGRybV9kZXZpY2UgKmRldiwNCj4gPiBzdHJ1
Y3QgZHJtX3BsYW5lICpwbGFuZQ0KPiA+IMKgwqDCoMKgwqDCoMKgwqByZXR1cm4gMDsNCj4gPiDC
oH0NCj4gPiDCoA0KPiA+ICsvKioNCj4gPiArICogRE9DOiBob3RzcG90IHByb3BlcnRpZXMNCj4g
PiArICoNCj4gPiArICogSE9UU1BPVF9YOiBwcm9wZXJ0eSB0byBzZXQgbW91c2UgaG90c3BvdCB4
IG9mZnNldC4NCj4gPiArICogSE9UU1BPVF9ZOiBwcm9wZXJ0eSB0byBzZXQgbW91c2UgaG90c3Bv
dCB5IG9mZnNldC4NCj4gPiArICoNCj4gPiArICogV2hlbiB0aGUgcGxhbmUgaXMgYmVpbmcgdXNl
ZCBhcyBhIGN1cnNvciBpbWFnZSB0byBkaXNwbGF5IGEgbW91c2UgcG9pbnRlciwNCj4gPiArICog
dGhlICJob3RzcG90IiBpcyB0aGUgb2Zmc2V0IHdpdGhpbiB0aGUgY3Vyc29yIGltYWdlIHdoZXJl
IG1vdXNlIGV2ZW50cw0KPiA+ICsgKiBhcmUgZXhwZWN0ZWQgdG8gZ28uDQo+ID4gKyAqDQo+ID4g
KyAqIFBvc2l0aXZlIHZhbHVlcyBtb3ZlIHRoZSBob3RzcG90IGZyb20gdGhlIHRvcC1sZWZ0IGNv
cm5lciBvZiB0aGUgY3Vyc29yDQo+ID4gKyAqIHBsYW5lIHRvd2FyZHMgdGhlIHJpZ2h0IGFuZCBi
b3R0b20uDQo+ID4gKyAqDQo+ID4gKyAqIE1vc3QgZGlzcGxheSBkcml2ZXJzIGRvIG5vdCBuZWVk
IHRoaXMgaW5mb3JtYXRpb24gYmVjYXVzZSB0aGUNCj4gPiArICogaG90c3BvdCBpcyBub3QgYWN0
dWFsbHkgY29ubmVjdGVkIHRvIGFueXRoaW5nIHZpc2libGUgb24gc2NyZWVuLg0KPiA+ICsgKiBI
b3dldmVyLCB0aGlzIGlzIG5lY2Vzc2FyeSBmb3IgZGlzcGxheSBkcml2ZXJzIGxpa2UgdGhlIHBh
cmEtdmlydHVhbGl6ZWQNCj4gPiArICogZHJpdmVycyAoZWcgcXhsLCB2Ym94LCB2aXJ0aW8sIHZt
d2dmeCksIHRoYXQgYXJlIGF0dGFjaGVkIHRvIGEgdXNlciBjb25zb2xlDQo+ID4gKyAqIHdpdGgg
YSBtb3VzZSBwb2ludGVyLsKgIFNpbmNlIHRoZXNlIGNvbnNvbGVzIGFyZSBvZnRlbiBiZWluZyBy
ZW1vdGVkIG92ZXIgYQ0KPiA+ICsgKiBuZXR3b3JrLCB0aGV5IHdvdWxkIG90aGVyd2lzZSBoYXZl
IHRvIHdhaXQgdG8gZGlzcGxheSB0aGUgcG9pbnRlciBtb3ZlbWVudA0KPiA+IHRvDQo+ID4gKyAq
IHRoZSB1c2VyIHVudGlsIGEgZnVsbCBuZXR3b3JrIHJvdW5kLXRyaXAgaGFzIG9jY3VycmVkLsKg
IE5ldyBtb3VzZSBldmVudHMNCj4gPiBoYXZlDQo+ID4gKyAqIHRvIGJlIHNlbnQgZnJvbSB0aGUg
dXNlcidzIGNvbnNvbGUsIG92ZXIgdGhlIG5ldHdvcmsgdG8gdGhlIHZpcnR1YWwgaW5wdXQNCj4g
PiArICogZGV2aWNlcywgZm9yd2FyZGVkIHRvIHRoZSBkZXNrdG9wIGZvciBwcm9jZXNzaW5nLCBh
bmQgdGhlbiB0aGUgY3Vyc29yDQo+ID4gcGxhbmUncw0KPiA+ICsgKiBwb3NpdGlvbiBjYW4gYmUg
dXBkYXRlZCBhbmQgc2VudCBiYWNrIHRvIHRoZSB1c2VyJ3MgY29uc29sZSBvdmVyIHRoZQ0KPiA+
IG5ldHdvcmsuDQo+ID4gKyAqIEluc3RlYWQsIHdpdGggdGhlIGhvdHNwb3QgaW5mb3JtYXRpb24s
IHRoZSBjb25zb2xlIGNhbiBhbnRpY2lwYXRlIHRoZSBuZXcNCj4gPiArICogbG9jYXRpb24sIGFu
ZCBkcmF3IHRoZSBtb3VzZSBjdXJzb3IgdGhlcmUgYmVmb3JlIHRoZSBjb25maXJtYXRpb24gY29t
ZXMgaW4uDQo+ID4gKyAqIFRvIGRvIHRoYXQgY29ycmVjdGx5LCB0aGUgdXNlcidzIGNvbnNvbGUg
bXVzdCBiZSBhYmxlIHByZWRpY3QgaG93IHRoZQ0KPiA+ICsgKiBkZXNrdG9wIHdpbGwgcHJvY2Vz
cyBtb3VzZSBldmVudHMsIHdoaWNoIG5vcm1hbGx5IHJlcXVpcmVzIHRoZSBkZXNrdG9wJ3MNCj4g
PiArICogbW91c2UgdG9wb2xvZ3kgaW5mb3JtYXRpb24sIGllIHdoZXJlIGVhY2ggQ1JUQyBzaXRz
IGluIHRoZSBtb3VzZSBjb29yZGluYXRlDQo+ID4gKyAqIHNwYWNlLsKgIFRoaXMgaXMgdHlwaWNh
bGx5IHNlbnQgdG8gdGhlIHBhcmEtdmlydHVhbGl6ZWQgZHJpdmVycyB1c2luZyBzb21lDQo+ID4g
KyAqIGRyaXZlci1zcGVjaWZpYyBtZXRob2QsIGFuZCB0aGUgZHJpdmVyIHRoZW4gZm9yd2FyZHMg
aXQgdG8gdGhlIGNvbnNvbGUgYnkNCj4gPiArICogd2F5IG9mIHRoZSB2aXJ0dWFsIGRpc3BsYXkg
ZGV2aWNlIG9yIGh5cGVydmlzb3IuDQo+ID4gKyAqDQo+ID4gKyAqIFRoZSBhc3N1bXB0aW9uIGlz
IGdlbmVyYWxseSBtYWRlIHRoYXQgdGhlcmUgaXMgb25seSBvbmUgY3Vyc29yIHBsYW5lIGJlaW5n
DQo+ID4gKyAqIHVzZWQgdGhpcyB3YXkgYXQgYSB0aW1lLCBhbmQgdGhhdCB0aGUgZGVza3RvcCBp
cyBmZWVkaW5nIGFsbCBtb3VzZSBkZXZpY2VzDQo+ID4gKyAqIGludG8gdGhlIHNhbWUgZ2xvYmFs
IHBvaW50ZXIuwqAgUGFyYS12aXJ0dWFsaXplZCBkcml2ZXJzIHRoYXQgcmVxdWlyZSB0aGlzDQo+
ID4gKyAqIHNob3VsZCBvbmx5IGJlIGV4cG9zaW5nIGEgc2luZ2xlIGN1cnNvciBwbGFuZSwgb3Ig
ZmluZCBzb21lIG90aGVyIHdheQ0KPiA+ICsgKiB0byBjb29yZGluYXRlIHdpdGggYSB1c2Vyc3Bh
Y2UgZGVza3RvcCB0aGF0IHN1cHBvcnRzIG11bHRpcGxlIHBvaW50ZXJzLg0KPiA+ICsgKiBJZiB0
aGUgaG90c3BvdCBwcm9wZXJ0aWVzIGFyZSBzZXQsIHRoZSBjdXJzb3IgcGxhbmUgaXMgdGhlcmVm
b3JlIGFzc3VtZWQgdG8NCj4gPiBiZQ0KPiA+ICsgKiB1c2VkIG9ubHkgZm9yIGRpc3BsYXlpbmcg
YSBtb3VzZSBjdXJzb3IgaW1hZ2UsIGFuZCB0aGUgcG9zaXRpb24gb2YgdGhlDQo+ID4gY29tYmlu
ZWQNCj4gPiArICogY3Vyc29yIHBsYW5lICsgb2Zmc2V0IGNhbiB0aGVyZWZvcmUgYmUgdXNlZCBm
b3IgY29vcmRpbmF0aW5nIHdpdGggaW5wdXQgZnJvbQ0KPiA+IGENCj4gPiArICogbW91c2UgZGV2
aWNlLg0KPiA+ICsgKg0KPiA+ICsgKiBUaGUgY3Vyc29yIHdpbGwgdGhlbiBiZSBkcmF3biBlaXRo
ZXIgYXQgdGhlIGxvY2F0aW9uIG9mIHRoZSBwbGFuZSBpbiB0aGUNCj4gPiBDUlRDDQo+ID4gKyAq
IGNvbnNvbGUsIG9yIGFzIGEgZnJlZS1mbG9hdGluZyBjdXJzb3IgcGxhbmUgb24gdGhlIHVzZXIn
cyBjb25zb2xlDQo+ID4gKyAqIGNvcnJlc3BvbmRpbmcgdG8gdGhlaXIgZGVza3RvcCBtb3VzZSBw
b3NpdGlvbi4NCj4gPiArICoNCj4gPiArICogRFJNIGNsaWVudHMgd2hpY2ggd291bGQgbGlrZSB0
byB3b3JrIGNvcnJlY3RseSBvbiBkcml2ZXJzIHdoaWNoIGV4cG9zZQ0KPiA+ICsgKiBob3RzcG90
IHByb3BlcnRpZXMgc2hvdWxkIGFkdmVydGlzZSBEUk1fQ0xJRU5UX0NBUF9DVVJTT1JfUExBTkVf
SE9UU1BPVC4NCj4gPiArICogU2V0dGluZyB0aGlzIHByb3BlcnR5IG9uIGRyaXZlcnMgd2hpY2gg
ZG8gbm90IHNwZWNpYWwgY2FzZQ0KPiA+ICsgKiBjdXJzb3IgcGxhbmVzIHdpbGwgcmV0dXJuIEVP
UE5PVFNVUFAsIHdoaWNoIGNhbiBiZSB1c2VkIGJ5IHVzZXJzcGFjZSB0bw0KPiA+ICsgKiBnYXVn
ZSByZXF1aXJlbWVudHMgb2YgdGhlIGhhcmR3YXJlL2RyaXZlcnMgdGhleSdyZSBydW5uaW5nIG9u
LiBBZHZlcnRpc2luZw0KPiA+ICsgKiBEUk1fQ0xJRU5UX0NBUF9DVVJTT1JfUExBTkVfSE9UU1BP
VCBpbXBsaWVzIHRoYXQgdGhlIHVzZXJzcGFjZSBjbGllbnQgd2lsbA0KPiA+IGJlDQo+ID4gKyAq
IGNvcnJlY3RseSBzZXR0aW5nIHRoZSBob3RzcG90IHByb3BlcnRpZXMuDQo+ID4gKyAqLw0KPiAN
Cj4gWWVzISBUaGlzIGlzIGV4YWN0bHkgd2hhdCBJIHdhcyBhZnRlci4gVGhhbmsgeW91IQ0KPiAN
Cj4gPiArDQo+ID4gwqAvKioNCj4gPiDCoCAqIGRybV9wbGFuZV9jcmVhdGVfaG90c3BvdF9wcm9w
ZXJ0aWVzIC0gY3JlYXRlcyB0aGUgbW91c2UgaG90c3BvdA0KPiA+IMKgICogcHJvcGVydGllcyBh
bmQgYXR0YWNoZXMgdGhlbSB0byB0aGUgZ2l2ZW4gY3Vyc29yIHBsYW5lDQo+ID4gQEAgLTIzNyw3
ICsyOTIsOCBAQCBzdGF0aWMgaW50IGNyZWF0ZV9pbl9mb3JtYXRfYmxvYihzdHJ1Y3QgZHJtX2Rl
dmljZSAqZGV2LA0KPiA+IHN0cnVjdCBkcm1fcGxhbmUgKnBsYW5lDQo+ID4gwqAgKiBAcGxhbmU6
IGRybSBjdXJzb3IgcGxhbmUNCj4gPiDCoCAqDQo+ID4gwqAgKiBUaGlzIGZ1bmN0aW9uIGVuYWJs
ZXMgdGhlIG1vdXNlIGhvdHNwb3QgcHJvcGVydHkgb24gYSBnaXZlbg0KPiA+IC0gKiBjdXJzb3Ig
cGxhbmUuDQo+ID4gKyAqIGN1cnNvciBwbGFuZS4gTG9vayBhdCB0aGUgZG9jdW1lbnRhdGlvbiBm
b3IgaG90c3BvdCBwcm9wZXJ0aWVzDQo+ID4gKyAqIHRvIGdldCBhIGJldHRlciB1bmRlcnN0YW5k
aW5nIGZvciB3aGF0IHRoZXkncmUgdXNlZCBmb3IuDQo+IA0KPiBJIGhhdmVuJ3Qgc2VlbiB0aGUg
cmVuZGVyZWQgSFRNTCwgYnV0IGlzIHRoZXJlIGEgaHlwZXJsaW5rIGZyb20gaGVyZSB0bw0KPiB0
aGUgaG90c3BvdCBwcm9wZXJ0eSBkb2M/IEkgdGhpbmsgYSBsaW5rIHdvdWxkIGJlIG5lYXQuDQoN
CmRybV9wbGFuZV9jcmVhdGVfaG90c3BvdF9wcm9wZXJ0aWVzIGlzIG5vdyBhIHN0YXRpYyBmdW5j
dGlvbiBzbyBpdCdzIG5vdA0KZ2VuZXJhdGVkIGluIHRoZSBkb2NzIChidXQgdG8gYmUgZmFpciwg
SSdtIGFsc28gbm90IGF3YXJlIG9mIGhvdyB0byBsaW5rIHRvIGRybS0NCmttcy5yc3Qgc2VjdGlv
biBmcm9tIHdpdGhpbiBmdW5jdGlvbiBkb2NzIGJlY2F1c2UgSSB0cmllZCB0aGF0IGZpcnN0IG9u
bHkgdG8gcmVhbGl6ZQ0KaXQncyBhIHN0YXRpYyBmdW5jdGlvbiBhbmQgbm90IGluIHRoZSBnZW5l
cmF0ZWQgaHRtbCBkb2NzKS4NCg0KSSdsbCBnaXZlIHRoaXMgc2VyaWVzIGEgZmV3IG1vcmUgaG91
cnMgb24gdGhlIGxpc3QgYW5kIGlmIG5vIG9uZSBvYmplY3RzIEknbGwgcHVzaA0KaXQgdG8gZHJt
LW1pc2MgbGF0ZXIgdG9kYXkuIFRoYW5rcyENCg0Keg0K