From mboxrd@z Thu Jan  1 00:00:00 1970
From: Daniel Vetter <daniel@ffwll.ch>
Subject: Re: [PATCH 14/17] drm/cma-helpers: Use recommened kerneldoc for
 struct member refs
Date: Fri, 30 Dec 2016 18:00:29 +0100
Message-ID: <20161230170029.GH8712@dvetter-linux.ger.corp.intel.com>
References: <1483044517-5770-1-git-send-email-daniel.vetter@ffwll.ch>
 <1483044517-5770-14-git-send-email-daniel.vetter@ffwll.ch>
 <2513152.97G8Rvu2cr@avalon>
Mime-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Return-path: <dri-devel-bounces@lists.freedesktop.org>
Content-Disposition: inline
In-Reply-To: <2513152.97G8Rvu2cr@avalon>
List-Unsubscribe: <https://lists.freedesktop.org/mailman/options/dri-devel>,
 <mailto:dri-devel-request@lists.freedesktop.org?subject=unsubscribe>
List-Archive: <https://lists.freedesktop.org/archives/dri-devel>
List-Post: <mailto:dri-devel@lists.freedesktop.org>
List-Help: <mailto:dri-devel-request@lists.freedesktop.org?subject=help>
List-Subscribe: <https://lists.freedesktop.org/mailman/listinfo/dri-devel>,
 <mailto:dri-devel-request@lists.freedesktop.org?subject=subscribe>
Errors-To: dri-devel-bounces@lists.freedesktop.org
Sender: "dri-devel" <dri-devel-bounces@lists.freedesktop.org>
To: Laurent Pinchart <laurent.pinchart@ideasonboard.com>
Cc: Daniel Vetter <daniel.vetter@ffwll.ch>, Intel Graphics Development <intel-gfx@lists.freedesktop.org>, DRI Development <dri-devel@lists.freedesktop.org>, Daniel Vetter <daniel.vetter@intel.com>
List-Id: intel-gfx@lists.freedesktop.org

T24gRnJpLCBEZWMgMzAsIDIwMTYgYXQgMDQ6MTE6NDRQTSArMDIwMCwgTGF1cmVudCBQaW5jaGFy
dCB3cm90ZToKPiBIaSBEYW5pZWwsCj4gCj4gVGhhbmsgeW91IGZvciB0aGUgcGF0Y2guCj4gCj4g
T24gVGh1cnNkYXkgMjkgRGVjIDIwMTYgMjE6NDg6MzQgRGFuaWVsIFZldHRlciB3cm90ZToKPiA+
IEkganVzdCBsZWFybmVkIHRoYXQgJnN0cnVjdF9uYW1lLm1lbWJlcl9uYW1lIHdvcmtzIGFuZCBs
b29rcyBwcmV0dHkKPiA+IGV2ZW4uIEl0IGRvZXNuJ3QgKHlldCkgbGluayB0byB0aGUgbWVtYmVy
IGRpcmVjdGx5IHRob3VnaCwgd2hpY2ggd291bGQKPiA+IGJlIHJlYWxseSBnb29kIGZvciBiaWcg
c3RydWN0dXJlcyBvciB2ZnVuYyB0YWJsZXMgKHdoZXJlIHRoZQo+ID4gcGVyLW1lbWJlciBrZXJu
ZWxkb2MgdGVuZHMgdG8gYmUgbG9uZykuCj4gPiAKPiA+IEFsc28gc29tZSBtaW5vciBkcml2ZS1i
eSBwb2xpc2ggd2hlcmUgaXQgbWFrZXMgc2Vuc2UsIEkgcmVhZCBhIGxvdAo+ID4gb2YgZG9jcyAu
Li4KPiA+IAo+ID4gQ2M6IExhdXJlbnQgUGluY2hhcnQgPExhdXJlbnQucGluY2hhcnRAaWRlYXNv
bmJvYXJkLmNvbT4KPiA+IENjOiBKYW5pIE5pa3VsYSA8amFuaS5uaWt1bGFAbGludXguaW50ZWwu
Y29tPgo+ID4gQ2M6IENocmlzIFdpbHNvbiA8Y2hyaXNAY2hyaXMtd2lsc29uLmNvLnVrPgo+ID4g
U2lnbmVkLW9mZi1ieTogRGFuaWVsIFZldHRlciA8ZGFuaWVsLnZldHRlckBpbnRlbC5jb20+Cj4g
PiAtLS0KPiA+ICBkcml2ZXJzL2dwdS9kcm0vZHJtX2ZiX2NtYV9oZWxwZXIuYyAgfCAyNCArKysr
KysrKysrKystLS0tLS0tLS0tLS0KPiA+ICBkcml2ZXJzL2dwdS9kcm0vZHJtX2dlbV9jbWFfaGVs
cGVyLmMgfCAxNiArKysrKysrKy0tLS0tLS0tCj4gPiAgMiBmaWxlcyBjaGFuZ2VkLCAyMCBpbnNl
cnRpb25zKCspLCAyMCBkZWxldGlvbnMoLSkKPiA+IAo+ID4gZGlmZiAtLWdpdCBhL2RyaXZlcnMv
Z3B1L2RybS9kcm1fZmJfY21hX2hlbHBlci5jCj4gPiBiL2RyaXZlcnMvZ3B1L2RybS9kcm1fZmJf
Y21hX2hlbHBlci5jIGluZGV4IGVjMDgxNzI3Y2Q1YS4uMGEwYWM3N2I0NjRiCj4gPiAxMDA2NDQK
PiA+IC0tLSBhL2RyaXZlcnMvZ3B1L2RybS9kcm1fZmJfY21hX2hlbHBlci5jCj4gPiArKysgYi9k
cml2ZXJzL2dwdS9kcm0vZHJtX2ZiX2NtYV9oZWxwZXIuYwo+ID4gQEAgLTQ4LDE0ICs0OCwxNCBA
QCBzdHJ1Y3QgZHJtX2ZiZGV2X2NtYSB7Cj4gPiAgICogUHJvdmlkZXMgaGVscGVyIGZ1bmN0aW9u
cyBmb3IgY3JlYXRpbmcgYSBjbWEgKGNvbnRpZ3VvdXMgbWVtb3J5Cj4gPiBhbGxvY2F0b3IpCj4g
PiAgICogYmFja2VkIGZyYW1lYnVmZmVyLgo+ID4gICAqCj4gPiAtICogZHJtX2ZiX2NtYV9jcmVh
dGUoKSBpcyB1c2VkIGluIHRoZSAmZHJtX21vZGVfY29uZmlnX2Z1bmNzIC0+ZmJfY3JlYXRlCj4g
PiArICogZHJtX2ZiX2NtYV9jcmVhdGUoKSBpcyB1c2VkIGluIHRoZSAmZHJtX21vZGVfY29uZmln
X2Z1bmNzLmZiX2NyZWF0ZQo+ID4gICAqIGNhbGxiYWNrIGZ1bmN0aW9uIHRvIGNyZWF0ZSBhIGNt
YSBiYWNrZWQgZnJhbWVidWZmZXIuCj4gPiAgICoKPiA+ICAgKiBBbiBmYmRldiBmcmFtZWJ1ZmZl
ciBiYWNrZWQgYnkgY21hIGlzIGFsc28gYXZhaWxhYmxlIGJ5IGNhbGxpbmcKPiA+ICAgKiBkcm1f
ZmJkZXZfY21hX2luaXQoKS4gZHJtX2ZiZGV2X2NtYV9maW5pKCkgdGVhcnMgaXQgZG93bi4KPiA+
IC0gKiBJZiB0aGUgJmRybV9mcmFtZWJ1ZmZlcl9mdW5jcyAtPmRpcnR5IGNhbGxiYWNrIGlzIHNl
dCwgZmJfZGVmZXJyZWRfaW8KPiA+IC0gKiB3aWxsIGJlIHNldCB1cCBhdXRvbWF0aWNhbGx5LiBk
aXJ0eSgpIGlzIGNhbGxlZCBieQo+ID4gLSAqIGRybV9mYl9oZWxwZXJfZGVmZXJyZWRfaW8oKSBp
biBwcm9jZXNzIGNvbnRleHQgKHN0cnVjdCBkZWxheWVkX3dvcmspLgo+ID4gKyAqIElmIHRoZSAm
ZHJtX2ZyYW1lYnVmZmVyX2Z1bmNzLmRpcnR5IGNhbGxiYWNrIGlzIHNldCwgZmJfZGVmZXJyZWRf
aW8gd2lsbAo+ID4gYmUKPiA+ICsgKiBzZXQgdXAgYXV0b21hdGljYWxseS4gJmRybV9mcmFtZWJ1
ZmZlcl9mdW5jcy5kaXJ0eSBpcyBjYWxsZWQgYnkKPiA+ICsgKiBkcm1fZmJfaGVscGVyX2RlZmVy
cmVkX2lvKCkgaW4gcHJvY2VzcyBjb250ZXh0ICgmc3RydWN0IGRlbGF5ZWRfd29yaykuCj4gPiAg
ICoKPiA+ICAgKiBFeGFtcGxlIGZiZGV2IGRlZmVycmVkIGlvIGNvZGU6Ogo+ID4gICAqCj4gPiBA
QCAtMTU1LDE2ICsxNTUsMTYgQEAgc3RhdGljIHN0cnVjdCBkcm1fZmJfY21hICpkcm1fZmJfY21h
X2FsbG9jKHN0cnVjdAo+ID4gZHJtX2RldmljZSAqZGV2LAo+ID4gCj4gPiAgLyoqCj4gPiAgICog
ZHJtX2ZiX2NtYV9jcmVhdGVfd2l0aF9mdW5jcygpIC0gaGVscGVyIGZ1bmN0aW9uIGZvciB0aGUK
PiA+IC0gKiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAmZHJtX21vZGVfY29uZmln
X2Z1bmNzIC0+ZmJfY3JlYXRlCj4gPiAtICogICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
ICAgY2FsbGJhY2sgZnVuY3Rpb24KPiA+ICsgKiAgICAgICAgICAgICAgICAgICAgICAgICAgICAg
ICAgICAmZHJtX21vZGVfY29uZmlnX2Z1bmNzLmZiX2NyZWF0ZQo+ID4gKyAqICAgICAgICAgICAg
ICAgICAgICAgICAgICAgICAgICAgIGNhbGxiYWNrCj4gPiAgICogQGRldjogRFJNIGRldmljZQo+
ID4gICAqIEBmaWxlX3ByaXY6IGRybSBmaWxlIGZvciB0aGUgaW9jdGwgY2FsbAo+ID4gICAqIEBt
b2RlX2NtZDogbWV0YWRhdGEgZnJvbSB0aGUgdXNlcnNwYWNlIGZiIGNyZWF0aW9uIHJlcXVlc3QK
PiA+ICAgKiBAZnVuY3M6IHZ0YWJsZSB0byBiZSB1c2VkIGZvciB0aGUgbmV3IGZyYW1lYnVmZmVy
IG9iamVjdAo+ID4gICAqCj4gPiAgICogVGhpcyBjYW4gYmUgdXNlZCB0byBzZXQgJmRybV9mcmFt
ZWJ1ZmZlcl9mdW5jcyBmb3IgZHJpdmVycyB0aGF0IG5lZWQgdGhlCj4gPiAtICogZGlydHkoKSBj
YWxsYmFjay4gVXNlIGRybV9mYl9jbWFfY3JlYXRlKCkgaWYgeW91IGRvbid0IG5lZWQgdG8gY2hh
bmdlCj4gPiAtICogJmRybV9mcmFtZWJ1ZmZlcl9mdW5jcy4KPiA+ICsgKiAmZHJtX2ZyYW1lYnVm
ZmVyX2Z1bmNzLmRpcnR5IGNhbGxiYWNrLiBVc2UgZHJtX2ZiX2NtYV9jcmVhdGUoKSBpZiB5b3UK
PiA+IGRvbid0Cj4gPiArICogbmVlZCB0byBjaGFuZ2UgJmRybV9mcmFtZWJ1ZmZlcl9mdW5jcy4K
PiA+ICAgKi8KPiA+ICBzdHJ1Y3QgZHJtX2ZyYW1lYnVmZmVyICpkcm1fZmJfY21hX2NyZWF0ZV93
aXRoX2Z1bmNzKHN0cnVjdCBkcm1fZGV2aWNlCj4gPiAqZGV2LCBzdHJ1Y3QgZHJtX2ZpbGUgKmZp
bGVfcHJpdiwgY29uc3Qgc3RydWN0IGRybV9tb2RlX2ZiX2NtZDIgKm1vZGVfY21kLAo+ID4gQEAg
LTIyMSwxNCArMjIxLDE0IEBAIHN0cnVjdCBkcm1fZnJhbWVidWZmZXIKPiA+ICpkcm1fZmJfY21h
X2NyZWF0ZV93aXRoX2Z1bmNzKHN0cnVjdCBkcm1fZGV2aWNlICpkZXYsCj4gPiBFWFBPUlRfU1lN
Qk9MX0dQTChkcm1fZmJfY21hX2NyZWF0ZV93aXRoX2Z1bmNzKTsKPiA+IAo+ID4gIC8qKgo+ID4g
LSAqIGRybV9mYl9jbWFfY3JlYXRlKCkgLSAmZHJtX21vZGVfY29uZmlnX2Z1bmNzIC0+ZmJfY3Jl
YXRlIGNhbGxiYWNrCj4gPiBmdW5jdGlvbgo+ID4gKyAqIGRybV9mYl9jbWFfY3JlYXRlKCkgLSAm
ZHJtX21vZGVfY29uZmlnX2Z1bmNzLmZiX2NyZWF0ZSBjYWxsYmFjayBmdW5jdGlvbgo+ID4gICAq
IEBkZXY6IERSTSBkZXZpY2UKPiA+ICAgKiBAZmlsZV9wcml2OiBkcm0gZmlsZSBmb3IgdGhlIGlv
Y3RsIGNhbGwKPiA+ICAgKiBAbW9kZV9jbWQ6IG1ldGFkYXRhIGZyb20gdGhlIHVzZXJzcGFjZSBm
YiBjcmVhdGlvbiByZXF1ZXN0Cj4gPiAgICoKPiA+ICAgKiBJZiB5b3VyIGhhcmR3YXJlIGhhcyBz
cGVjaWFsIGFsaWdubWVudCBvciBwaXRjaCByZXF1aXJlbWVudHMgdGhlc2UgCj4gPiBzaG91bGQg
YmUKPiA+ICAgKiBjaGVja2VkIGJlZm9yZSBjYWxsaW5nIHRoaXMgZnVuY3Rpb24uIFVzZSBkcm1f
ZmJfY21hX2NyZWF0ZV93aXRoX2Z1bmNzKCkKPiA+IGlmCj4gPiAtICogeW91IG5lZWQgdG8gc2V0
ICZkcm1fZnJhbWVidWZmZXJfZnVuY3MgLT5kaXJ0eS4KPiA+ICsgKiB5b3UgbmVlZCB0byBzZXQg
JmRybV9mcmFtZWJ1ZmZlcl9mdW5jcy5kaXJ0eS4KPiA+ICAgKi8KPiA+ICBzdHJ1Y3QgZHJtX2Zy
YW1lYnVmZmVyICpkcm1fZmJfY21hX2NyZWF0ZShzdHJ1Y3QgZHJtX2RldmljZSAqZGV2LAo+ID4g
IAlzdHJ1Y3QgZHJtX2ZpbGUgKmZpbGVfcHJpdiwgY29uc3Qgc3RydWN0IGRybV9tb2RlX2ZiX2Nt
ZDIgKm1vZGVfY21kKQo+ID4gQEAgLTI2NCw3ICsyNjQsNyBAQCBFWFBPUlRfU1lNQk9MX0dQTChk
cm1fZmJfY21hX2dldF9nZW1fb2JqKTsKPiA+ICAgKiBAcGxhbmU6IFdoaWNoIHBsYW5lCj4gPiAg
ICogQHN0YXRlOiBQbGFuZSBzdGF0ZSBhdHRhY2ggZmVuY2UgdG8KPiA+ICAgKgo+ID4gLSAqIFRo
aXMgc2hvdWxkIGJlIHB1dCBpbnRvIHByZXBhcmVfZmIgaG9vayBvZiAmc3RydWN0Cj4gPiBkcm1f
cGxhbmVfaGVscGVyX2Z1bmNzIC4KPiA+ICsgKiBUaGlzIHNob3VsZCBiZSBzZXQgYXMgdGhlICZz
dHJ1Y3QgZHJtX3BsYW5lX2hlbHBlcl9mdW5jcy5wcmVwYXJlX2ZiCj4gPiBob29rLgo+ID4gICAq
Cj4gPiAgICogVGhpcyBmdW5jdGlvbiBjaGVja3MgaWYgdGhlIHBsYW5lIEZCIGhhcyBhbiBkbWEt
YnVmIGF0dGFjaGVkLCBleHRyYWN0cwo+ID4gICAqIHRoZSBleGNsdXNpdmUgZmVuY2UgYW5kIGF0
dGFjaGVzIGl0IHRvIHBsYW5lIHN0YXRlIGZvciB0aGUgYXRvbWljIGhlbHBlcgo+ID4gQEAgLTQ5
MSw3ICs0OTEsNyBAQCBzdGF0aWMgY29uc3Qgc3RydWN0IGRybV9mYl9oZWxwZXJfZnVuY3MKPiA+
IGRybV9mYl9jbWFfaGVscGVyX2Z1bmNzID0geyAqIEBwcmVmZXJyZWRfYnBwOiBQcmVmZXJyZWQg
Yml0cyBwZXIgcGl4ZWwgZm9yCj4gPiB0aGUgZGV2aWNlCj4gPiAgICogQG51bV9jcnRjOiBOdW1i
ZXIgb2YgQ1JUQ3MKPiA+ICAgKiBAbWF4X2Nvbm5fY291bnQ6IE1heGltdW0gbnVtYmVyIG9mIGNv
bm5lY3RvcnMKPiA+IC0gKiBAZnVuY3M6IGZiIGhlbHBlciBmdW5jdGlvbnMsIGluIHBhcnRpY3Vs
YXIgZmJfcHJvYmUoKQo+ID4gKyAqIEBmdW5jczogZmIgaGVscGVyIGZ1bmN0aW9ucywgaW4gcGFy
dGljdWxhciBhIGN1c3RvbSBkaXJ0eSgpIGNhbGxiYWNrCj4gCj4gRG9lc24ndCB0aGlzIGJlbG9u
ZyB0byBhIGRpZmZlcmVudCBwYXRjaCA/CgoKWXVwLCB0aGF0IHNob3VkbCBoYXZlIGJlZW4gaW4g
dGhlIHByZXZpb3VzIGNtYSBwYXRjaC4gSSBtb3ZlZCBpdCB3aGlsZQphcHBseWluZy4KCj4gCj4g
PiAgICogUmV0dXJucyBhIG5ld2x5IGFsbG9jYXRlZCBkcm1fZmJkZXZfY21hIHN0cnVjdCBvciBh
IEVSUl9QVFIuCj4gPiAgICovCj4gPiBkaWZmIC0tZ2l0IGEvZHJpdmVycy9ncHUvZHJtL2RybV9n
ZW1fY21hX2hlbHBlci5jCj4gPiBiL2RyaXZlcnMvZ3B1L2RybS9kcm1fZ2VtX2NtYV9oZWxwZXIu
YyBpbmRleCAxZDZjMzM1NTg0ZWMuLjZlYzJkODA5NmIyYwo+ID4gMTAwNjQ0Cj4gPiAtLS0gYS9k
cml2ZXJzL2dwdS9kcm0vZHJtX2dlbV9jbWFfaGVscGVyLmMKPiA+ICsrKyBiL2RyaXZlcnMvZ3B1
L2RybS9kcm1fZ2VtX2NtYV9oZWxwZXIuYwo+ID4gQEAgLTE3Nyw3ICsxNzcsNyBAQCBkcm1fZ2Vt
X2NtYV9jcmVhdGVfd2l0aF9oYW5kbGUoc3RydWN0IGRybV9maWxlCj4gPiAqZmlsZV9wcml2LAo+
ID4gICAqIFRoaXMgZnVuY3Rpb24gZnJlZXMgdGhlIGJhY2tpbmcgbWVtb3J5IG9mIHRoZSBDTUEg
R0VNIG9iamVjdCwgY2xlYW5zIHVwCj4gPiB0aGUKPiA+ICAgKiBHRU0gb2JqZWN0IHN0YXRlIGFu
ZCBmcmVlcyB0aGUgbWVtb3J5IHVzZWQgdG8gc3RvcmUgdGhlIG9iamVjdCBpdHNlbGYuCj4gPiAg
ICogRHJpdmVycyB1c2luZyB0aGUgQ01BIGhlbHBlcnMgc2hvdWxkIHNldCB0aGlzIGFzIHRoZWly
IERSTSBkcml2ZXIncwo+ID4gLSAqIC0+Z2VtX2ZyZWVfb2JqZWN0KCkgY2FsbGJhY2suCj4gPiAr
ICogJmRybV9kcml2ZXIuZ2VtX2ZyZWVfb2JqZWN0IGNhbGxiYWNrLgo+IAo+IEhvdyBhYm91dCBz
L0RSTSBkcml2ZXIncyAvLyBoZXJlIGFuZCBiZWxvdyA/IEl0J3Mga2luZCBvZiByZWR1bmRhbnQg
bm93IHRoYXQgCj4geW91IHJlZmVyZW5jZSBkcm1fZHJpdmVyIGRpcmVjdGx5LCBhbmQgc29tZSBv
ZiB0aGUgZnVuY3Rpb25zIGFscmVhZHkgZG9uJ3QgCj4gbWVudGlvbiAiRFJNIGRyaXZlcidzIiBp
biB0aGVpciBkb2N1bWVudGF0aW9uLgoKWWVhaCwgZ29vZCBpZGVhLiBJIGRpZCB0aGF0IHdoaWxl
IGFwcGx5aW5nLCBhbmQgaW4gZG9pbmcgc28gbm90aWNlZCAzIG1vcmUKY2FzZXMgd2hlcmUgd2Ug
Y2FuIHJlcGxhY2UgYSBwcm9zZSByZWZlcmVuY2Ugd2l0aCBhIHByb3BlciBvbmUuCgo+IEFwYXJ0
IGZyb20gdGhhdCwKPiAKPiBSZXZpZXdlZC1ieTogTGF1cmVudCBQaW5jaGFydCA8bGF1cmVudC5w
aW5jaGFydEBpZGVhc29uYm9hcmQuY29tPgoKVGhhbmtzIGZvciB0aGUgcmV2aWV3LCBib3RoIGNt
YSBwYXRjaGVzIGFwcGxpZWQuCi1EYW5pZWwKLS0gCkRhbmllbCBWZXR0ZXIKU29mdHdhcmUgRW5n
aW5lZXIsIEludGVsIENvcnBvcmF0aW9uCmh0dHA6Ly9ibG9nLmZmd2xsLmNoCl9fX19fX19fX19f
X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1kZXZlbCBtYWlsaW5nIGxp
c3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwczovL2xpc3RzLmZyZWVkZXNr
dG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2RyaS1kZXZlbAo=