From: Eric Anholt Subject: [PATCH 1/4] drm/vc4: Convert existing documentation to actual kerneldoc. Date: Mon, 27 Feb 2017 12:11:41 -0800 Message-ID: <20170227201144.10970-2-eric@anholt.net> References: <20170227201144.10970-1-eric@anholt.net> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from anholt.net (anholt.net [50.246.234.109]) by gabe.freedesktop.org (Postfix) with ESMTP id 2F3F56E586 for ; Mon, 27 Feb 2017 20:11:51 +0000 (UTC) In-Reply-To: <20170227201144.10970-1-eric@anholt.net> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: dri-devel@lists.freedesktop.org Cc: linux-kernel@vger.kernel.org List-Id: dri-devel@lists.freedesktop.org SSdtIGdvaW5nIHRvIGhvb2sgdmM0IHVwIHRvIHRoZSBzcGhpbnggYnVpbGQsIHNvIGNsZWFuIHVw IGl0cyBjb21tZW50cwp0byBub3QgZ2VuZXJhdGUgd2FybmluZ3Mgd2hlbiB3ZSBkby4KClNpZ25l ZC1vZmYtYnk6IEVyaWMgQW5ob2x0IDxlcmljQGFuaG9sdC5uZXQ+Ci0tLQogZHJpdmVycy9ncHUv ZHJtL3ZjNC92YzRfYm8uYyAgICAgICB8ICA1ICsrKystCiBkcml2ZXJzL2dwdS9kcm0vdmM0L3Zj NF9kc2kuYyAgICAgIHwgIDUgKysrLS0KIGRyaXZlcnMvZ3B1L2RybS92YzQvdmM0X2dlbS5jICAg ICAgfCAyNiArKysrKysrKysrKysrKysrKysrKystLS0tLQogZHJpdmVycy9ncHUvZHJtL3ZjNC92 YzRfaXJxLmMgICAgICB8ICAzICsrLQogZHJpdmVycy9ncHUvZHJtL3ZjNC92YzRfdmFsaWRhdGUu YyB8IDEwICsrKysrKystLS0KIDUgZmlsZXMgY2hhbmdlZCwgMzcgaW5zZXJ0aW9ucygrKSwgMTIg ZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEvZHJpdmVycy9ncHUvZHJtL3ZjNC92YzRfYm8uYyBi L2RyaXZlcnMvZ3B1L2RybS92YzQvdmM0X2JvLmMKaW5kZXggM2Y2NzA0Y2Y2NjA4Li43YWJjZDlj NWRiZTIgMTAwNjQ0Ci0tLSBhL2RyaXZlcnMvZ3B1L2RybS92YzQvdmM0X2JvLmMKKysrIGIvZHJp dmVycy9ncHUvZHJtL3ZjNC92YzRfYm8uYwpAQCAtNiw3ICs2LDggQEAKICAqIHB1Ymxpc2hlZCBi eSB0aGUgRnJlZSBTb2Z0d2FyZSBGb3VuZGF0aW9uLgogICovCiAKLS8qIERPQzogVkM0IEdFTSBC TyBtYW5hZ2VtZW50IHN1cHBvcnQuCisvKioKKyAqIERPQzogVkM0IEdFTSBCTyBtYW5hZ2VtZW50 IHN1cHBvcnQKICAqCiAgKiBUaGUgVkM0IEdQVSBhcmNoaXRlY3R1cmUgKGJvdGggc2Nhbm91dCBh bmQgcmVuZGVyaW5nKSBoYXMgZGlyZWN0CiAgKiBhY2Nlc3MgdG8gc3lzdGVtIG1lbW9yeSB3aXRo IG5vIE1NVSBpbiBiZXR3ZWVuLiAgVG8gc3VwcG9ydCBpdCwgd2UKQEAgLTE4Niw2ICsxODcsOCBA QCBzdGF0aWMgc3RydWN0IHZjNF9ibyAqdmM0X2JvX2dldF9mcm9tX2NhY2hlKHN0cnVjdCBkcm1f ZGV2aWNlICpkZXYsCiAKIC8qKgogICogdmM0X2dlbV9jcmVhdGVfb2JqZWN0IC0gSW1wbGVtZW50 YXRpb24gb2YgZHJpdmVyLT5nZW1fY3JlYXRlX29iamVjdC4KKyAqIEBkZXY6IERSTSBkZXZpY2UK KyAqIEBzaXplOiBTaXplIGluIGJ5dGVzIG9mIHRoZSBtZW1vcnkgdGhlIG9iamVjdCB3aWxsIHJl ZmVyZW5jZQogICoKICAqIFRoaXMgbGV0cyB0aGUgQ01BIGhlbHBlcnMgYWxsb2NhdGUgb2JqZWN0 IHN0cnVjdHMgZm9yIHVzLCBhbmQga2VlcAogICogb3VyIEJPIHN0YXRzIGNvcnJlY3QuCmRpZmYg LS1naXQgYS9kcml2ZXJzL2dwdS9kcm0vdmM0L3ZjNF9kc2kuYyBiL2RyaXZlcnMvZ3B1L2RybS92 YzQvdmM0X2RzaS5jCmluZGV4IGUzMjhjYjg2NDY5Yy4uMTYwZjk4MWQxY2Y0IDEwMDY0NAotLS0g YS9kcml2ZXJzL2dwdS9kcm0vdmM0L3ZjNF9kc2kuYworKysgYi9kcml2ZXJzL2dwdS9kcm0vdmM0 L3ZjNF9kc2kuYwpAQCAtMTQ1Myw4ICsxNDUzLDkgQEAgc3RhdGljIGlycXJldHVybl90IHZjNF9k c2lfaXJxX2hhbmRsZXIoaW50IGlycSwgdm9pZCAqZGF0YSkKIH0KIAogLyoqCi0gKiBFeHBvc2Vz IGNsb2NrcyBnZW5lcmF0ZWQgYnkgdGhlIGFuYWxvZyBQSFkgdGhhdCBhcmUgY29uc3VtZWQgYnkK LSAqIENQUk1BTiAoY2xrLWJjbTI4MzUuYykuCisgKiB2YzRfZHNpX2luaXRfcGh5X2Nsb2NrcyAt IEV4cG9zZXMgY2xvY2tzIGdlbmVyYXRlZCBieSB0aGUgYW5hbG9nCisgKiBQSFkgdGhhdCBhcmUg Y29uc3VtZWQgYnkgQ1BSTUFOIChjbGstYmNtMjgzNS5jKS4KKyAqIEBkc2k6IERTSSBlbmNvZGVy CiAgKi8KIHN0YXRpYyBpbnQKIHZjNF9kc2lfaW5pdF9waHlfY2xvY2tzKHN0cnVjdCB2YzRfZHNp ICpkc2kpCmRpZmYgLS1naXQgYS9kcml2ZXJzL2dwdS9kcm0vdmM0L3ZjNF9nZW0uYyBiL2RyaXZl cnMvZ3B1L2RybS92YzQvdmM0X2dlbS5jCmluZGV4IGRiOTIwNzcxYmZiNS4uNzlmMDA5OWQxN2Qw IDEwMDY0NAotLS0gYS9kcml2ZXJzL2dwdS9kcm0vdmM0L3ZjNF9nZW0uYworKysgYi9kcml2ZXJz L2dwdS9kcm0vdmM0L3ZjNF9nZW0uYwpAQCAtNTExLDkgKzUxMSwxOCBAQCB2YzRfcXVldWVfc3Vi bWl0KHN0cnVjdCBkcm1fZGV2aWNlICpkZXYsIHN0cnVjdCB2YzRfZXhlY19pbmZvICpleGVjKQog fQogCiAvKioKLSAqIExvb2tzIHVwIGEgYnVuY2ggb2YgR0VNIGhhbmRsZXMgZm9yIEJPcyBhbmQg c3RvcmVzIHRoZSBhcnJheSBmb3IKLSAqIHVzZSBpbiB0aGUgY29tbWFuZCB2YWxpZGF0b3IgdGhh dCBhY3R1YWxseSB3cml0ZXMgcmVsb2NhdGVkCi0gKiBhZGRyZXNzZXMgcG9pbnRpbmcgdG8gdGhl bS4KKyAqIHZjNF9jbF9sb29rdXBfYm9zKCkgLSBTZXRzIHVwIGV4ZWMtPmJvW10gd2l0aCB0aGUg R0VNIG9iamVjdHMKKyAqIHJlZmVyZW5jZWQgYnkgdGhlIGpvYi4KKyAqIEBkZXY6IERSTSBkZXZp Y2UKKyAqIEBmaWxlX3ByaXY6IERSTSBmaWxlIGZvciB0aGlzIGZkCisgKiBAZXhlYzogVjNEIGpv YiBiZWluZyBzZXQgdXAKKyAqCisgKiBUaGUgY29tbWFuZCB2YWxpZGF0b3IgbmVlZHMgdG8gcmVm ZXJlbmNlIEJPcyBieSB0aGVpciBpbmRleCB3aXRoaW4KKyAqIHRoZSBzdWJtaXR0ZWQgam9iJ3Mg Qk8gbGlzdC4gIFRoaXMgZG9lcyB0aGUgdmFsaWRhdGlvbiBvZiB0aGUgam9iJ3MKKyAqIEJPIGxp c3QgYW5kIHJlZmVyZW5jZSBjb3VudGluZyBmb3IgdGhlIGxpZmV0aW1lIG9mIHRoZSBqb2IuCisg KgorICogTm90ZSB0aGF0IHRoaXMgZnVuY3Rpb24gZG9lc24ndCBuZWVkIHRvIHVucmVmZXJlbmNl IHRoZSBCT3Mgb24KKyAqIGZhaWx1cmUsIGJlY2F1c2UgdGhhdCB3aWxsIGhhcHBlbiBhdCB2YzRf Y29tcGxldGVfZXhlYygpIHRpbWUuCiAgKi8KIHN0YXRpYyBpbnQKIHZjNF9jbF9sb29rdXBfYm9z KHN0cnVjdCBkcm1fZGV2aWNlICpkZXYsCkBAIC04NDQsOSArODUzLDE2IEBAIHZjNF93YWl0X2Jv X2lvY3RsKHN0cnVjdCBkcm1fZGV2aWNlICpkZXYsIHZvaWQgKmRhdGEsCiB9CiAKIC8qKgotICog U3VibWl0cyBhIGNvbW1hbmQgbGlzdCB0byB0aGUgVkM0LgorICogdmM0X3N1Ym1pdF9jbF9pb2N0 bCgpIC0gU3VibWl0cyBhIGpvYiAoZnJhbWUpIHRvIHRoZSBWQzQuCisgKiBAZGV2OiBEUk0gZGV2 aWNlCisgKiBAZGF0YTogaW9jdGwgYXJndW1lbnQKKyAqIEBmaWxlX3ByaXY6IERSTSBmaWxlIGZv ciB0aGlzIGZkCiAgKgotICogVGhpcyBpcyB3aGF0IGlzIGNhbGxlZCBiYXRjaGJ1ZmZlciBlbWl0 dGluZyBvbiBvdGhlciBoYXJkd2FyZS4KKyAqIFRoaXMgaXMgdGhlIG1haW4gZW50cnlwb2ludCBm b3IgdXNlcnNwYWNlIHRvIHN1Ym1pdCBhIDNEIGZyYW1lIHRvCisgKiB0aGUgR1BVLiAgVXNlcnNw YWNlIHByb3ZpZGVzIHRoZSBiaW5uZXIgY29tbWFuZCBsaXN0IChpZgorICogYXBwbGljYWJsZSks IGFuZCB0aGUga2VybmVsIHNldHMgdXAgdGhlIHJlbmRlciBjb21tYW5kIGxpc3QgdG8gZHJhdwor ICogdG8gdGhlIGZyYW1lYnVmZmVyIGRlc2NyaWJlZCBpbiB0aGUgaW9jdGwsIHVzaW5nIHRoZSBj b21tYW5kIGxpc3RzCisgKiB0aGF0IHRoZSAzRCBlbmdpbmUncyBiaW5uZXIgd2lsbCBwcm9kdWNl LgogICovCiBpbnQKIHZjNF9zdWJtaXRfY2xfaW9jdGwoc3RydWN0IGRybV9kZXZpY2UgKmRldiwg dm9pZCAqZGF0YSwKZGlmZiAtLWdpdCBhL2RyaXZlcnMvZ3B1L2RybS92YzQvdmM0X2lycS5jIGIv ZHJpdmVycy9ncHUvZHJtL3ZjNC92YzRfaXJxLmMKaW5kZXggMDk0YmM2YTQ3NWMxLi5jZGM2ZTY3 NjA3MDUgMTAwNjQ0Ci0tLSBhL2RyaXZlcnMvZ3B1L2RybS92YzQvdmM0X2lycS5jCisrKyBiL2Ry aXZlcnMvZ3B1L2RybS92YzQvdmM0X2lycS5jCkBAIC0yMSw3ICsyMSw4IEBACiAgKiBJTiBUSEUg U09GVFdBUkUuCiAgKi8KIAotLyoqIERPQzogSW50ZXJydXB0IG1hbmFnZW1lbnQgZm9yIHRoZSBW M0QgZW5naW5lLgorLyoqCisgKiBET0M6IEludGVycnVwdCBtYW5hZ2VtZW50IGZvciB0aGUgVjNE IGVuZ2luZQogICoKICAqIFdlIGhhdmUgYW4gaW50ZXJydXB0IHN0YXR1cyByZWdpc3RlciAoVjNE X0lOVENUTCkgd2hpY2ggcmVwb3J0cwogICogaW50ZXJydXB0cywgYW5kIHdoZXJlIHdyaXRpbmcg MSBiaXRzIGNsZWFycyB0aG9zZSBpbnRlcnJ1cHRzLgpkaWZmIC0tZ2l0IGEvZHJpdmVycy9ncHUv ZHJtL3ZjNC92YzRfdmFsaWRhdGUuYyBiL2RyaXZlcnMvZ3B1L2RybS92YzQvdmM0X3ZhbGlkYXRl LmMKaW5kZXggOWZkMTcxYzM2MWMyLi5kNjk2ZWQ0OWU5ZjAgMTAwNjQ0Ci0tLSBhL2RyaXZlcnMv Z3B1L2RybS92YzQvdmM0X3ZhbGlkYXRlLmMKKysrIGIvZHJpdmVycy9ncHUvZHJtL3ZjNC92YzRf dmFsaWRhdGUuYwpAQCAtMjIsNyArMjIsNyBAQAogICovCiAKIC8qKgotICogQ29tbWFuZCBsaXN0 IHZhbGlkYXRvciBmb3IgVkM0LgorICogRE9DOiBDb21tYW5kIGxpc3QgdmFsaWRhdG9yIGZvciBW QzQuCiAgKgogICogVGhlIFZDNCBoYXMgbm8gSU9NTVUgYmV0d2VlbiBpdCBhbmQgc3lzdGVtIG1l bW9yeS4gIFNvLCBhIHVzZXIgd2l0aAogICogYWNjZXNzIHRvIGV4ZWN1dGUgY29tbWFuZCBsaXN0 cyBjb3VsZCBlc2NhbGF0ZSBwcml2aWxlZ2UgYnkKQEAgLTg0LDggKzg0LDEyIEBAIHV0aWxlX2hl aWdodChpbnQgY3BwKQogfQogCiAvKioKLSAqIFRoZSB0ZXh0dXJlIHVuaXQgZGVjaWRlcyB3aGF0 IHRpbGluZyBmb3JtYXQgYSBwYXJ0aWN1bGFyIG1pcGxldmVsIGlzIHVzaW5nCi0gKiB0aGlzIGZ1 bmN0aW9uLCBzbyB3ZSBsYXkgb3V0IG91ciBtaXB0cmVlcyBhY2NvcmRpbmdseS4KKyAqIHNpemVf aXNfbHQoKSAtIFJldHVybnMgd2hldGhlciBhIG1pcGxldmVsIG9mIHRoZSBnaXZlbiBzaXplIHdp bGwKKyAqIHVzZSB0aGUgbGluZWFydGlsZSAoTFQpIHRpbGluZyBsYXlvdXQgcmF0aGVyIHRoYW4g dGhlIG5vcm1hbCBUCisgKiB0aWxpbmcgbGF5b3V0LgorICogQHdpZHRoOiBXaWR0aCBpbiBwaXhl bHMgb2YgdGhlIG1pcGxldmVsCisgKiBAaGVpZ2h0OiBIZWlnaHQgaW4gcGl4ZWxzIG9mIHRoZSBt aXBsZXZlbAorICogQGNwcDogQnl0ZXMgcGVyIHBpeGVsIG9mIHRoZSBwaXhlbCBmb3JtYXQKICAq Lwogc3RhdGljIGJvb2wKIHNpemVfaXNfbHQodWludDMyX3Qgd2lkdGgsIHVpbnQzMl90IGhlaWdo dCwgaW50IGNwcCkKLS0gCjIuMTEuMAoKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX18KZHJpLWRldmVsIG1haWxpbmcgbGlzdApkcmktZGV2ZWxAbGlzdHMuZnJl ZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGlu Zm8vZHJpLWRldmVsCg==