From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jani Nikula Subject: Re: [PATCH] drm: Documentation style guide Date: Wed, 09 Dec 2015 13:21:09 +0200 Message-ID: <87h9jrx3yy.fsf@intel.com> References: <1617380.AVJsV4oWYx@avalon> <1449657691-6632-1-git-send-email-daniel.vetter@ffwll.ch> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <1449657691-6632-1-git-send-email-daniel.vetter@ffwll.ch> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: DRI Development Cc: Pierre Moreau , Daniel Vetter , Intel Graphics Development , Laurent Pinchart , Daniel Vetter List-Id: intel-gfx@lists.freedesktop.org T24gV2VkLCAwOSBEZWMgMjAxNSwgRGFuaWVsIFZldHRlciA8ZGFuaWVsLnZldHRlckBmZndsbC5j aD4gd3JvdGU6Cj4gRXZlcnkgdGltZSBJIHR5cGUgb3IgcmV2aWV3IGRvY3MgdGhpcyBzZWVtcyBh IGJpdCBkaWZmZXJlbnQuIFRyeSB0bwo+IGRvY3VtZW50IHRoZSBjb21tb24gc3R5bGUgc28gd2Ug Y2FuIHRyeSB0byB1bmlmeSBhdCBsZWFzdCBuZXcgZG9jcy4KPgo+IHYyOiBTcGVsbGluZyBmaXhl cyBmcm9tIFBpZXJyZSwgTGF1cmVudCBhbmQgSmFuaS4KCk5haCwgeW91IGlnbm9yZWQgbXkgY29t bWVudCBhYm91dCAidGhlc2UgZG9jdW1lbnRhdGlvbnMgdXNlIEFtZXJpY2FuCkVuZ2xpc2giLiA6 LwoKQlIsCkphbmkuCgo+Cj4gQ2M6IFBpZXJyZSBNb3JlYXUgPHBpZXJyZS5tb3Jyb3dAZnJlZS5m cj4KPiBDYzogSmFuaSBOaWt1bGEgPGphbmkubmlrdWxhQGxpbnV4LmludGVsLmNvbT4KPiBDYzog TGF1cmVudCBQaW5jaGFydCA8bGF1cmVudC5waW5jaGFydEBpZGVhc29uYm9hcmQuY29tPgo+IEFj a2VkLWJ5OiBMYXVyZW50IFBpbmNoYXJ0IDxsYXVyZW50LnBpbmNoYXJ0QGlkZWFzb25ib2FyZC5j b20+Cj4gU2lnbmVkLW9mZi1ieTogRGFuaWVsIFZldHRlciA8ZGFuaWVsLnZldHRlckBpbnRlbC5j b20+Cj4gTGluazogaHR0cDovL3BhdGNod29yay5mcmVlZGVza3RvcC5vcmcvcGF0Y2gvbXNnaWQv MTQ0OTU2NDU2MS0zODk2LTEtZ2l0LXNlbmQtZW1haWwtZGFuaWVsLnZldHRlckBmZndsbC5jaAo+ IC0tLQo+ICBEb2N1bWVudGF0aW9uL0RvY0Jvb2svZ3B1LnRtcGwgfCAzNyArKysrKysrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysrCj4gIDEgZmlsZSBjaGFuZ2VkLCAzNyBpbnNlcnRpb25z KCspCj4KPiBkaWZmIC0tZ2l0IGEvRG9jdW1lbnRhdGlvbi9Eb2NCb29rL2dwdS50bXBsIGIvRG9j dW1lbnRhdGlvbi9Eb2NCb29rL2dwdS50bXBsCj4gaW5kZXggNzQ5YjhlMmYyMTEzLi5jZTRkNmYw MTcyNDIgMTAwNjQ0Cj4gLS0tIGEvRG9jdW1lbnRhdGlvbi9Eb2NCb29rL2dwdS50bXBsCj4gKysr IGIvRG9jdW1lbnRhdGlvbi9Eb2NCb29rL2dwdS50bXBsCj4gQEAgLTEyNCw2ICsxMjQsNDMgQEAK PiAgICAgIDxwYXJhPgo+ICAgICAgICBbSW5zZXJ0IGRpYWdyYW0gb2YgdHlwaWNhbCBEUk0gc3Rh Y2sgaGVyZV0KPiAgICAgIDwvcGFyYT4KPiArICA8c2VjdDE+Cj4gKyAgICA8dGl0bGU+U3R5bGUg R3VpZGVsaW5lczwvdGl0bGU+Cj4gKyAgICA8cGFyYT4KPiArICAgICAgRm9yIGNvbnNpc3RlbmN5 IHRoZXNlIGRvY3VtZW50YXRpb25zIHVzZSBBbWVyaWNhbiBFbmdsaXNoLiBBYmJyZXZpYXRpb25z Cj4gKyAgICAgIGFyZSB3cml0dGVuIGFzIGFsbC11cHBlcmNhc2UsIGZvciBleGFtcGxlOiBEUk0s IEtNUywgSU9DVEwsIENSVEMsIGFuZCBzbwo+ICsgICAgICBvbi4gVG8gYWlkIGluIHJlYWRpbmcg ZG9jdW1lbnRhdGlvbnMgbWFrZSBmdWxsIHVzZSBvZiB0aGUgbWFya3VwCj4gKyAgICAgIGNoYXJh Y3RlcnMga2VybmVsZG9jIHByb3ZpZGVzOiBAcGFyYW1ldGVyIGZvciBmdW5jdGlvbiBwYXJhbXRl cnMsIEBtZW1iZXIKPiArICAgICAgZm9yIHN0cnVjdHVyZSBtZW1iZXJzLCAmYW1wO3N0cnVjdHVy ZSB0byByZWZlcm5jZSBzdHJ1Y3R1cmVzIGFuZAo+ICsgICAgICBmdW5jdGlvbigpIGZvciBmdW5j dGlvbnMuIFRoZXNlIGFsbCBnZXQgYXV0b21hdGljYWxseSBoeXBlcmxpbmtlZCBpZgo+ICsgICAg ICBrZXJuZWxkb2MgZm9yIHRoZSByZWZlcmVuY2VjIG9iamVjdHMgZXhpc3RzIFdoZW4gcmVmZXJl bmNpbmcgZW50cmllcyBpbgo+ICsgICAgICBmdW5jdGlvbiB2dGFibGVzIHBsZWFzZSB1c2UgLSZs dDt2ZnVuYygpLiBOb3RlIHRoYXQgd2l0aCBrZXJuZWxkb2MgZG9lcwo+ICsgICAgICBub3Qgc3Vw cG9ydCByZWZlcm5jaW5nIHN0cnVjdCBtZW1iZXJzIGRpcmVjdGx5LCBzbyBwbGVhc2UgYWRkIGEg cmVmZXJlbmNlCj4gKyAgICAgIHRvIHRoZSB2dGFibGUgc3RydWN0IHNvbWV3aGVyZSBpbiB0aGUg c2FtZSBwYXJhZ3JhcGggb3IgYXQgbGVhc3Qgc2VjdGlvbi4KPiArICAgIDwvcGFyYT4KPiArICAg IDxwYXJhPgo+ICsgICAgICBFeGNlcHQgaW4gc3BlY2lhbCBzaXR1YXRpb25zICh0byBzZXBhcmF0 ZSBsb2NrZWQgZnJvbSB1bmxvY2tlZCB2YXJpYW50cykKPiArICAgICAgbG9ja2luZyByZXF1aXJl bWVudHMgZm9yIGZ1bmN0aW9ucyBhcmVuJ3QgZG9jdW1lbnRlZCBpbiB0aGUga2VybmVsZG9jLgo+ ICsgICAgICBJbnN0ZWFkIGxvY2tpbmcgc2hvdWxkIGJlIGNoZWNrIGF0IHJ1bnRpbWUgdXNpbmcg ZS5nLgo+ICsgICAgICA8Y29kZT5XQVJOX09OKCFtdXRleF9pc19sb2NrZWQoLi4uKSk7PC9jb2Rl Pi4gU2luY2UgaXQncyBtdWNoIGVhc2llciB0bwo+ICsgICAgICBpZ25vcmUgZG9jdW1lbnRhdGlv biB0aGFuIHJ1bnRpbWUgbm9pc2UgdGhpcyBwcm92aWRlcyBtb3JlIHZhbHVlLiBBbmQgb24KPiAr ICAgICAgdG9wIG9mIHRoYXQgcnVudGltZSBjaGVja3MgZG8gbmVlZCB0byBiZSB1cGRhdGVkIHdo ZW4gdGhlIGxvY2tpbmcgcnVsZXMKPiArICAgICAgY2hhbmdlLCBpbmNyZWFzaW5nIHRoZSBjaGFu Z2VzIHRoYXQgdGhleSdyZSBjb3JyZWN0LiBXaXRoaW4gdGhlCj4gKyAgICAgIGRvY3VtZW50YXRp b24gdGhlIGxvY2tpbmcgcnVsZXMgc2hvdWxkIGJlIGV4cGxhaW5lZCBpbiB0aGUgcmVsZXZhbnQK PiArICAgICAgc3RydWN0dXJlczogRWl0aGVyIGluIHRoZSBjb21tZW50IGZvciB0aGUgbG9jayBl eHBsYWluaW5nIHdoYXQgaXQKPiArICAgICAgcHJvdGVjdHMsIG9yIGRhdGEgZmllbGRzIG5lZWQg YSBub3RlIGFib3V0IHdoaWNoIGxvY2sgcHJvdGVjdHMgdGhlbSwgb3IKPiArICAgICAgYm90aC4K PiArICAgIDwvcGFyYT4KPiArICAgIDxwYXJhPgo+ICsgICAgICBGdW5jdGlvbnMgd2hpY2ggaGF2 ZSBhIG5vbi08Y29kZT52b2lkPC9jb2RlPiByZXR1cm4gdmFsdWUgc2hvdWxkIGhhdmUgYQo+ICsg ICAgICBzZWN0aW9uIGNhbGxlZCAiUmV0dXJucyIgZXhwbGFpbmluZyB0aGUgZXhwZWN0ZWQgcmV0 dXJuIHZhbHVlcyBpbgo+ICsgICAgICBkaWZmZXJlbnQgY2FzZXMgYW4gdGhlaXIgbWVhbmluZ3Mu IEN1cnJlbnRseSB0aGVyZSdzIG5vIGNvbnNlbnN1cyB3aGV0aGVyCj4gKyAgICAgIHRoYXQgc2Vj dGlvbiBuYW1lIHNob3VsZCBiZSBhbGwgdXBwZXItY2FzZSBvciBub3QsIGFuZCB3aGV0aGVyIGl0 IHNob3VsZAo+ICsgICAgICBlbmQgaW4gYSBjb2xvbiBvciBub3QuIEdvIHdpdGggdGhlIGZpbGUt bG9jYWwgc3R5bGUuIE90aGVyIGNvbW1vbiBzZWN0aW9uCj4gKyAgICAgIG5hbWVzIGFyZSAiTm90 ZXMiIHdpdGggaW5mb3JtYXRpb24gZm9yIGRhbmdlcm91cyBvciB0cmlja3kgY29ybmVyIGNhc2Vz LAo+ICsgICAgICBhbmQgIkZJWE1FIiB3aGVyZSB0aGUgaW50ZXJmYWNlIGNvdWxkIGJlIGNsZWFu ZWQgdXAuCj4gKyAgICA8L3BhcmE+Cj4gKyAgPC9zZWN0MT4KPiAgICA8L2NoYXB0ZXI+Cj4gIAo+ ICAgIDwhLS0gSW50ZXJuYWxzIC0tPgoKLS0gCkphbmkgTmlrdWxhLCBJbnRlbCBPcGVuIFNvdXJj ZSBUZWNobm9sb2d5IENlbnRlcgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fXwpJbnRlbC1nZnggbWFpbGluZyBsaXN0CkludGVsLWdmeEBsaXN0cy5mcmVlZGVz a3RvcC5vcmcKaHR0cDovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2lu dGVsLWdmeAo=