From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniel Vetter Subject: Re: [PATCH] drm: Documentation style guide Date: Wed, 9 Dec 2015 14:35:02 +0100 Message-ID: <20151209133502.GQ20822@phenom.ffwll.local> References: <1617380.AVJsV4oWYx@avalon> <1449657691-6632-1-git-send-email-daniel.vetter@ffwll.ch> <87h9jrx3yy.fsf@intel.com> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: Received: from mail-wm0-f50.google.com (mail-wm0-f50.google.com [74.125.82.50]) by gabe.freedesktop.org (Postfix) with ESMTPS id EB8376E015 for ; Wed, 9 Dec 2015 05:35:06 -0800 (PST) Received: by wmww144 with SMTP id w144so222532800wmw.1 for ; Wed, 09 Dec 2015 05:35:05 -0800 (PST) Content-Disposition: inline In-Reply-To: <87h9jrx3yy.fsf@intel.com> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Jani Nikula Cc: Daniel Vetter , Intel Graphics Development , DRI Development , Laurent Pinchart , Daniel Vetter List-Id: dri-devel@lists.freedesktop.org T24gV2VkLCBEZWMgMDksIDIwMTUgYXQgMDE6MjE6MDlQTSArMDIwMCwgSmFuaSBOaWt1bGEgd3Jv dGU6Cj4gT24gV2VkLCAwOSBEZWMgMjAxNSwgRGFuaWVsIFZldHRlciA8ZGFuaWVsLnZldHRlckBm ZndsbC5jaD4gd3JvdGU6Cj4gPiBFdmVyeSB0aW1lIEkgdHlwZSBvciByZXZpZXcgZG9jcyB0aGlz IHNlZW1zIGEgYml0IGRpZmZlcmVudC4gVHJ5IHRvCj4gPiBkb2N1bWVudCB0aGUgY29tbW9uIHN0 eWxlIHNvIHdlIGNhbiB0cnkgdG8gdW5pZnkgYXQgbGVhc3QgbmV3IGRvY3MuCj4gPgo+ID4gdjI6 IFNwZWxsaW5nIGZpeGVzIGZyb20gUGllcnJlLCBMYXVyZW50IGFuZCBKYW5pLgo+IAo+IE5haCwg eW91IGlnbm9yZWQgbXkgY29tbWVudCBhYm91dCAidGhlc2UgZG9jdW1lbnRhdGlvbnMgdXNlIEFt ZXJpY2FuCj4gRW5nbGlzaCIuIDovCgpXZWxsIEkgZGlkIHR5cGUgdGhlbSBhbGwgaW4sIGJ1dCB0 b3RhbGx5IGZhaWxlZCB0byBydW4gZ2l0IGFkZCBiZWZvcmUKaGl0dGluZyBzZW5kLiBGaXhlZCBu b3cuCi1EYW5pZWwKCj4gCj4gQlIsCj4gSmFuaS4KPiAKPiA+Cj4gPiBDYzogUGllcnJlIE1vcmVh dSA8cGllcnJlLm1vcnJvd0BmcmVlLmZyPgo+ID4gQ2M6IEphbmkgTmlrdWxhIDxqYW5pLm5pa3Vs YUBsaW51eC5pbnRlbC5jb20+Cj4gPiBDYzogTGF1cmVudCBQaW5jaGFydCA8bGF1cmVudC5waW5j aGFydEBpZGVhc29uYm9hcmQuY29tPgo+ID4gQWNrZWQtYnk6IExhdXJlbnQgUGluY2hhcnQgPGxh dXJlbnQucGluY2hhcnRAaWRlYXNvbmJvYXJkLmNvbT4KPiA+IFNpZ25lZC1vZmYtYnk6IERhbmll bCBWZXR0ZXIgPGRhbmllbC52ZXR0ZXJAaW50ZWwuY29tPgo+ID4gTGluazogaHR0cDovL3BhdGNo d29yay5mcmVlZGVza3RvcC5vcmcvcGF0Y2gvbXNnaWQvMTQ0OTU2NDU2MS0zODk2LTEtZ2l0LXNl bmQtZW1haWwtZGFuaWVsLnZldHRlckBmZndsbC5jaAo+ID4gLS0tCj4gPiAgRG9jdW1lbnRhdGlv bi9Eb2NCb29rL2dwdS50bXBsIHwgMzcgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr KysrKwo+ID4gIDEgZmlsZSBjaGFuZ2VkLCAzNyBpbnNlcnRpb25zKCspCj4gPgo+ID4gZGlmZiAt LWdpdCBhL0RvY3VtZW50YXRpb24vRG9jQm9vay9ncHUudG1wbCBiL0RvY3VtZW50YXRpb24vRG9j Qm9vay9ncHUudG1wbAo+ID4gaW5kZXggNzQ5YjhlMmYyMTEzLi5jZTRkNmYwMTcyNDIgMTAwNjQ0 Cj4gPiAtLS0gYS9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svZ3B1LnRtcGwKPiA+ICsrKyBiL0RvY3Vt ZW50YXRpb24vRG9jQm9vay9ncHUudG1wbAo+ID4gQEAgLTEyNCw2ICsxMjQsNDMgQEAKPiA+ICAg ICAgPHBhcmE+Cj4gPiAgICAgICAgW0luc2VydCBkaWFncmFtIG9mIHR5cGljYWwgRFJNIHN0YWNr IGhlcmVdCj4gPiAgICAgIDwvcGFyYT4KPiA+ICsgIDxzZWN0MT4KPiA+ICsgICAgPHRpdGxlPlN0 eWxlIEd1aWRlbGluZXM8L3RpdGxlPgo+ID4gKyAgICA8cGFyYT4KPiA+ICsgICAgICBGb3IgY29u c2lzdGVuY3kgdGhlc2UgZG9jdW1lbnRhdGlvbnMgdXNlIEFtZXJpY2FuIEVuZ2xpc2guIEFiYnJl dmlhdGlvbnMKPiA+ICsgICAgICBhcmUgd3JpdHRlbiBhcyBhbGwtdXBwZXJjYXNlLCBmb3IgZXhh bXBsZTogRFJNLCBLTVMsIElPQ1RMLCBDUlRDLCBhbmQgc28KPiA+ICsgICAgICBvbi4gVG8gYWlk IGluIHJlYWRpbmcgZG9jdW1lbnRhdGlvbnMgbWFrZSBmdWxsIHVzZSBvZiB0aGUgbWFya3VwCj4g PiArICAgICAgY2hhcmFjdGVycyBrZXJuZWxkb2MgcHJvdmlkZXM6IEBwYXJhbWV0ZXIgZm9yIGZ1 bmN0aW9uIHBhcmFtdGVycywgQG1lbWJlcgo+ID4gKyAgICAgIGZvciBzdHJ1Y3R1cmUgbWVtYmVy cywgJmFtcDtzdHJ1Y3R1cmUgdG8gcmVmZXJuY2Ugc3RydWN0dXJlcyBhbmQKPiA+ICsgICAgICBm dW5jdGlvbigpIGZvciBmdW5jdGlvbnMuIFRoZXNlIGFsbCBnZXQgYXV0b21hdGljYWxseSBoeXBl cmxpbmtlZCBpZgo+ID4gKyAgICAgIGtlcm5lbGRvYyBmb3IgdGhlIHJlZmVyZW5jZWMgb2JqZWN0 cyBleGlzdHMgV2hlbiByZWZlcmVuY2luZyBlbnRyaWVzIGluCj4gPiArICAgICAgZnVuY3Rpb24g dnRhYmxlcyBwbGVhc2UgdXNlIC0mbHQ7dmZ1bmMoKS4gTm90ZSB0aGF0IHdpdGgga2VybmVsZG9j IGRvZXMKPiA+ICsgICAgICBub3Qgc3VwcG9ydCByZWZlcm5jaW5nIHN0cnVjdCBtZW1iZXJzIGRp cmVjdGx5LCBzbyBwbGVhc2UgYWRkIGEgcmVmZXJlbmNlCj4gPiArICAgICAgdG8gdGhlIHZ0YWJs ZSBzdHJ1Y3Qgc29tZXdoZXJlIGluIHRoZSBzYW1lIHBhcmFncmFwaCBvciBhdCBsZWFzdCBzZWN0 aW9uLgo+ID4gKyAgICA8L3BhcmE+Cj4gPiArICAgIDxwYXJhPgo+ID4gKyAgICAgIEV4Y2VwdCBp biBzcGVjaWFsIHNpdHVhdGlvbnMgKHRvIHNlcGFyYXRlIGxvY2tlZCBmcm9tIHVubG9ja2VkIHZh cmlhbnRzKQo+ID4gKyAgICAgIGxvY2tpbmcgcmVxdWlyZW1lbnRzIGZvciBmdW5jdGlvbnMgYXJl bid0IGRvY3VtZW50ZWQgaW4gdGhlIGtlcm5lbGRvYy4KPiA+ICsgICAgICBJbnN0ZWFkIGxvY2tp bmcgc2hvdWxkIGJlIGNoZWNrIGF0IHJ1bnRpbWUgdXNpbmcgZS5nLgo+ID4gKyAgICAgIDxjb2Rl PldBUk5fT04oIW11dGV4X2lzX2xvY2tlZCguLi4pKTs8L2NvZGU+LiBTaW5jZSBpdCdzIG11Y2gg ZWFzaWVyIHRvCj4gPiArICAgICAgaWdub3JlIGRvY3VtZW50YXRpb24gdGhhbiBydW50aW1lIG5v aXNlIHRoaXMgcHJvdmlkZXMgbW9yZSB2YWx1ZS4gQW5kIG9uCj4gPiArICAgICAgdG9wIG9mIHRo YXQgcnVudGltZSBjaGVja3MgZG8gbmVlZCB0byBiZSB1cGRhdGVkIHdoZW4gdGhlIGxvY2tpbmcg cnVsZXMKPiA+ICsgICAgICBjaGFuZ2UsIGluY3JlYXNpbmcgdGhlIGNoYW5nZXMgdGhhdCB0aGV5 J3JlIGNvcnJlY3QuIFdpdGhpbiB0aGUKPiA+ICsgICAgICBkb2N1bWVudGF0aW9uIHRoZSBsb2Nr aW5nIHJ1bGVzIHNob3VsZCBiZSBleHBsYWluZWQgaW4gdGhlIHJlbGV2YW50Cj4gPiArICAgICAg c3RydWN0dXJlczogRWl0aGVyIGluIHRoZSBjb21tZW50IGZvciB0aGUgbG9jayBleHBsYWluaW5n IHdoYXQgaXQKPiA+ICsgICAgICBwcm90ZWN0cywgb3IgZGF0YSBmaWVsZHMgbmVlZCBhIG5vdGUg YWJvdXQgd2hpY2ggbG9jayBwcm90ZWN0cyB0aGVtLCBvcgo+ID4gKyAgICAgIGJvdGguCj4gPiAr ICAgIDwvcGFyYT4KPiA+ICsgICAgPHBhcmE+Cj4gPiArICAgICAgRnVuY3Rpb25zIHdoaWNoIGhh dmUgYSBub24tPGNvZGU+dm9pZDwvY29kZT4gcmV0dXJuIHZhbHVlIHNob3VsZCBoYXZlIGEKPiA+ ICsgICAgICBzZWN0aW9uIGNhbGxlZCAiUmV0dXJucyIgZXhwbGFpbmluZyB0aGUgZXhwZWN0ZWQg cmV0dXJuIHZhbHVlcyBpbgo+ID4gKyAgICAgIGRpZmZlcmVudCBjYXNlcyBhbiB0aGVpciBtZWFu aW5ncy4gQ3VycmVudGx5IHRoZXJlJ3Mgbm8gY29uc2Vuc3VzIHdoZXRoZXIKPiA+ICsgICAgICB0 aGF0IHNlY3Rpb24gbmFtZSBzaG91bGQgYmUgYWxsIHVwcGVyLWNhc2Ugb3Igbm90LCBhbmQgd2hl dGhlciBpdCBzaG91bGQKPiA+ICsgICAgICBlbmQgaW4gYSBjb2xvbiBvciBub3QuIEdvIHdpdGgg dGhlIGZpbGUtbG9jYWwgc3R5bGUuIE90aGVyIGNvbW1vbiBzZWN0aW9uCj4gPiArICAgICAgbmFt ZXMgYXJlICJOb3RlcyIgd2l0aCBpbmZvcm1hdGlvbiBmb3IgZGFuZ2Vyb3VzIG9yIHRyaWNreSBj b3JuZXIgY2FzZXMsCj4gPiArICAgICAgYW5kICJGSVhNRSIgd2hlcmUgdGhlIGludGVyZmFjZSBj b3VsZCBiZSBjbGVhbmVkIHVwLgo+ID4gKyAgICA8L3BhcmE+Cj4gPiArICA8L3NlY3QxPgo+ID4g ICAgPC9jaGFwdGVyPgo+ID4gIAo+ID4gICAgPCEtLSBJbnRlcm5hbHMgLS0+Cj4gCj4gLS0gCj4g SmFuaSBOaWt1bGEsIEludGVsIE9wZW4gU291cmNlIFRlY2hub2xvZ3kgQ2VudGVyCgotLSAKRGFu aWVsIFZldHRlcgpTb2Z0d2FyZSBFbmdpbmVlciwgSW50ZWwgQ29ycG9yYXRpb24KaHR0cDovL2Js b2cuZmZ3bGwuY2gKX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X18KZHJpLWRldmVsIG1haWxpbmcgbGlzdApkcmktZGV2ZWxAbGlzdHMuZnJlZWRlc2t0b3Aub3Jn Cmh0dHA6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1hbi9saXN0aW5mby9kcmktZGV2ZWwK