From: Jani Nikula Subject: [PATCH] drm/i915: add register macro definition style guide Date: Fri, 4 Aug 2017 13:38:36 +0300 Message-ID: <20170804103836.17629-1-jani.nikula@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by gabe.freedesktop.org (Postfix) with ESMTPS id 5B3E06E327 for ; Fri, 4 Aug 2017 10:33:45 +0000 (UTC) List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: intel-gfx@lists.freedesktop.org Cc: jani.nikula@intel.com, Daniel Vetter List-Id: intel-gfx@lists.freedesktop.org VGhpcyBpcyBub3QgdG8gdHJ5IHRvIGZvcmNlIGEgbmV3IHN0eWxlOyB0aGlzIGlzIG15IGludGVy cHJldGF0aW9uIG9mCndoYXQgdGhlIG1vc3QgY29tbW9uIGV4aXN0aW5nIHN0eWxlIGlzLgoKV2l0 aCBob3BlcyBJIGRvbid0IG5lZWQgdG8gYW5zd2VyIHNvIG1hbnkgcXVlc3Rpb25zIGFib3V0IHN0 eWxlIGdvaW5nCmZvcndhcmQuCgpDYzogRGFuaWVsIFZldHRlciA8ZGFuaWVsLnZldHRlckBmZnds bC5jaD4KU2lnbmVkLW9mZi1ieTogSmFuaSBOaWt1bGEgPGphbmkubmlrdWxhQGludGVsLmNvbT4K Ci0tLQoKTi5iLiBvbmx5IHRoZSAqaW50ZXJwcmV0YXRpb24qIG9mIHRoZSBleGlzdGluZyBzdHls ZSBpcyB1cCBmb3IgZGViYXRlCmhlcmUuIFByb3Bvc2FscyB0byAqY2hhbmdlKiB0aGUgc3R5bGUg Z29pbmcgZm9yd2FyZCBjYW4gYmUgZG9uZSBpbiBvdGhlcgpwYXRjaGVzIGNoYW5naW5nIHRoaXMg ZGVzY3JpcHRpb24uIEhvd2V2ZXIsIEkgZG91YnQgdGhlIHVzZWZ1bG5lc3Mgb2YKc3VjaCBjaGFu Z2VzLCB3aXRoIHRoZSBwb3NzaWJsZSBleGNlcHRpb24gb2YgcHJvbW90aW5nIHRoZSB1c2Ugb2Yg QklUKCkuCi0tLQogZHJpdmVycy9ncHUvZHJtL2k5MTUvaTkxNV9yZWcuaCB8IDc3ICsrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrCiAxIGZpbGUgY2hhbmdlZCwgNzcgaW5z ZXJ0aW9ucygrKQoKZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfcmVnLmgg Yi9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pOTE1X3JlZy5oCmluZGV4IGIyNTQ2YWRlMmM0NS4uMzI0 Y2YwNGQ2YmZlIDEwMDY0NAotLS0gYS9kcml2ZXJzL2dwdS9kcm0vaTkxNS9pOTE1X3JlZy5oCisr KyBiL2RyaXZlcnMvZ3B1L2RybS9pOTE1L2k5MTVfcmVnLmgKQEAgLTI1LDYgKzI1LDgzIEBACiAj aWZuZGVmIF9JOTE1X1JFR19IXwogI2RlZmluZSBfSTkxNV9SRUdfSF8KIAorLyoKKyAqIFRoZSBp OTE1IHJlZ2lzdGVyIG1hY3JvIGRlZmluaXRpb24gc3R5bGUgZ3VpZGUuCisgKgorICogRm9sbG93 IHRoZSBzdHlsZSBkZXNjcmliZWQgaGVyZSBmb3IgbmV3IG1hY3JvcywgYW5kIHdoaWxlIGNoYW5n aW5nIGV4aXN0aW5nCisgKiBtYWNyb3MuIERvIG5vdCBtYXNzIGNoYW5nZSBleGlzdGluZyBkZWZp bml0aW9ucyBqdXN0IHRvIHVwZGF0ZSB0aGUgc3R5bGUuCisgKgorICogTEFZT1VUCisgKgorICog S2VlcCBoZWxwZXIgbWFjcm9zIG5lYXIgdGhlIHRvcC4gRm9yIGV4YW1wbGUsIF9QSVBFKCkgYW5k IGZyaWVuZHMuCisgKgorICogUHJlZml4IG1hY3JvcyB0aGF0IGdlbmVyYWxseSBzaG91bGQgbm90 IGJlIHVzZWQgb3V0c2lkZSBvZiB0aGlzIGZpbGUgd2l0aAorICogdW5kZXJzY29yZSAnXycuIEZv ciBleGFtcGxlLCBfUElQRSgpIGFuZCBmcmllbmRzLCBzaW5nbGUgaW5zdGFuY2VzIG9mCisgKiBy ZWdpc3RlcnMgdGhhdCBhcmUgZGVmaW5lZCBzb2xlbHkgZm9yIHRoZSB1c2UgYnkgZnVuY3Rpb24t bGlrZSBtYWNyb3MuCisgKgorICogQXZvaWQgdXNpbmcgdGhlIHVuZGVyc2NvcmUgcHJlZml4ZWQg bWFjcm9zIG91dHNpZGUgb2YgdGhpcyBmaWxlLiBUaGVyZSBhcmUKKyAqIGV4Y2VwdGlvbnMsIGJ1 dCBrZWVwIHRoZW0gdG8gYSBtaW5pbXVtLgorICoKKyAqIFRoZXJlIGFyZSB0d28gYmFzaWMgdHlw ZXMgb2YgcmVnaXN0ZXIgZGVmaW5pdGlvbnM6IFNpbmdsZSByZWdpc3RlcnMgYW5kCisgKiByZWdp c3RlciBncm91cHMuIFJlZ2lzdGVyIGdyb3VwcyBhcmUgcmVnaXN0ZXJzIHdoaWNoIGhhdmUgdHdv IG9yIG1vcmUKKyAqIGluc3RhbmNlcywgZm9yIGV4YW1wbGUgb25lIHBlciBwaXBlLCBwb3J0LCB0 cmFuc2NvZGVyLCBldGMuIFJlZ2lzdGVyIGdyb3VwcworICogc2hvdWxkIGJlIGRlZmluZWQgdXNp bmcgZnVuY3Rpb24tbGlrZSBtYWNyb3MuCisgKgorICogRm9yIHNpbmdsZSByZWdpc3RlcnMsIGRl ZmluZSB0aGUgcmVnaXN0ZXIgb2Zmc2V0IGZpcnN0LCBmb2xsb3dlZCBieSByZWdpc3RlcgorICog Y29udGVudHMuCisgKgorICogRm9yIHJlZ2lzdGVyIGdyb3VwcywgZGVmaW5lIHRoZSByZWdpc3Rl ciBpbnN0YW5jZSBvZmZzZXRzIGZpcnN0LCBwcmVmaXhlZAorICogd2l0aCB1bmRlcnNjb3JlLCBm b2xsb3dlZCBieSBhIGZ1bmN0aW9uLWxpa2UgbWFjcm8gY2hvb3NpbmcgdGhlIHJpZ2h0CisgKiBp bnN0YW5jZSBiYXNlZCBvbiB0aGUgcGFyYW1ldGVyLCBmb2xsb3dlZCBieSByZWdpc3RlciBjb250 ZW50cy4KKyAqCisgKiBEZWZpbmUgdGhlIHJlZ2lzdGVyIGNvbnRlbnRzIGZyb20gbW9zdCBzaWdu aWZpY2FudCB0byBsZWFzdCBzaWduaWZpY2FudAorICogYml0LiBJbmRlbnQgdGhlIGJpdCBhbmQg Yml0IGZpZWxkIG1hY3JvcyB1c2luZyB0d28gZXh0cmEgc3BhY2VzIGJldHdlZW4KKyAqICNkZWZp bmUgYW5kIHRoZSBtYWNybyBuYW1lLgorICoKKyAqIEZvciBiaXQgZmllbGRzLCBkZWZpbmUgYSBf TUFTSyBhbmQgYSBfU0hJRlQgbWFjcm8uIERlZmluZSBiaXQgZmllbGQgY29udGVudHMKKyAqIHNv IHRoYXQgdGhleSBhcmUgYWxyZWFkeSBzaGlmdGVkIGluIHBsYWNlLCBhbmQgY2FuIGJlIGRpcmVj dGx5IE9SJ2QuIEZvcgorICogY29udmVuaWVuY2UsIGZ1bmN0aW9uLWxpa2UgbWFjcm9zIG1heSBi ZSB1c2VkIHRvIGRlZmluZSBiaXQgZmllbGRzLCBidXQgZG8KKyAqIG5vdGUgdGhhdCB0aGUgbWFj cm9zIG1heSBiZSBuZWVkZWQgdG8gcmVhZCBhcyB3ZWxsIGFzIHdyaXRlIHRoZSByZWdpc3Rlcgor ICogY29udGVudHMuCisgKgorICogRGVmaW5lIGJpdHMgdXNpbmcgKDEgPDwgTikgaW5zdGVhZCBv ZiBCSVQoTikuIFdlIG1heSBjaGFuZ2UgdGhpcyBpbiB0aGUKKyAqIGZ1dHVyZSwgYnV0IHRoaXMg aXMgdGhlIHByZXZhaWxpbmcgc3R5bGUuCisgKgorICogR3JvdXAgdGhlIHJlZ2lzdGVyIGFuZCBp dHMgY29udGVudHMgdG9nZXRoZXIgd2l0aG91dCBibGFuayBsaW5lcywgc2VwYXJhdGUKKyAqIGZy b20gb3RoZXIgcmVnaXN0ZXJzIGFuZCB0aGVpciBjb250ZW50cyB3aXRoIG9uZSBibGFuayBsaW5l LgorICoKKyAqIEluZGVudCBtYWNybyB2YWx1ZXMgZnJvbSBtYWNybyBuYW1lcyB1c2luZyBUQUJz LiBVc2UgYnJhY2VzIGluIG1hY3JvIHZhbHVlcworICogYXMgbmVlZGVkIHRvIGF2b2lkIHVuaW50 ZW5kZWQgcHJlY2VkZW5jZSBhZnRlciBtYWNybyBzdWJzdGl0dXRpb24uIFVzZSBzcGFjZXMKKyAq IGluIG1hY3JvIHZhbHVlcyBhY2NvcmRpbmcgdG8ga2VybmVsIGNvZGluZyBzdHlsZS4gVXNlIGxv d2VyIGNhc2UgaW4KKyAqIGhleGFkZWNpbWFsIHZhbHVlcy4KKyAqCisgKiBOQU1JTkcKKyAqCisg KiBUcnkgdG8gbmFtZSByZWdpc3RlcnMgYWNjb3JkaW5nIHRvIHRoZSBzcGVjcy4gSWYgdGhlIHJl Z2lzdGVyIG5hbWUgY2hhbmdlcyBpbgorICogdGhlIHNwZWNzIGZyb20gcGxhdGZvcm0gdG8gYW5v dGhlciwgc3RpY2sgdG8gdGhlIG9yaWdpbmFsIG5hbWUuCisgKgorICogVHJ5IHRvIHJlLXVzZSBl eGlzdGluZyByZWdpc3RlciBtYWNybyBkZWZpbml0aW9ucy4gT25seSBhZGQgbmV3IG1hY3JvcyBm b3IKKyAqIG5ldyByZWdpc3RlciBvZmZzZXRzLCBvciB3aGVuIHRoZSByZWdpc3RlciBjb250ZW50 cyBoYXZlIGNoYW5nZWQgZW5vdWdoIHRvCisgKiB3YXJyYW50IGEgZnVsbCByZWRlZmluaXRpb24u CisgKgorICogV2hlbiBhIHJlZ2lzdGVyIG9yIGEgYml0IChmaWVsZCkgY2hhbmdlcyBmb3IgYSBu ZXcgcGxhdGZvcm0sIHByZWZpeCB0aGUgbmV3CisgKiBtYWNybyB1c2luZyB0aGUgcGxhdGZvcm0g YWNyb255bSBvciBnZW5lcmF0aW9uLiBGb3IgZXhhbXBsZSwgU0tMXyBvcgorICogR0VOOF8uIFRo ZSBwcmVmaXggc2lnbmlmaWVzIHRoZSBzdGFydCBwbGF0Zm9ybS9nZW5lcmF0aW9uIG9mIHRoZSBy ZWdpc3Rlci4KKyAqCisgKiBFWEFNUExFCisgKgorICogI2RlZmluZSBfRk9PX0EJCQkweGYwMDAK KyAqICNkZWZpbmUgX0ZPT19CCQkJMHhmMDAxCisgKiAjZGVmaW5lIEZPTyhwaXBlKQkJCV9NTUlP X1BJUEUocGlwZSwgX0ZPT19BLCBfRk9PX0IpCisgKiAjZGVmaW5lICAgRk9PX0VOQUJMRQkJCSgx IDw8IDMxKQorICogI2RlZmluZSAgIEZPT19NT0RFX01BU0sJCSgweGYgPDwgMTYpCisgKiAjZGVm aW5lICAgRk9PX01PREVfU0hJRlQJCTE2CisgKiAjZGVmaW5lICAgRk9PX01PREVfQkFSCQkoMCA8 PCAxNikKKyAqICNkZWZpbmUgICBGT09fTU9ERV9CQVoJCSgxIDw8IDE2KQorICogI2RlZmluZSAg IEdFTjZfRk9PX01PREVfUVVYCQkoMiA8PCAxNikKKyAqCisgKi8KKwogdHlwZWRlZiBzdHJ1Y3Qg ewogCXVpbnQzMl90IHJlZzsKIH0gaTkxNV9yZWdfdDsKLS0gCjIuMTEuMAoKX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX18KSW50ZWwtZ2Z4IG1haWxpbmcgbGlz dApJbnRlbC1nZnhAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMuZnJlZWRlc2t0 b3Aub3JnL21haWxtYW4vbGlzdGluZm8vaW50ZWwtZ2Z4Cg==