From mboxrd@z Thu Jan 1 00:00:00 1970 From: David Henningsson Subject: Re: [PATCH v2] drm/i915: Improve kernel-doc for i915_audio_component struct Date: Mon, 12 Oct 2015 10:17:51 +0200 Message-ID: <561B6CAF.8090009@canonical.com> References: <1444637277-17784-1-git-send-email-david.henningsson@canonical.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8"; Format="flowed" Content-Transfer-Encoding: base64 Return-path: Received: from youngberry.canonical.com (youngberry.canonical.com [91.189.89.112]) by gabe.freedesktop.org (Postfix) with ESMTPS id DBB9B6E20E for ; Mon, 12 Oct 2015 01:17:55 -0700 (PDT) In-Reply-To: <1444637277-17784-1-git-send-email-david.henningsson@canonical.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: tiwai@suse.de, intel-gfx@lists.freedesktop.org, alsa-devel@alsa-project.org, daniel@ffwll.ch, jani.nikula@linux.intel.com, libin.yang@intel.com List-Id: intel-gfx@lists.freedesktop.org CgpPbiAyMDE1LTEwLTEyIDEwOjA3LCBEYXZpZCBIZW5uaW5nc3NvbiB3cm90ZToKPiBUbyBtYWtl IGtlcm5lbC1kb2MgaGFwcHksIHRoZSBpOTE1X2F1ZGlvX2NvbXBvbmVudF9hdWRpb19vcHMgc3Ry dWN0Cj4gY2Fubm90IGJlIG5lc3RlZC4KPgo+IFNpZ25lZC1vZmYtYnk6IERhdmlkIEhlbm5pbmdz c29uIDxkYXZpZC5oZW5uaW5nc3NvbkBjYW5vbmljYWwuY29tPgo+IC0tLQoKQ2hhbmdlcyBzaW5j ZSB2MToKCiAgKiBBZGRlZCBhIG5vdGljZSBhYm91dCB3aGVuIHBpbl9lbGRfbm90aWZ5IGlzIGNh bGxlZAoKICAqIFVzZXMgbmV3IGlubGluZSBzdHJ1Y3QgbWVtYmVyIHN0eWxlCgpWZXJpZmllZCB3 aXRoICJtYWtlIGh0bWxkb2NzIiwgbG9va3MgZmluZSB0byBtZS4KCkFsc28sIGFwcGxpZXMgdG8g VGFrYXNoaSdzIHRyZWUgKG1hc3RlciBicmFuY2gpLCBtYXliZSB3ZSBzaG91bGQgdGFrZSBpdCAK dGhyb3VnaCBUYWthc2hpJ3MgdHJlZSB0byBhdm9pZCBjb25mbGljdHMsIGVzcGVjaWFsbHkgYXMg dGhlcmUgbWlnaHQgYmUgCm1vcmUgc3R1ZmYgY29taW5nIHRoYXQgd2F5IChkcCBtc3Qgc3VwcG9y dCBmcm9tIE1lbmdkb25nLCBhbmQgcGVyaGFwcyAKaW5mbyByZXRyaWV2YWwgZnJvbSBtZSkuCgoK PiAgIERvY3VtZW50YXRpb24vRG9jQm9vay9kcm0udG1wbCB8ICAxICsKPiAgIGluY2x1ZGUvZHJt L2k5MTVfY29tcG9uZW50LmggICB8IDkyICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKy0t LS0tLS0tLS0tLQo+ICAgMiBmaWxlcyBjaGFuZ2VkLCA2NyBpbnNlcnRpb25zKCspLCAyNiBkZWxl dGlvbnMoLSkKPgo+IGRpZmYgLS1naXQgYS9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svZHJtLnRtcGwg Yi9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svZHJtLnRtcGwKPiBpbmRleCA5ZGRmOGM2Li5mMTZlNGU4 IDEwMDY0NAo+IC0tLSBhL0RvY3VtZW50YXRpb24vRG9jQm9vay9kcm0udG1wbAo+ICsrKyBiL0Rv Y3VtZW50YXRpb24vRG9jQm9vay9kcm0udG1wbAo+IEBAIC00MDUxLDYgKzQwNTEsNyBAQCBpbnQg bnVtX2lvY3Rsczs8L3N5bm9wc2lzPgo+ICAgCTx0aXRsZT5IaWdoIERlZmluaXRpb24gQXVkaW88 L3RpdGxlPgo+ICAgIVBkcml2ZXJzL2dwdS9kcm0vaTkxNS9pbnRlbF9hdWRpby5jIEhpZ2ggRGVm aW5pdGlvbiBBdWRpbyBvdmVyIEhETUkgYW5kIERpc3BsYXkgUG9ydAo+ICAgIUlkcml2ZXJzL2dw dS9kcm0vaTkxNS9pbnRlbF9hdWRpby5jCj4gKyFJaW5jbHVkZS9kcm0vaTkxNV9jb21wb25lbnQu aAo+ICAgICAgICAgPC9zZWN0Mj4KPiAgICAgICAgIDxzZWN0Mj4KPiAgIAk8dGl0bGU+UGFuZWwg U2VsZiBSZWZyZXNoIFBTUiAoUFNSL1NSRCk8L3RpdGxlPgo+IGRpZmYgLS1naXQgYS9pbmNsdWRl L2RybS9pOTE1X2NvbXBvbmVudC5oIGIvaW5jbHVkZS9kcm0vaTkxNV9jb21wb25lbnQuaAo+IGlu ZGV4IDg5ZGM3ZDYuLjc2YzEwYzggMTAwNjQ0Cj4gLS0tIGEvaW5jbHVkZS9kcm0vaTkxNV9jb21w b25lbnQuaAo+ICsrKyBiL2luY2x1ZGUvZHJtL2k5MTVfY29tcG9uZW50LmgKPiBAQCAtMzAsMzgg KzMwLDc4IEBACj4gICAgKi8KPiAgICNkZWZpbmUgTUFYX1BPUlRTIDUKPgo+ICsvKioKPiArICog c3RydWN0IGk5MTVfYXVkaW9fY29tcG9uZW50X29wcyAtIE9wcyBpbXBsZW1lbnRlZCBieSBpOTE1 IGRyaXZlciwgY2FsbGVkIGJ5IGhkYSBkcml2ZXIKPiArICovCj4gK3N0cnVjdCBpOTE1X2F1ZGlv X2NvbXBvbmVudF9vcHMgewo+ICsJLyoqCj4gKwkgKiBAb3duZXI6IGk5MTUgbW9kdWxlCj4gKwkg Ki8KPiArCXN0cnVjdCBtb2R1bGUgKm93bmVyOwo+ICsJLyoqCj4gKwkgKiBAZ2V0X3Bvd2VyOiBS ZXF1ZXN0IHRoYXQgcG93ZXIgd2VsbCBpcyB0byBiZSB0dXJuZWQgb24KPiArCSAqLwo+ICsJdm9p ZCAoKmdldF9wb3dlcikoc3RydWN0IGRldmljZSAqKTsKPiArCS8qKgo+ICsJICogQHB1dF9wb3dl cjogQWxsb3cgdGhlIHBvd2VyIHdlbGwgdG8gYmUgdHVybmVkIG9mZgo+ICsJICovCj4gKwl2b2lk ICgqcHV0X3Bvd2VyKShzdHJ1Y3QgZGV2aWNlICopOwo+ICsJLyoqCj4gKwkgKiBAY29kZWNfd2Fr ZV9vdmVycmlkZTogRm9yY2UgdGhlIGF1ZGlvIGNvZGVjIHRvIHN0YXkgYXdha2UKPiArCSAqLwo+ ICsJdm9pZCAoKmNvZGVjX3dha2Vfb3ZlcnJpZGUpKHN0cnVjdCBkZXZpY2UgKiwgYm9vbCBlbmFi bGUpOwo+ICsJLyoqCj4gKwkgKiBAZ2V0X2NkY2xrX2ZyZXE6IFF1ZXJ5IHRoZSBpOTE1IGRyaXZl ciBhYm91dCB0aGUgY3VycmVudCBjZGNsayBmcmVxdWVuY3kKPiArCSAqLwo+ICsJaW50ICgqZ2V0 X2NkY2xrX2ZyZXEpKHN0cnVjdCBkZXZpY2UgKik7Cj4gKwkvKioKPiArCSAqIEBzeW5jX2F1ZGlv X3JhdGU6IHNldCBuL2N0cyBiYXNlZCBvbiB0aGUgc2FtcGxlIHJhdGUKPiArCSAqCj4gKwkgKiBD YWxsZWQgZnJvbSBhdWRpbyBkcml2ZXIuIEFmdGVyIGF1ZGlvIGRyaXZlciBzZXRzIHRoZQo+ICsJ ICogc2FtcGxlIHJhdGUsIGl0IHdpbGwgY2FsbCB0aGlzIGZ1bmN0aW9uIHRvIHNldCBuL2N0cwo+ ICsJICovCj4gKwlpbnQgKCpzeW5jX2F1ZGlvX3JhdGUpKHN0cnVjdCBkZXZpY2UgKiwgaW50IHBv cnQsIGludCByYXRlKTsKPiArfTsKPiArCj4gKy8qKgo+ICsgKiBzdHJ1Y3QgaTkxNV9hdWRpb19j b21wb25lbnRfYXVkaW9fb3BzIC0gT3BzIGltcGxlbWVudGVkIGJ5IGhkYSBkcml2ZXIsIGNhbGxl ZCBieSBpOTE1IGRyaXZlcgo+ICsgKi8KPiArc3RydWN0IGk5MTVfYXVkaW9fY29tcG9uZW50X2F1 ZGlvX29wcyB7Cj4gKwkvKioKPiArCSAqIEBhdWRpb19wdHI6IFBvaW50ZXIgdG8gYmUgdXNlZCBp biBjYWxsIHRvIHBpbl9lbGRfbm90aWZ5Cj4gKwkgKi8KPiArCXZvaWQgKmF1ZGlvX3B0cjsKPiAr CS8qKgo+ICsJICogQHBpbl9lbGRfbm90aWZ5OiBOb3RpZnkgdGhlIEhEQSBkcml2ZXIgdGhhdCBw aW4gc2Vuc2UgYW5kL29yIEVMRCBpbmZvcm1hdGlvbiBoYXMgY2hhbmdlZAo+ICsJICoKPiArCSAq IENhbGxlZCB3aGVuIHRoZSBpOTE1IGRyaXZlciBoYXMgc2V0IHVwIGF1ZGlvIHBpcGVsaW5lIG9y IGhhcyBqdXN0Cj4gKwkgKiBiZWd1biB0byB0ZWFyIGl0IGRvd24uIFRoaXMgYWxsb3dzIHRoZSBI REEgZHJpdmVyIHRvIHVwZGF0ZSBpdHMKPiArCSAqIHN0YXR1cyBhY2NvcmRpbmdseSAoZXZlbiB3 aGVuIHRoZSBIREEgY29udHJvbGxlciBpcyBpbiBwb3dlciBzYXZlCj4gKwkgKiBtb2RlKS4KPiAr CSAqLwo+ICsJdm9pZCAoKnBpbl9lbGRfbm90aWZ5KSh2b2lkICphdWRpb19wdHIsIGludCBwb3J0 KTsKPiArfTsKPiArCj4gKy8qKgo+ICsgKiBzdHJ1Y3QgaTkxNV9hdWRpb19jb21wb25lbnQgLSBV c2VkIGZvciBkaXJlY3QgY29tbXVuaWNhdGlvbiBiZXR3ZWVuIGk5MTUgYW5kIGhkYSBkcml2ZXJz Cj4gKyAqLwo+ICAgc3RydWN0IGk5MTVfYXVkaW9fY29tcG9uZW50IHsKPiArCS8qKgo+ICsJICog QGRldjogaTkxNSBkZXZpY2UsIHVzZWQgYXMgcGFyYW1ldGVyIGZvciBvcHMKPiArCSAqLwo+ICAg CXN0cnVjdCBkZXZpY2UgKmRldjsKPiAgIAkvKioKPiAgIAkgKiBAYXVkX3NhbXBsZV9yYXRlOiB0 aGUgYXJyYXkgb2YgYXVkaW8gc2FtcGxlIHJhdGUgcGVyIHBvcnQKPiAgIAkgKi8KPiAgIAlpbnQg YXVkX3NhbXBsZV9yYXRlW01BWF9QT1JUU107Cj4gLQo+IC0JY29uc3Qgc3RydWN0IGk5MTVfYXVk aW9fY29tcG9uZW50X29wcyB7Cj4gLQkJc3RydWN0IG1vZHVsZSAqb3duZXI7Cj4gLQkJdm9pZCAo KmdldF9wb3dlcikoc3RydWN0IGRldmljZSAqKTsKPiAtCQl2b2lkICgqcHV0X3Bvd2VyKShzdHJ1 Y3QgZGV2aWNlICopOwo+IC0JCXZvaWQgKCpjb2RlY193YWtlX292ZXJyaWRlKShzdHJ1Y3QgZGV2 aWNlICosIGJvb2wgZW5hYmxlKTsKPiAtCQlpbnQgKCpnZXRfY2RjbGtfZnJlcSkoc3RydWN0IGRl dmljZSAqKTsKPiAtCQkvKioKPiAtCQkgKiBAc3luY19hdWRpb19yYXRlOiBzZXQgbi9jdHMgYmFz ZWQgb24gdGhlIHNhbXBsZSByYXRlCj4gLQkJICoKPiAtCQkgKiBDYWxsZWQgZnJvbSBhdWRpbyBk cml2ZXIuIEFmdGVyIGF1ZGlvIGRyaXZlciBzZXRzIHRoZQo+IC0JCSAqIHNhbXBsZSByYXRlLCBp dCB3aWxsIGNhbGwgdGhpcyBmdW5jdGlvbiB0byBzZXQgbi9jdHMKPiAtCQkgKi8KPiAtCQlpbnQg KCpzeW5jX2F1ZGlvX3JhdGUpKHN0cnVjdCBkZXZpY2UgKiwgaW50IHBvcnQsIGludCByYXRlKTsK PiAtCX0gKm9wczsKPiAtCj4gLQljb25zdCBzdHJ1Y3QgaTkxNV9hdWRpb19jb21wb25lbnRfYXVk aW9fb3BzIHsKPiAtCQl2b2lkICphdWRpb19wdHI7Cj4gLQkJLyoqCj4gLQkJICogQ2FsbCBmcm9t IGk5MTUgZHJpdmVyLCBub3RpZnlpbmcgdGhlIEhEQSBkcml2ZXIgdGhhdAo+IC0JCSAqIHBpbiBz ZW5zZSBhbmQvb3IgRUxEIGluZm9ybWF0aW9uIGhhcyBjaGFuZ2VkLgo+IC0JCSAqIEBhdWRpb19w dHI6CQlIREEgZHJpdmVyIG9iamVjdAo+IC0JCSAqIEBwb3J0OgkJV2hpY2ggcG9ydCBoYXMgY2hh bmdlZCAoUE9SVEEgLyBQT1JUQiAvIFBPUlRDIGV0YykKPiAtCQkgKi8KPiAtCQl2b2lkICgqcGlu X2VsZF9ub3RpZnkpKHZvaWQgKmF1ZGlvX3B0ciwgaW50IHBvcnQpOwo+IC0JfSAqYXVkaW9fb3Bz Owo+ICsJLyoqCj4gKwkgKiBAb3BzOiBPcHMgaW1wbGVtZW50ZWQgYnkgaTkxNSBkcml2ZXIsIGNh bGxlZCBieSBoZGEgZHJpdmVyCj4gKwkgKi8KPiArCWNvbnN0IHN0cnVjdCBpOTE1X2F1ZGlvX2Nv bXBvbmVudF9vcHMgKm9wczsKPiArCS8qKgo+ICsJICogQGF1ZGlvX29wczogT3BzIGltcGxlbWVu dGVkIGJ5IGhkYSBkcml2ZXIsIGNhbGxlZCBieSBpOTE1IGRyaXZlcgo+ICsJICovCj4gKwljb25z dCBzdHJ1Y3QgaTkxNV9hdWRpb19jb21wb25lbnRfYXVkaW9fb3BzICphdWRpb19vcHM7Cj4gICB9 Owo+Cj4gICAjZW5kaWYgLyogX0k5MTVfQ09NUE9ORU5UX0hfICovCj4KCi0tIApEYXZpZCBIZW5u aW5nc3NvbiwgQ2Fub25pY2FsIEx0ZC4KaHR0cHM6Ly9sYXVuY2hwYWQubmV0L35kaXdpYwpfX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwpJbnRlbC1nZnggbWFp bGluZyBsaXN0CkludGVsLWdmeEBsaXN0cy5mcmVlZGVza3RvcC5vcmcKaHR0cDovL2xpc3RzLmZy ZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2ludGVsLWdmeAo=