From mboxrd@z Thu Jan  1 00:00:00 1970
From: Chris Wilson <chris@chris-wilson.co.uk>
Subject: [RFC] drm/i915: Introduce documentation for register
	subfields
Date: Fri, 19 Jun 2015 10:52:15 +0100
Message-ID: <1434707535-13014-1-git-send-email-chris@chris-wilson.co.uk>
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 fireflyinternet.com (mail.fireflyinternet.com [87.106.93.118])
 by gabe.freedesktop.org (Postfix) with ESMTP id E3F3C4A05C
 for <intel-gfx@lists.freedesktop.org>; Fri, 19 Jun 2015 02:53:16 -0700 (PDT)
List-Unsubscribe: <http://lists.freedesktop.org/mailman/options/intel-gfx>,
 <mailto:intel-gfx-request@lists.freedesktop.org?subject=unsubscribe>
List-Archive: <http://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: <http://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: intel-gfx@lists.freedesktop.org
List-Id: intel-gfx@lists.freedesktop.org

QW4gaW50ZXJlc3RpbmcgcG9pbnQgd2FzIHJhaXNlZCBpbiBzb21lIHJlY2VudCBwYXRjaGVzIHRv
IGRvY3VtZW50IHRoZQp2YXJpb3VzIHdpZHRocyBvZiB0aGUgcmVnaXN0ZXIgc3ViZmllbGRzLiBJ
IGRpc2FncmVlZCB3aXRoIHRoYXQgcGF0Y2ggaW4KdGhhdCBpdCB0cmFuc2Zvcm1lZCBpbGxlZ2Fs
IHZhbHVlcyBpbnRvIHNvbWUgcmFuZG9tIHBvdGVudGlhbGx5IGhhcm1mdWwKdmFsaWQgdmFsdWUg
KGFuZCBub3QgdHJhbnNmb3JtaW5nIGFuIGludmFsaWQgdmFsdWUgd291bGQgZW5kIHVwIHdyaXRp
bmcKYml0cyBpbiBvdGhlciBzdWJmaWVsZHMsIHNvIGVxdWFsbHkgYmFkKS4gTW9zdCBvZiBvdXIg
cmVnaXN0ZXIgdXNhZ2UgaXMKd2l0aCBzdGF0aWMgdmFsdWVzIHNvIHVubGlrZWx5IHRvIGJlIG9m
IGNvbmNlcm4sIGJ1dCBmb3IgdGhvc2Ugd2UgY2FuCmRvY3VtZW50IHRoZSByZWdpc3RlciBzdWJm
aWVsZHMgYW5kIHByb3ZpZGUgY29tcGlsZSB0aW1lIGNoZWNraW5nLgoKVGhlIHJlc3VsdGluZyBl
cnJvciBtZXNzYWdlIGlzIGZhaXJseSBpbXBlbnRlbnRyYWJsZSB0aG91Z2g6CgpuIGZpbGUgaW5j
bHVkZWQgZnJvbSBpbmNsdWRlL3VhcGkvbGludXgvc3RkZGVmLmg6MTowLAogICAgICAgICAgICAg
ICAgIGZyb20gaW5jbHVkZS9saW51eC9zdGRkZWYuaDo0LAogICAgICAgICAgICAgICAgIGZyb20g
Li9pbmNsdWRlL3VhcGkvbGludXgvcG9zaXhfdHlwZXMuaDo0LAogICAgICAgICAgICAgICAgIGZy
b20gaW5jbHVkZS91YXBpL2xpbnV4L3R5cGVzLmg6MTMsCiAgICAgICAgICAgICAgICAgZnJvbSBp
bmNsdWRlL2xpbnV4L3R5cGVzLmg6NSwKICAgICAgICAgICAgICAgICBmcm9tIGluY2x1ZGUvbGlu
dXgvbW9kX2RldmljZXRhYmxlLmg6MTEsCiAgICAgICAgICAgICAgICAgZnJvbSBpbmNsdWRlL2xp
bnV4L2kyYy5oOjI5LAogICAgICAgICAgICAgICAgIGZyb20gZHJpdmVycy9ncHUvZHJtL2k5MTUv
aW50ZWxfZHAuYzoyODoKSW4gZnVuY3Rpb24g4oCYaW50ZWxfZHBfYXV0b3Rlc3RfZWRpZOKAmSwK
ICAgIGlubGluZWQgZnJvbSDigJhpbnRlbF9kcF9oYW5kbGVfdGVzdF9yZXF1ZXN04oCZIGF0IGRy
aXZlcnMvZ3B1L2RybS9pOTE1L2ludGVsX2RwLmM6NDIzMDoxNCwKICAgIGlubGluZWQgZnJvbSDi
gJhpbnRlbF9kcF9kZXRlY3TigJkgYXQgZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfZHAuYzo0
NjM1OjQ6CmluY2x1ZGUvbGludXgvY29tcGlsZXIuaDo0Mjk6Mzg6IGVycm9yOiBjYWxsIHRvIOKA
mF9fY29tcGlsZXRpbWVfYXNzZXJ0XzQxNzPigJkgZGVjbGFyZWQgd2l0aCBhdHRyaWJ1dGUgZXJy
b3I6IEJVSUxEX0JVR19PTiBmYWlsZWQ6ICg1KSAmIC0oMTw8MikKICBfY29tcGlsZXRpbWVfYXNz
ZXJ0KGNvbmRpdGlvbiwgbXNnLCBfX2NvbXBpbGV0aW1lX2Fzc2VydF8sIF9fTElORV9fKQogICAg
ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgIF4KaW5jbHVkZS9saW51eC9jb21waWxl
ci5oOjQxMjo0OiBub3RlOiBpbiBkZWZpbml0aW9uIG9mIG1hY3JvIOKAmF9fY29tcGlsZXRpbWVf
YXNzZXJ04oCZCiAgICBwcmVmaXggIyMgc3VmZml4KCk7ICAgIFwKICAgIF4KaW5jbHVkZS9saW51
eC9jb21waWxlci5oOjQyOToyOiBub3RlOiBpbiBleHBhbnNpb24gb2YgbWFjcm8g4oCYX2NvbXBp
bGV0aW1lX2Fzc2VydOKAmQogIF9jb21waWxldGltZV9hc3NlcnQoY29uZGl0aW9uLCBtc2csIF9f
Y29tcGlsZXRpbWVfYXNzZXJ0XywgX19MSU5FX18pCiAgXgppbmNsdWRlL2xpbnV4L2J1Zy5oOjUw
OjM3OiBub3RlOiBpbiBleHBhbnNpb24gb2YgbWFjcm8g4oCYY29tcGlsZXRpbWVfYXNzZXJ04oCZ
CiAjZGVmaW5lIEJVSUxEX0JVR19PTl9NU0coY29uZCwgbXNnKSBjb21waWxldGltZV9hc3NlcnQo
IShjb25kKSwgbXNnKQogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgXgppbmNs
dWRlL2xpbnV4L2J1Zy5oOjc0OjI6IG5vdGU6IGluIGV4cGFuc2lvbiBvZiBtYWNybyDigJhCVUlM
RF9CVUdfT05fTVNH4oCZCiAgQlVJTERfQlVHX09OX01TRyhjb25kaXRpb24sICJCVUlMRF9CVUdf
T04gZmFpbGVkOiAiICNjb25kaXRpb24pCiAgXgpkcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9k
cC5jOjQ1OjY4OiBub3RlOiBpbiBleHBhbnNpb24gb2YgbWFjcm8g4oCYQlVJTERfQlVHX09O4oCZ
CiAjZGVmaW5lIF9fRklFTERfXyh4LCBzaGlmdCwgd2lkdGgpICh7IGlmIChfX2J1aWx0aW5fY29u
c3RhbnRfcCh4KSkgQlVJTERfQlVHX09OKCh4KSAmIC0oMTw8d2lkdGgpKTsgKCh4KSA8PCAoc2hp
ZnQpKTsgfSkKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
ICAgICAgICAgICAgICAgICAgICBeCmRyaXZlcnMvZ3B1L2RybS9pOTE1L2ludGVsX2RwLmM6NDc6
MzI6IG5vdGU6IGluIGV4cGFuc2lvbiBvZiBtYWNybyDigJhfX0ZJRUxEX1/igJkKICNkZWZpbmUg
SU5URUxfRFBfUkVTT0xVVElPTih4KSBfX0ZJRUxEX18oeCwgSU5URUxfRFBfUkVTT0xVVElPTl9T
SElGVCwgMikKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICBeCmRyaXZlcnMvZ3B1L2Ry
bS9pOTE1L2ludGVsX2RwLmM6NTE6MzY6IG5vdGU6IGluIGV4cGFuc2lvbiBvZiBtYWNybyDigJhJ
TlRFTF9EUF9SRVNPTFVUSU9O4oCZCiAjZGVmaW5lIElOVEVMX0RQX1JFU09MVVRJT05fQlJPS0VO
IElOVEVMX0RQX1JFU09MVVRJT04oNSkKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
ICAgXgpkcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9kcC5jOjQxNzM6MzY6IG5vdGU6IGluIGV4
cGFuc2lvbiBvZiBtYWNybyDigJhJTlRFTF9EUF9SRVNPTFVUSU9OX0JST0tFTuKAmQogICBpbnRl
bF9kcC0+Y29tcGxpYW5jZV90ZXN0X2RhdGEgPSBJTlRFTF9EUF9SRVNPTFVUSU9OX0JST0tFTjsK
CldlIGNhbiBleHRlbmQgdGhlIG1hY3JvIHRvIFdBUk5fT04gZm9yIGluc3RhbmNlcyBvZiBydW50
aW1lIHZpb2xhdGlvbiAtCm1heWJlIHVzZWZ1bCwgYnV0IGl0IHN1cmVseSB3b3VsZCBidWxrIG91
ciBjb2RlIG91dCBkcmFtYXRpY2FsbHkuCgpTaWduZWQtb2ZmLWJ5OiBDaHJpcyBXaWxzb24gPGNo
cmlzQGNocmlzLXdpbHNvbi5jby51az4KLS0tCiBkcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9k
cC5jIHwgMTAgKysrKysrLS0tLQogMSBmaWxlIGNoYW5nZWQsIDYgaW5zZXJ0aW9ucygrKSwgNCBk
ZWxldGlvbnMoLSkKCmRpZmYgLS1naXQgYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9kcC5j
IGIvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfZHAuYwppbmRleCBmNTJlZWYxMzgyNDcuLmZl
NDRiMDZhZGViNCAxMDA2NDQKLS0tIGEvZHJpdmVycy9ncHUvZHJtL2k5MTUvaW50ZWxfZHAuYwor
KysgYi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9kcC5jCkBAIC00MiwxMCArNDIsMTIgQEAK
ICNkZWZpbmUgRFBfTElOS19DSEVDS19USU1FT1VUCSgxMCAqIDEwMDApCiAKIC8qIENvbXBsaWFu
Y2UgdGVzdCBzdGF0dXMgYml0cyAgKi8KLSNkZWZpbmUgSU5URUxfRFBfUkVTT0xVVElPTl9TSElG
VF9NQVNLCTAKLSNkZWZpbmUgSU5URUxfRFBfUkVTT0xVVElPTl9QUkVGRVJSRUQJKDEgPDwgSU5U
RUxfRFBfUkVTT0xVVElPTl9TSElGVF9NQVNLKQotI2RlZmluZSBJTlRFTF9EUF9SRVNPTFVUSU9O
X1NUQU5EQVJECSgyIDw8IElOVEVMX0RQX1JFU09MVVRJT05fU0hJRlRfTUFTSykKLSNkZWZpbmUg
SU5URUxfRFBfUkVTT0xVVElPTl9GQUlMU0FGRQkoMyA8PCBJTlRFTF9EUF9SRVNPTFVUSU9OX1NI
SUZUX01BU0spCisjZGVmaW5lIF9fRklFTERfXyh4LCBzaGlmdCwgd2lkdGgpICh7IGlmIChfX2J1
aWx0aW5fY29uc3RhbnRfcCh4KSkgQlVJTERfQlVHX09OKCh4KSAmIC0oMTw8d2lkdGgpKTsgKCh4
KSA8PCAoc2hpZnQpKTsgfSkKKyNkZWZpbmUgSU5URUxfRFBfUkVTT0xVVElPTl9TSElGVCAwCisj
ZGVmaW5lIElOVEVMX0RQX1JFU09MVVRJT04oeCkgX19GSUVMRF9fKHgsIElOVEVMX0RQX1JFU09M
VVRJT05fU0hJRlQsIDIpCisjZGVmaW5lIElOVEVMX0RQX1JFU09MVVRJT05fUFJFRkVSUkVECUlO
VEVMX0RQX1JFU09MVVRJT04oMSkKKyNkZWZpbmUgSU5URUxfRFBfUkVTT0xVVElPTl9TVEFOREFS
RAlJTlRFTF9EUF9SRVNPTFVUSU9OKDIpCisjZGVmaW5lIElOVEVMX0RQX1JFU09MVVRJT05fRkFJ
TFNBRkUJSU5URUxfRFBfUkVTT0xVVElPTigzKQogCiBzdHJ1Y3QgZHBfbGlua19kcGxsIHsKIAlp
bnQgbGlua19idzsKLS0gCjIuMS40CgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f
X19fX19fX19fX19fXwpJbnRlbC1nZnggbWFpbGluZyBsaXN0CkludGVsLWdmeEBsaXN0cy5mcmVl
ZGVza3RvcC5vcmcKaHR0cDovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZv
L2ludGVsLWdmeAo=