From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Vetter Subject: Re: [PATCH v2 1/2] drm/gem-fb-helper: Cleanup docs Date: Wed, 20 Sep 2017 20:31:59 +0200 Message-ID: <20170920183159.GC25248@dvetter-linux.ger.corp.intel.com> References: <1505147865-18194-1-git-send-email-noralf@tronnes.org> <4692416.YVPRQrtBV0@avalon> <1676209.HR8ufoFrR4@avalon> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-pg0-x232.google.com (mail-pg0-x232.google.com [IPv6:2607:f8b0:400e:c05::232]) by gabe.freedesktop.org (Postfix) with ESMTPS id F2F286E1CD for ; Wed, 20 Sep 2017 18:32:02 +0000 (UTC) Received: by mail-pg0-x232.google.com with SMTP id v23so2148428pgc.5 for ; Wed, 20 Sep 2017 11:32:02 -0700 (PDT) Content-Disposition: inline In-Reply-To: <1676209.HR8ufoFrR4@avalon> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Laurent Pinchart Cc: dri-devel@lists.freedesktop.org List-Id: dri-devel@lists.freedesktop.org T24gRnJpLCBTZXAgMTUsIDIwMTcgYXQgMTI6NDU6MTRBTSArMDMwMCwgTGF1cmVudCBQaW5jaGFy dCB3cm90ZToKPiBIaSBOb3JhbGYsCj4gCj4gT24gV2VkbmVzZGF5LCAxMyBTZXB0ZW1iZXIgMjAx NyAxNjo0MTo0OSBFRVNUIE5vcmFsZiBUcsO4bm5lcyB3cm90ZToKPiA+IERlbiAxMy4wOS4yMDE3 IDA0LjQ0LCBza3JldiBMYXVyZW50IFBpbmNoYXJ0Ogo+ID4gPiBPbiBNb25kYXksIDExIFNlcHRl bWJlciAyMDE3IDE5OjM3OjQ0IEVFU1QgTm9yYWxmIFRyw7hubmVzIHdyb3RlOgo+ID4gPj4gTWFr ZSB0aGUgZG9jcyByZWFkIGEgbGl0dGxlIGJldHRlci4KPiA+ID4+IAo+ID4gPj4gQ2M6IExhdXJl bnQgUGluY2hhcnQgPGxhdXJlbnQucGluY2hhcnRAaWRlYXNvbmJvYXJkLmNvbT4KPiA+ID4+IFNp Z25lZC1vZmYtYnk6IE5vcmFsZiBUcsO4bm5lcyA8bm9yYWxmQHRyb25uZXMub3JnPgo+ID4gPj4g UmV2aWV3ZWQtYnk6IERhbmllbCBWZXR0ZXIgPGRhbmllbC52ZXR0ZXJAZmZ3bGwuY2g+Cj4gPiA+ PiAtLS0KPiA+ID4+IAo+ID4gPj4gQ2hhbmdlczoKPiA+ID4+IEFkZHJlc3NlZCBEYW5pZWwncyBj b21tZW50cy4KPiA+ID4+IAo+ID4gPj4gZHJpdmVycy9ncHUvZHJtL2RybV9nZW1fZnJhbWVidWZm ZXJfaGVscGVyLmMgfCAyNSArKysrKysrKysrKysrLS0tLS0tLS0tLQo+ID4gPj4gCj4gPiA+PiAx IGZpbGUgY2hhbmdlZCwgMTQgaW5zZXJ0aW9ucygrKSwgMTEgZGVsZXRpb25zKC0pCj4gPiA+PiAK PiA+ID4+IGRpZmYgLS1naXQgYS9kcml2ZXJzL2dwdS9kcm0vZHJtX2dlbV9mcmFtZWJ1ZmZlcl9o ZWxwZXIuYwo+ID4gPj4gYi9kcml2ZXJzL2dwdS9kcm0vZHJtX2dlbV9mcmFtZWJ1ZmZlcl9oZWxw ZXIuYyBpbmRleCBkNTRhMDgzLi5lMmNhMDAyCj4gPiA+PiAxMDA2NDQKPiA+ID4+IC0tLSBhL2Ry aXZlcnMvZ3B1L2RybS9kcm1fZ2VtX2ZyYW1lYnVmZmVyX2hlbHBlci5jCj4gPiA+PiArKysgYi9k cml2ZXJzL2dwdS9kcm0vZHJtX2dlbV9mcmFtZWJ1ZmZlcl9oZWxwZXIuYwo+IAo+IFtzbmlwXQo+ IAo+ID4gPj4gIC8qKgo+ID4gPj4gICAqIGRybV9nZW1fZmJfY3JlYXRlX2hhbmRsZSAtIENyZWF0 ZSBoYW5kbGUgZm9yIEdFTSBiYWNrZWQgZnJhbWVidWZmZXIKPiA+ID4+IC0gKiBAZmI6IERSTSBm cmFtZWJ1ZmZlcgo+ID4gPj4gLSAqIEBmaWxlOiBkcm0gZmlsZQo+ID4gPj4gKyAqIEBmYjogZnJh bWVidWZmZXIKPiA+ID4+ICsgKiBAZmlsZTogRFJNIGZpbGUKPiA+ID4gCj4gPiA+IEkgd29uZGVy IHdoeSBmcmFtZWJ1ZmZlciBkb2Vzbid0IG5lZWQgYSBEUk0gd2hpbGUgZmlsZSBkb2VzIDotKQo+ ID4gCj4gPiBZZXMgdGhpcyBpcyBoYXBoYXphcmQuCj4gPiBJIHRoaW5rIG15IHByb2JsZW0gaXMg dGhhdCBJIGhhdmVuJ3QgYmVlbiBhYmxlIHRvIHBpY2sgdXAgYSBjb25zaXN0ZW50Cj4gPiAic2ln bmFsIiBmcm9tIHRoZSBEUk0gc3Vic3lzdGVtIHdoZW4gaXQgY29tZXMgdG8gaG93IGRvY3VtZW50 YXRpb24KPiA+IHNob3VsZCBiZSB3cml0dGVuLiBDb2RlIHBhdHRlcm5zIGFyZSBmYWlybHkgY29u c2lzdGVudCBhbmQgbG9va3MgbXVjaAo+ID4gdGhlIHNhbWUgaW5jbHVkaW5nIHZhcmlhYmxlIG5h bWVzLCBidXQgZG9jdW1lbnRhdGlvbiBpcyBtb3JlIG9yIGxlc3MKPiA+IGFsbCBvdmVyIHRoZSBw bGFjZS4KPiAKPiBUaGF0IGRvZXNuJ3Qgc3VycHJpc2UgbWUgdG9vIG11Y2gsIGFzIGRvY3VtZW50 YXRpb24gaW4gRFJNIGlzIHByZXR0eSByZWNlbnQsIAo+IGFuZCB3ZSBuZXZlciBhZ3JlZWQgdG8g YSBkb2N1bWVudGF0aW9uIHN0eWxlLgo+IAo+ID4gU28gSSBndWVzcyBJIG5lZWQgdG8gY29tZSB0 byBncmlwcyB3aXRoIHRoaXMsIHNpbmNlIHRoaXMgaXNuJ3QgdGhlIGxhc3QKPiA+IHRpbWUgSSBo YXZlIHRvIHdyaXRlIGRvY3VtZW50YXRpb24uIEkgaGF2ZSB0byBtYWtlIG15c2VsZiBzb21lIHJ1 bGVzCj4gPiB0aGF0IEkgY2FuIGxvb2sgYXQgbmV4dCB0aW1lIHdoZW4gYWxsIG9mIHRoaXMgaXMg Zm9yZ290dGVuLgo+IAo+IE9yLCBhcyB0aGUgZmlyc3QgcGVyc29uIHRvIGFkZHJlc3MgdGhpcyBw cm9ibGVtLCB5b3UgY291bGQgc2V0IHlvdXIgb3duIHJ1bGVzIAo+IHRoYXQgZXZlcnlib2R5IGVs c2Ugc2hvdWxkIHRoZW4gZm9sbG93IDotKQoKQmV0dGVyIGlzIHRvIGFjdHVhbGx5IHN3aXRjaCBh bGwgY2FzZXMgb3Zlci4gV2hpY2ggeWVzIGlzIGEgbG90IG1vcmUgd29yaywKYnV0IG90aGVyd2lz ZSBpdCB3b24ndCBjb252ZXJnZS4gU2luY2UgYXQgbGVhc3QgbWUgcGVyc29uYWxseSBJIHRlbmQg dG8KanVzdCBjb3B5IHRoZSBwYXR0ZXJucyBmcm9tIHRoZSBzYW1lIGZpbGUgLi4uCgo+ID4gU2hv dWxkIGRlc2NyaXB0aW9uIGVudHJpZXMgYmUgQ2FwaXRhbGl6ZWQ/Cj4gPiBNeSBndXQgZmVlbGlu ZyBpcyB0aGF0IG1vc3QgRFJNIGRvY3MgZG9uJ3QgZG8gdGhhdCwgYnV0IHdoZW4gaHVtYW5zCj4g PiB3cml0ZSBmb3IgaHVtYW5zIHdlIGRvIGNhcGF0YWxpemUgdGhlIHN0YXJ0IG9mIHNlbnRlbmNl cy4gU28gSSBndWVzcwo+ID4gdGhhdCdzIHRoZSBuYXR1cmFsIHRoaW5nIHRvIGRvLgo+ID4gCj4g PiBTaG91bGQgRFJNIG9iamVjdHMgc3RhcnQgd2l0aCBEUk0gaW4gdGhlIGFyZ3VtZW50IGRvYyBl bnRyaWVzPwo+ID4gJ0RSTSBkZXZpY2UnIGlzIGEgZ2l2ZW4gc2luY2UgdGhlIGtlcm5lbCBoYXMg bWFueSB0eXBlcyBvZiBkZXZpY2VzLCBidXQKPiA+IHNob3VsZCB3ZSB3cml0ZSAnRFJNIGZyYW1l YnVmZmVyJyBvciAnRnJhbWVidWZmZXInPwo+IAo+IEkgd291bGQgb25seSBtZW50aW9uIERSTSB3 aGVuIHRoZSBkZXNjcmlwdGlvbiBjb3VsZCBvdGhlcndpc2UgYmUgCj4gbWlzaW50ZXJwcmV0ZWQs IGFzIGluIERSTSBkZXZpY2UuCj4gCj4gPiBIb3cgZGVzY3JpcHRpdmUgc2hvdWxkIHRoZSBkZXNj cmlwdGlvbnMgYmU/Cj4gPiBMZXQncyB0YWtlIHRoaXMgZXhhbXBsZToKPiA+IAo+ID4gLyoqCj4g PiAgICogZHJtX2dlbV9mYl9wcmVwYXJlX2ZiKCkgLSBQcmVwYXJlIGdlbSBmcmFtZWJ1ZmZlcgo+ ID4gICAqIEBwbGFuZTogV2hpY2ggcGxhbmUKPiA+ICAgKiBAc3RhdGU6IFBsYW5lIHN0YXRlIHRo ZSBmZW5jZSB3aWxsIGJlIGF0dGFjaGVkIHRvCj4gPiAgICoKPiA+ICAgKiBUaGlzIGNhbiBiZSB1 c2VkIGFzIHRoZSAmZHJtX3BsYW5lX2hlbHBlcl9mdW5jcy5wcmVwYXJlX2ZiIGhvb2suCj4gPiAg ICoKPiA+ICAgKiBUaGlzIGZ1bmN0aW9uIGNoZWNrcyBpZiB0aGUgcGxhbmUgRkIgaGFzIGFuIGRt YS1idWYgYXR0YWNoZWQsIGV4dHJhY3RzCj4gPiAgICogdGhlIGV4Y2x1c2l2ZSBmZW5jZSBhbmQg YXR0YWNoZXMgaXQgdG8gcGxhbmUgc3RhdGUgZm9yIHRoZSBhdG9taWMgaGVscGVyCj4gPiAgICog dG8gd2FpdCBvbi4KPiA+IAo+ID4gQm90aCB0aGUgQHN0YXRlIGRlc2NyaXB0aW9uIGFuZCB0aGUg Ym9keSBzYXlzIHRoYXQgdGhlIGZlbmNlIHdpbGwgYmUKPiA+IGF0dGFjaGVkIHRvIHRoZSBwbGFu ZSBzdGF0ZS4gV291bGQgaXQgYmUgYmV0dGVyIHRvIGp1c3Qgc2F5Ogo+ID4gCj4gPiAgICogQHN0 YXRlOiBQbGFuZSBzdGF0ZQo+ID4gCj4gPiBBbm90aGVyIHdheSB0byBhc2sgdGhpcyBpczoKPiA+ IFNob3VsZCB0aGUgZG9jdW1lbnRhdGlvbiBiZSB0ZXJzZSBvciBzaG91bGQgaXQgYmUgcmVwZWF0 aW5nIGl0c2VsZj8KPiA+IAo+ID4gVGhlbiB3ZSBoYXZlIChjb3BpZWQgZnJvbSB0aGUgY21hIGxp YnJhcnkpOgo+ID4gCj4gPiAgICogQHBsYW5lOiBXaGljaCBwbGFuZQo+ID4gCj4gPiBXaGljaCBp cyBwcm9iYWJseSBzaG9ydCBmb3I6IFRoZSBwbGFuZSB3aGljaCB3ZSBhcmUgb3BlcmF0aW5nL2Fj dGluZyBvbi4KPiA+IAo+ID4gTW9yZSBwb3NzaWJpbGl0aWVzOgo+ID4gCj4gPiAgICogQHBsYW5l OiBEUk0gcGxhbmUKPiA+ICAgKiBAcGxhbmU6IFBsYW5lCj4gPiAgICogQHBsYW5lOiBUaGUgcGxh bmUgZm9yIHdoaWNoIGEgZnJhbWVidWZmZXIgaXMgcHJlcGFyZWQgZm9yIHNjYW5vdXQKPiA+IAo+ ID4gVGhlIHRleHQgZm9yIHRoZSBsYXN0IG9uZSBpcyBhbHNvIGF2YWlsYWJsZSB3aGVuIGNsaWNr aW5nIG9uIHRoZQo+ID4gJmRybV9wbGFuZV9oZWxwZXJfZnVuY3MucHJlcGFyZV9mYiBsaW5rLCBz byBpdCdzIHJlcGVhdGluZyBzb21ldGhpbmcKPiA+IHRoYXQgaXMgb25lIGNsaWNrIGF3YXkuCj4g Cj4gV3JpdGluZyBrZXJuZWxkb2MganVzdCBmb3IgdGhlIHNha2Ugb2YgaXQgaXMgbW9zdGx5IHBv aW50bGVzcy4gV2Ugc2hvdWxkIHdyaXRlIAo+IGRvY3VtZW50YXRpb24gdG8gbWFrZSBpdCBhcyB1 c2VmdWwgYW5kIGVhc3kgdG8gY29uc3VtZSBhcyBwb3NzaWJsZS4gS2VlcGluZyAKPiB0aGF0IGlu IG1pbmQsCj4gCj4gICogQHBsYW5lOiBQbGFuZQo+IAo+IGlzbid0IHZlcnkgdXNlZnVsLiBJdCdz IGNsZWFyIGZyb20gdGhlIGZ1bmN0aW9uIGFyZ3VtZW50IG5hbWUgKGFuZCB0eXBlKSB0aGF0IAo+ IGl0IGlzIGEgcG9pbnRlciB0byBhIHBsYW5lLiBJIHdvdWxkIHRodXMgYWR2b2NhdGUgZm9yIG1v cmUgZGV0YWlsZWQgcGFyYW1ldGVyIAo+IGRlc2NyaXB0aW9ucy4KClRoZXJlJ3MgdW5mb3J0dW5h dGVseSBhIGNlcnRhaW4gYW1vdW50IG9mIGJvaWxlcnBsYXRlIGluIHNvbWUgb2YgdGhlCmFyZ3Vt ZW50IGRvY3MuIEl0IGhhcHBlbnMsIGFuZCBhcyBsb25nIGFzIHRoZSBtYWluIHRleHQgZXhwbGFp bnMgaXQgYWxsLApJIHRoaW5rIGl0J3Mgb2sgdG8gaGF2ZSB0ZXJzZSBkb2MgbGlrZSB0aGlzLiBJ ZiB3ZSBwdXQgbm90aGluZywga2VybmVsLWRvYwp3aWxsIGNvbXBsYWluIChhbmQgdGhvc2Ugd2Fy bmluZ3MgYXJlIGtpbmRhIG5pY2UgdG8gc3BvdCBvdXRkYXRlZCBkb2NzKS4KClRoYW5rcywgRGFu aWVsCgo+ID4gSSBhbHdheXMgZ2V0IGNvbW1lbnRzIG9uIG15IGRvY3VtZW50YXRpb24sIHNvIGl0 J3MgY2xlYXJseSBzb21ldGhpbmcgSQo+ID4gbmVlZCB0byBmaW5kIGEgd2F5IHRvIGltcHJvdmUu Cj4gCj4gSSBkb24ndCB0aGluayBpdCdzIHNwZWNpZmljIHRvIHlvdXIgZG9jdW1lbnRhdGlvbi4g WW91J3JlIGRvaW5nIGEgZ3JlYXQgam9iLCAKPiBmb3Igd2hpY2ggSSdtIHBlcnNvbmFsbHkgZ3Jh dGVmdWwuIFRoZSBmYWN0IHRoYXQgd2UgaGF2ZW4ndCBkZWZpbmVkIGEgCj4gZG9jdW1lbnRhdGlv biBzdHlsZSBpbiBhIHNpbWlsYXIgd2F5IGFzIHdlIGhhdmUgZGVmaW5lZCBhIGNvZGluZyBzdHls ZSBpcyBhbiAKPiBpc3N1ZSBvZiB0aGUgRFJNL0tNUyBjb21tdW5pdHkuCj4gCj4gPiA+PiAgICog QGhhbmRsZTogaGFuZGxlIGNyZWF0ZWQKPiA+ID4+ICAgKgo+ID4gPj4gICAqIERyaXZlcnMgY2Fu IHVzZSB0aGlzIGFzIHRoZWlyICZkcm1fZnJhbWVidWZmZXJfZnVuY3MtPmNyZWF0ZV9oYW5kbGUK PiAKPiBbc25pcF0KPiAKPiAtLSAKPiBSZWdhcmRzLAo+IAo+IExhdXJlbnQgUGluY2hhcnQKPiAK PiBfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwo+IGRyaS1k ZXZlbCBtYWlsaW5nIGxpc3QKPiBkcmktZGV2ZWxAbGlzdHMuZnJlZWRlc2t0b3Aub3JnCj4gaHR0 cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9kcmktZGV2ZWwKCi0t IApEYW5pZWwgVmV0dGVyClNvZnR3YXJlIEVuZ2luZWVyLCBJbnRlbCBDb3Jwb3JhdGlvbgpodHRw Oi8vYmxvZy5mZndsbC5jaApfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fXwpkcmktZGV2ZWwgbWFpbGluZyBsaXN0CmRyaS1kZXZlbEBsaXN0cy5mcmVlZGVza3Rv cC5vcmcKaHR0cHM6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9kcmkt ZGV2ZWwK