From mboxrd@z Thu Jan  1 00:00:00 1970
From: Daniel Vetter <daniel@ffwll.ch>
Subject: Re: [PATCH 13/17] drm/bridge: Use recommened kerneldoc for struct
 member refs
Date: Mon, 2 Jan 2017 09:18:11 +0100
Message-ID: <20170102081811.GP8712@dvetter-linux.ger.corp.intel.com>
References: <1483044517-5770-1-git-send-email-daniel.vetter@ffwll.ch>
 <1483044517-5770-13-git-send-email-daniel.vetter@ffwll.ch>
 <d6194188-4aa9-f47e-3433-2b804c90994b@codeaurora.org>
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: <d6194188-4aa9-f47e-3433-2b804c90994b@codeaurora.org>
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: Archit Taneja <architt@codeaurora.org>
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

T24gTW9uLCBKYW4gMDIsIDIwMTcgYXQgMTE6NTM6MDNBTSArMDUzMCwgQXJjaGl0IFRhbmVqYSB3
cm90ZToKPiAKPiAKPiBPbiAxMi8zMC8yMDE2IDI6MTggQU0sIERhbmllbCBWZXR0ZXIgd3JvdGU6
Cj4gPiBJIGp1c3QgbGVhcm5lZCB0aGF0ICZzdHJ1Y3RfbmFtZS5tZW1iZXJfbmFtZSB3b3JrcyBh
bmQgbG9va3MgcHJldHR5Cj4gPiBldmVuLiBJdCBkb2Vzbid0ICh5ZXQpIGxpbmsgdG8gdGhlIG1l
bWJlciBkaXJlY3RseSB0aG91Z2gsIHdoaWNoIHdvdWxkCj4gPiBiZSByZWFsbHkgZ29vZCBmb3Ig
YmlnIHN0cnVjdHVyZXMgb3IgdmZ1bmMgdGFibGVzICh3aGVyZSB0aGUKPiA+IHBlci1tZW1iZXIg
a2VybmVsZG9jIHRlbmRzIHRvIGJlIGxvbmcpLgo+ID4gCj4gPiBBbHNvIHNvbWUgbWlub3IgZHJp
dmUtYnkgcG9saXNoIHdoZXJlIGl0IG1ha2VzIHNlbnNlLCBJIHJlYWQgYSBsb3QKPiA+IG9mIGRv
Y3MgLi4uCj4gPiAKPiA+IENjOiBBcmNoaXQgVGFuZWphIDxhcmNoaXR0QGNvZGVhdXJvcmEub3Jn
Pgo+ID4gQ2M6IEphbmkgTmlrdWxhIDxqYW5pLm5pa3VsYUBsaW51eC5pbnRlbC5jb20+Cj4gPiBD
YzogQ2hyaXMgV2lsc29uIDxjaHJpc0BjaHJpcy13aWxzb24uY28udWs+Cj4gPiBTaWduZWQtb2Zm
LWJ5OiBEYW5pZWwgVmV0dGVyIDxkYW5pZWwudmV0dGVyQGludGVsLmNvbT4KPiA+IC0tLQo+ID4g
IGRyaXZlcnMvZ3B1L2RybS9kcm1fYnJpZGdlLmMgfCAyNyArKysrKysrKysrKy0tLS0tLS0tLS0t
LS0tCj4gPiAgaW5jbHVkZS9kcm0vZHJtX2JyaWRnZS5oICAgICB8IDQ4ICsrKysrKysrKysrKysr
KysrKysrKysrKystLS0tLS0tLS0tLS0tLS0tLS0tCj4gPiAgMiBmaWxlcyBjaGFuZ2VkLCAzOSBp
bnNlcnRpb25zKCspLCAzNiBkZWxldGlvbnMoLSkKPiA+IAo+ID4gZGlmZiAtLWdpdCBhL2RyaXZl
cnMvZ3B1L2RybS9kcm1fYnJpZGdlLmMgYi9kcml2ZXJzL2dwdS9kcm0vZHJtX2JyaWRnZS5jCj4g
PiBpbmRleCBhZTVlNTdhZDcxOGMuLjg2YTc2MzdiYTM0NCAxMDA2NDQKPiA+IC0tLSBhL2RyaXZl
cnMvZ3B1L2RybS9kcm1fYnJpZGdlLmMKPiA+ICsrKyBiL2RyaXZlcnMvZ3B1L2RybS9kcm1fYnJp
ZGdlLmMKPiA+IEBAIC01NSw3ICs1NSw3IEBACj4gPiAgICoganVzdCBwcm92aWRlIGFkZGl0aW9u
YWwgaG9va3MgdG8gZ2V0IHRoZSBkZXNpcmVkIG91dHB1dCBhdCB0aGUgZW5kIG9mIHRoZQo+ID4g
ICAqIGVuY29kZXIgY2hhaW4uCj4gPiAgICoKPiA+IC0gKiBCcmlkZ2VzIGNhbiBhbHNvIGJlIGNo
YWluZWQgdXAgdXNpbmcgdGhlIG5leHQgcG9pbnRlciBpbiAmc3RydWN0IGRybV9icmlkZ2UuCj4g
PiArICogQnJpZGdlcyBjYW4gYWxzbyBiZSBjaGFpbmVkIHVwIHVzaW5nIHRoZSAmZHJtX2JyaWRn
ZS5uZXh0IHBvaW50ZXIuCj4gPiAgICoKPiA+ICAgKiBCb3RoIGxlZ2FjeSBDUlRDIGhlbHBlcnMg
YW5kIHRoZSBuZXcgYXRvbWljIG1vZGVzZXQgaGVscGVycyBzdXBwb3J0IGJyaWRnZXMuCj4gPiAg
ICovCj4gPiBAQCAtMTc5LDcgKzE3OSw3IEBAIHZvaWQgZHJtX2JyaWRnZV9kZXRhY2goc3RydWN0
IGRybV9icmlkZ2UgKmJyaWRnZSkKPiA+ICAgKiBAbW9kZTogZGVzaXJlZCBtb2RlIHRvIGJlIHNl
dCBmb3IgdGhlIGJyaWRnZQo+ID4gICAqIEBhZGp1c3RlZF9tb2RlOiB1cGRhdGVkIG1vZGUgdGhh
dCB3b3JrcyBmb3IgdGhpcyBicmlkZ2UKPiA+ICAgKgo+ID4gLSAqIENhbGxzIC0+bW9kZV9maXh1
cCgpICZkcm1fYnJpZGdlX2Z1bmNzIG9wIGZvciBhbGwgdGhlIGJyaWRnZXMgaW4gdGhlCj4gPiAr
ICogQ2FsbHMgJmRybV9icmlkZ2VfZnVuY3MubW9kZV9maXh1cCBmb3IgYWxsIHRoZSBicmlkZ2Vz
IGluIHRoZQo+ID4gICAqIGVuY29kZXIgY2hhaW4sIHN0YXJ0aW5nIGZyb20gdGhlIGZpcnN0IGJy
aWRnZSB0byB0aGUgbGFzdC4KPiA+ICAgKgo+ID4gICAqIE5vdGU6IHRoZSBicmlkZ2UgcGFzc2Vk
IHNob3VsZCBiZSB0aGUgb25lIGNsb3Nlc3QgdG8gdGhlIGVuY29kZXIKPiA+IEBAIC0yMDYsMTEg
KzIwNiwxMCBAQCBib29sIGRybV9icmlkZ2VfbW9kZV9maXh1cChzdHJ1Y3QgZHJtX2JyaWRnZSAq
YnJpZGdlLAo+ID4gIEVYUE9SVF9TWU1CT0woZHJtX2JyaWRnZV9tb2RlX2ZpeHVwKTsKPiA+IAo+
ID4gIC8qKgo+ID4gLSAqIGRybV9icmlkZ2VfZGlzYWJsZSAtIGNhbGxzIC0+ZGlzYWJsZSgpICZk
cm1fYnJpZGdlX2Z1bmNzIG9wIGZvciBhbGwKPiA+IC0gKgkJCWJyaWRnZXMgaW4gdGhlIGVuY29k
ZXIgY2hhaW4uCj4gPiArICogZHJtX2JyaWRnZV9kaXNhYmxlIC0gZGlzYWJsZXMgYWxsIGJyaWRn
ZXMgaW4gdGhlIGVuY29kZXIgY2hhaW4KPiA+ICAgKiBAYnJpZGdlOiBicmlkZ2UgY29udHJvbCBz
dHJ1Y3R1cmUKPiA+ICAgKgo+ID4gLSAqIENhbGxzIC0+ZGlzYWJsZSgpICZkcm1fYnJpZGdlX2Z1
bmNzIG9wIGZvciBhbGwgdGhlIGJyaWRnZXMgaW4gdGhlIGVuY29kZXIKPiA+ICsgKiBDYWxscyAm
ZHJtX2JyaWRnZV9mdW5jcy5kaXNhYmxlIG9wIGZvciBhbGwgdGhlIGJyaWRnZXMgaW4gdGhlIGVu
Y29kZXIKPiA+ICAgKiBjaGFpbiwgc3RhcnRpbmcgZnJvbSB0aGUgbGFzdCBicmlkZ2UgdG8gdGhl
IGZpcnN0LiBUaGVzZSBhcmUgY2FsbGVkIGJlZm9yZQo+ID4gICAqIGNhbGxpbmcgdGhlIGVuY29k
ZXIncyBwcmVwYXJlIG9wLgo+ID4gICAqCj4gPiBAQCAtMjI5LDExICsyMjgsMTAgQEAgdm9pZCBk
cm1fYnJpZGdlX2Rpc2FibGUoc3RydWN0IGRybV9icmlkZ2UgKmJyaWRnZSkKPiA+ICBFWFBPUlRf
U1lNQk9MKGRybV9icmlkZ2VfZGlzYWJsZSk7Cj4gPiAKPiA+ICAvKioKPiA+IC0gKiBkcm1fYnJp
ZGdlX3Bvc3RfZGlzYWJsZSAtIGNhbGxzIC0+cG9zdF9kaXNhYmxlKCkgJmRybV9icmlkZ2VfZnVu
Y3Mgb3AgZm9yCj4gPiAtICoJCQkgICAgIGFsbCBicmlkZ2VzIGluIHRoZSBlbmNvZGVyIGNoYWlu
Lgo+ID4gKyAqIGRybV9icmlkZ2VfcG9zdF9kaXNhYmxlIC0gY2xlYW5zIHVwIGFmdGVyIGRpc2Fi
bGluZyBhbGwgYnJpZGdlcyBpbiB0aGUgZW5jb2RlciBjaGFpbgo+ID4gICAqIEBicmlkZ2U6IGJy
aWRnZSBjb250cm9sIHN0cnVjdHVyZQo+ID4gICAqCj4gPiAtICogQ2FsbHMgLT5wb3N0X2Rpc2Fi
bGUoKSAmZHJtX2JyaWRnZV9mdW5jcyBvcCBmb3IgYWxsIHRoZSBicmlkZ2VzIGluIHRoZQo+ID4g
KyAqIENhbGxzICZkcm1fYnJpZGdlX2Z1bmNzLnBvc3RfZGlzYWJsZSBvcCBmb3IgYWxsIHRoZSBi
cmlkZ2VzIGluIHRoZQo+ID4gICAqIGVuY29kZXIgY2hhaW4sIHN0YXJ0aW5nIGZyb20gdGhlIGZp
cnN0IGJyaWRnZSB0byB0aGUgbGFzdC4gVGhlc2UgYXJlIGNhbGxlZAo+ID4gICAqIGFmdGVyIGNv
bXBsZXRpbmcgdGhlIGVuY29kZXIncyBwcmVwYXJlIG9wLgo+ID4gICAqCj4gPiBAQCAtMjU4LDcg
KzI1Niw3IEBAIEVYUE9SVF9TWU1CT0woZHJtX2JyaWRnZV9wb3N0X2Rpc2FibGUpOwo+ID4gICAq
IEBtb2RlOiBkZXNpcmVkIG1vZGUgdG8gYmUgc2V0IGZvciB0aGUgYnJpZGdlCj4gPiAgICogQGFk
anVzdGVkX21vZGU6IHVwZGF0ZWQgbW9kZSB0aGF0IHdvcmtzIGZvciB0aGlzIGJyaWRnZQo+ID4g
ICAqCj4gPiAtICogQ2FsbHMgLT5tb2RlX3NldCgpICZkcm1fYnJpZGdlX2Z1bmNzIG9wIGZvciBh
bGwgdGhlIGJyaWRnZXMgaW4gdGhlCj4gPiArICogQ2FsbHMgJmRybV9icmlkZ2VfZnVuY3MubW9k
ZV9zZXQgb3AgZm9yIGFsbCB0aGUgYnJpZGdlcyBpbiB0aGUKPiA+ICAgKiBlbmNvZGVyIGNoYWlu
LCBzdGFydGluZyBmcm9tIHRoZSBmaXJzdCBicmlkZ2UgdG8gdGhlIGxhc3QuCj4gPiAgICoKPiA+
ICAgKiBOb3RlOiB0aGUgYnJpZGdlIHBhc3NlZCBzaG91bGQgYmUgdGhlIG9uZSBjbG9zZXN0IHRv
IHRoZSBlbmNvZGVyCj4gPiBAQCAtMjc4LDExICsyNzYsMTEgQEAgdm9pZCBkcm1fYnJpZGdlX21v
ZGVfc2V0KHN0cnVjdCBkcm1fYnJpZGdlICpicmlkZ2UsCj4gPiAgRVhQT1JUX1NZTUJPTChkcm1f
YnJpZGdlX21vZGVfc2V0KTsKPiA+IAo+ID4gIC8qKgo+ID4gLSAqIGRybV9icmlkZ2VfcHJlX2Vu
YWJsZSAtIGNhbGxzIC0+cHJlX2VuYWJsZSgpICZkcm1fYnJpZGdlX2Z1bmNzIG9wIGZvciBhbGwK
PiA+IC0gKgkJCSAgIGJyaWRnZXMgaW4gdGhlIGVuY29kZXIgY2hhaW4uCj4gPiArICogZHJtX2Jy
aWRnZV9wcmVfZW5hYmxlIC0gcHJlcGFyZXMgZm9yIGVuYWJsaW5nIGFsbAo+ID4gKyAqCQkJICAg
YnJpZGdlcyBpbiB0aGUgZW5jb2RlciBjaGFpbgo+ID4gICAqIEBicmlkZ2U6IGJyaWRnZSBjb250
cm9sIHN0cnVjdHVyZQo+ID4gICAqCj4gPiAtICogQ2FsbHMgLT5wcmVfZW5hYmxlKCkgJmRybV9i
cmlkZ2VfZnVuY3Mgb3AgZm9yIGFsbCB0aGUgYnJpZGdlcyBpbiB0aGUgZW5jb2Rlcgo+ID4gKyAq
IENhbGxzICZkcm1fYnJpZGdlX2Z1bmNzLnByZV9lbmFibGUgb3AgZm9yIGFsbCB0aGUgYnJpZGdl
cyBpbiB0aGUgZW5jb2Rlcgo+ID4gICAqIGNoYWluLCBzdGFydGluZyBmcm9tIHRoZSBsYXN0IGJy
aWRnZSB0byB0aGUgZmlyc3QuIFRoZXNlIGFyZSBjYWxsZWQKPiA+ICAgKiBiZWZvcmUgY2FsbGlu
ZyB0aGUgZW5jb2RlcidzIGNvbW1pdCBvcC4KPiA+ICAgKgo+ID4gQEAgLTMwMSwxMSArMjk5LDEw
IEBAIHZvaWQgZHJtX2JyaWRnZV9wcmVfZW5hYmxlKHN0cnVjdCBkcm1fYnJpZGdlICpicmlkZ2Up
Cj4gPiAgRVhQT1JUX1NZTUJPTChkcm1fYnJpZGdlX3ByZV9lbmFibGUpOwo+ID4gCj4gPiAgLyoq
Cj4gPiAtICogZHJtX2JyaWRnZV9lbmFibGUgLSBjYWxscyAtPmVuYWJsZSgpICZkcm1fYnJpZGdl
X2Z1bmNzIG9wIGZvciBhbGwgYnJpZGdlcwo+ID4gLSAqCQkgICAgICAgaW4gdGhlIGVuY29kZXIg
Y2hhaW4uCj4gPiArICogZHJtX2JyaWRnZV9lbmFibGUgLSBlbmFibGVzIGFsbCBicmlkZ2VzIGlu
IHRoZSBlbmNvZGVyIGNoYWluCj4gPiAgICogQGJyaWRnZTogYnJpZGdlIGNvbnRyb2wgc3RydWN0
dXJlCj4gPiAgICoKPiA+IC0gKiBDYWxscyAtPmVuYWJsZSgpICZkcm1fYnJpZGdlX2Z1bmNzIG9w
IGZvciBhbGwgdGhlIGJyaWRnZXMgaW4gdGhlIGVuY29kZXIKPiA+ICsgKiBDYWxscyAmZHJtX2Jy
aWRnZV9mdW5jcy5lbmFibGUgb3AgZm9yIGFsbCB0aGUgYnJpZGdlcyBpbiB0aGUgZW5jb2Rlcgo+
ID4gICAqIGNoYWluLCBzdGFydGluZyBmcm9tIHRoZSBmaXJzdCBicmlkZ2UgdG8gdGhlIGxhc3Qu
IFRoZXNlIGFyZSBjYWxsZWQKPiA+ICAgKiBhZnRlciBjb21wbGV0aW5nIHRoZSBlbmNvZGVyJ3Mg
Y29tbWl0IG9wLgo+ID4gICAqCj4gPiBkaWZmIC0tZ2l0IGEvaW5jbHVkZS9kcm0vZHJtX2JyaWRn
ZS5oIGIvaW5jbHVkZS9kcm0vZHJtX2JyaWRnZS5oCj4gPiBpbmRleCBkM2NhMTZmNGRhOGYuLjE1
OTVhNTdkZmJmMiAxMDA2NDQKPiA+IC0tLSBhL2luY2x1ZGUvZHJtL2RybV9icmlkZ2UuaAo+ID4g
KysrIGIvaW5jbHVkZS9kcm0vZHJtX2JyaWRnZS5oCj4gPiBAQCAtODcsMTggKzg3LDE5IEBAIHN0
cnVjdCBkcm1fYnJpZGdlX2Z1bmNzIHsKPiA+ICAJICogVHJ1ZSBpZiBhbiBhY2NlcHRhYmxlIGNv
bmZpZ3VyYXRpb24gaXMgcG9zc2libGUsIGZhbHNlIGlmIHRoZSBtb2Rlc2V0Cj4gPiAgCSAqIG9w
ZXJhdGlvbiBzaG91bGQgYmUgcmVqZWN0ZWQuCj4gPiAgCSAqLwo+ID4gLQlib29sICgqbW9kZV9m
aXh1cCkoc3RydWN0IGRybV9icmlkZ2UgKmJyaWRnZSwKPiA+IC0JCQkgICBjb25zdCBzdHJ1Y3Qg
ZHJtX2Rpc3BsYXlfbW9kZSAqbW9kZSwKPiA+IC0JCQkgICBzdHJ1Y3QgZHJtX2Rpc3BsYXlfbW9k
ZSAqYWRqdXN0ZWRfbW9kZSk7Cj4gPiArCWJvb2wgKCptb2RlX2ZpeHVwKShzdHJ1Y3QgZHJtX2Jy
aWRnZSAqYnJpZGdlLCBjb25zdCBzdHJ1Y3QKPiA+ICsJCQkgICBkcm1fZGlzcGxheV9tb2RlICpt
b2RlLCBzdHJ1Y3QgZHJtX2Rpc3BsYXlfbW9kZQo+ID4gKwkJCSAgICphZGp1c3RlZF9tb2RlKTsK
PiAKPiBUaGUgY2hhbmdlIGFib3ZlIGRvZXNuJ3Qgc2VlbSB0byBoZWxwIHdpdGggYW55dGhpbmcu
IE90aGVyd2lzZToKCkluZGVlZCwgdGhhdCBzaG91bGRuJ3QgaGF2ZSBiZWVuIHRoZXJlLCBJIHJl
bW92ZWQgaXQgd2hpbGUgYXBwbHlpbmcuCgo+IFJldmlld2VkLWJ5OiBBcmNoaXQgVGFuZWphIDxh
cmNoaXR0QGNvZGVhdXJvcmEub3JnPgoKVGhhbmtzIGEgbG90IGZvciB5b3VyIHJldmlldy4KLURh
bmllbAotLSAKRGFuaWVsIFZldHRlcgpTb2Z0d2FyZSBFbmdpbmVlciwgSW50ZWwgQ29ycG9yYXRp
b24KaHR0cDovL2Jsb2cuZmZ3bGwuY2gKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f
X19fX19fX19fX19fX18KZHJpLWRldmVsIG1haWxpbmcgbGlzdApkcmktZGV2ZWxAbGlzdHMuZnJl
ZWRlc2t0b3Aub3JnCmh0dHBzOi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGlu
Zm8vZHJpLWRldmVsCg==