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 11:44:01 +0100 Message-ID: <20151209104401.GO20822@phenom.ffwll.local> 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: Received: from mail-wm0-f45.google.com (mail-wm0-f45.google.com [74.125.82.45]) by gabe.freedesktop.org (Postfix) with ESMTPS id D4DA36E128 for ; Wed, 9 Dec 2015 02:44:05 -0800 (PST) Received: by wmvv187 with SMTP id v187so254655035wmv.1 for ; Wed, 09 Dec 2015 02:44:04 -0800 (PST) Content-Disposition: inline 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: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: DRI Development Cc: Daniel Vetter , Intel Graphics Development , Laurent Pinchart , Daniel Vetter List-Id: dri-devel@lists.freedesktop.org T24gV2VkLCBEZWMgMDksIDIwMTUgYXQgMTE6NDE6MzFBTSArMDEwMCwgRGFuaWVsIFZldHRlciB3 cm90ZToKPiBFdmVyeSB0aW1lIEkgdHlwZSBvciByZXZpZXcgZG9jcyB0aGlzIHNlZW1zIGEgYml0 IGRpZmZlcmVudC4gVHJ5IHRvCj4gZG9jdW1lbnQgdGhlIGNvbW1vbiBzdHlsZSBzbyB3ZSBjYW4g dHJ5IHRvIHVuaWZ5IGF0IGxlYXN0IG5ldyBkb2NzLgo+IAo+IHYyOiBTcGVsbGluZyBmaXhlcyBm cm9tIFBpZXJyZSwgTGF1cmVudCBhbmQgSmFuaS4KPiAKPiBDYzogUGllcnJlIE1vcmVhdSA8cGll cnJlLm1vcnJvd0BmcmVlLmZyPgo+IENjOiBKYW5pIE5pa3VsYSA8amFuaS5uaWt1bGFAbGludXgu aW50ZWwuY29tPgo+IENjOiBMYXVyZW50IFBpbmNoYXJ0IDxsYXVyZW50LnBpbmNoYXJ0QGlkZWFz b25ib2FyZC5jb20+Cj4gQWNrZWQtYnk6IExhdXJlbnQgUGluY2hhcnQgPGxhdXJlbnQucGluY2hh cnRAaWRlYXNvbmJvYXJkLmNvbT4KPiBTaWduZWQtb2ZmLWJ5OiBEYW5pZWwgVmV0dGVyIDxkYW5p ZWwudmV0dGVyQGludGVsLmNvbT4KPiBMaW5rOiBodHRwOi8vcGF0Y2h3b3JrLmZyZWVkZXNrdG9w Lm9yZy9wYXRjaC9tc2dpZC8xNDQ5NTY0NTYxLTM4OTYtMS1naXQtc2VuZC1lbWFpbC1kYW5pZWwu dmV0dGVyQGZmd2xsLmNoCgpPayBJIHB1bGxlZCB0aGF0IG9uZSBpbiwgdGhhbmtzIGZvciBhbGwg dGhlIGNvbW1lbnRzLiBMaWtlIEkgc2FpZCBpbiB0aGlzCnRocmVhZCwgdGhpcyBpcyBqdXN0IGEg c3RhcnQuIFNvIGlmIGFueW9uZSBoYXMgYW4gT0NEIGRvYyBzdHlsZSB0aGluZywKcGxlYXNlIGp1 c3QgYWRkIGl0IGhlcmUuCi1EYW5pZWwKPiAtLS0KPiAgRG9jdW1lbnRhdGlvbi9Eb2NCb29rL2dw dS50bXBsIHwgMzcgKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKwo+ICAxIGZp bGUgY2hhbmdlZCwgMzcgaW5zZXJ0aW9ucygrKQo+IAo+IGRpZmYgLS1naXQgYS9Eb2N1bWVudGF0 aW9uL0RvY0Jvb2svZ3B1LnRtcGwgYi9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svZ3B1LnRtcGwKPiBp bmRleCA3NDliOGUyZjIxMTMuLmNlNGQ2ZjAxNzI0MiAxMDA2NDQKPiAtLS0gYS9Eb2N1bWVudGF0 aW9uL0RvY0Jvb2svZ3B1LnRtcGwKPiArKysgYi9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svZ3B1LnRt cGwKPiBAQCAtMTI0LDYgKzEyNCw0MyBAQAo+ICAgICAgPHBhcmE+Cj4gICAgICAgIFtJbnNlcnQg ZGlhZ3JhbSBvZiB0eXBpY2FsIERSTSBzdGFjayBoZXJlXQo+ICAgICAgPC9wYXJhPgo+ICsgIDxz ZWN0MT4KPiArICAgIDx0aXRsZT5TdHlsZSBHdWlkZWxpbmVzPC90aXRsZT4KPiArICAgIDxwYXJh Pgo+ICsgICAgICBGb3IgY29uc2lzdGVuY3kgdGhlc2UgZG9jdW1lbnRhdGlvbnMgdXNlIEFtZXJp Y2FuIEVuZ2xpc2guIEFiYnJldmlhdGlvbnMKPiArICAgICAgYXJlIHdyaXR0ZW4gYXMgYWxsLXVw cGVyY2FzZSwgZm9yIGV4YW1wbGU6IERSTSwgS01TLCBJT0NUTCwgQ1JUQywgYW5kIHNvCj4gKyAg ICAgIG9uLiBUbyBhaWQgaW4gcmVhZGluZyBkb2N1bWVudGF0aW9ucyBtYWtlIGZ1bGwgdXNlIG9m IHRoZSBtYXJrdXAKPiArICAgICAgY2hhcmFjdGVycyBrZXJuZWxkb2MgcHJvdmlkZXM6IEBwYXJh bWV0ZXIgZm9yIGZ1bmN0aW9uIHBhcmFtdGVycywgQG1lbWJlcgo+ICsgICAgICBmb3Igc3RydWN0 dXJlIG1lbWJlcnMsICZhbXA7c3RydWN0dXJlIHRvIHJlZmVybmNlIHN0cnVjdHVyZXMgYW5kCj4g KyAgICAgIGZ1bmN0aW9uKCkgZm9yIGZ1bmN0aW9ucy4gVGhlc2UgYWxsIGdldCBhdXRvbWF0aWNh bGx5IGh5cGVybGlua2VkIGlmCj4gKyAgICAgIGtlcm5lbGRvYyBmb3IgdGhlIHJlZmVyZW5jZWMg b2JqZWN0cyBleGlzdHMgV2hlbiByZWZlcmVuY2luZyBlbnRyaWVzIGluCj4gKyAgICAgIGZ1bmN0 aW9uIHZ0YWJsZXMgcGxlYXNlIHVzZSAtJmx0O3ZmdW5jKCkuIE5vdGUgdGhhdCB3aXRoIGtlcm5l bGRvYyBkb2VzCj4gKyAgICAgIG5vdCBzdXBwb3J0IHJlZmVybmNpbmcgc3RydWN0IG1lbWJlcnMg ZGlyZWN0bHksIHNvIHBsZWFzZSBhZGQgYSByZWZlcmVuY2UKPiArICAgICAgdG8gdGhlIHZ0YWJs ZSBzdHJ1Y3Qgc29tZXdoZXJlIGluIHRoZSBzYW1lIHBhcmFncmFwaCBvciBhdCBsZWFzdCBzZWN0 aW9uLgo+ICsgICAgPC9wYXJhPgo+ICsgICAgPHBhcmE+Cj4gKyAgICAgIEV4Y2VwdCBpbiBzcGVj aWFsIHNpdHVhdGlvbnMgKHRvIHNlcGFyYXRlIGxvY2tlZCBmcm9tIHVubG9ja2VkIHZhcmlhbnRz KQo+ICsgICAgICBsb2NraW5nIHJlcXVpcmVtZW50cyBmb3IgZnVuY3Rpb25zIGFyZW4ndCBkb2N1 bWVudGVkIGluIHRoZSBrZXJuZWxkb2MuCj4gKyAgICAgIEluc3RlYWQgbG9ja2luZyBzaG91bGQg YmUgY2hlY2sgYXQgcnVudGltZSB1c2luZyBlLmcuCj4gKyAgICAgIDxjb2RlPldBUk5fT04oIW11 dGV4X2lzX2xvY2tlZCguLi4pKTs8L2NvZGU+LiBTaW5jZSBpdCdzIG11Y2ggZWFzaWVyIHRvCj4g KyAgICAgIGlnbm9yZSBkb2N1bWVudGF0aW9uIHRoYW4gcnVudGltZSBub2lzZSB0aGlzIHByb3Zp ZGVzIG1vcmUgdmFsdWUuIEFuZCBvbgo+ICsgICAgICB0b3Agb2YgdGhhdCBydW50aW1lIGNoZWNr cyBkbyBuZWVkIHRvIGJlIHVwZGF0ZWQgd2hlbiB0aGUgbG9ja2luZyBydWxlcwo+ICsgICAgICBj aGFuZ2UsIGluY3JlYXNpbmcgdGhlIGNoYW5nZXMgdGhhdCB0aGV5J3JlIGNvcnJlY3QuIFdpdGhp biB0aGUKPiArICAgICAgZG9jdW1lbnRhdGlvbiB0aGUgbG9ja2luZyBydWxlcyBzaG91bGQgYmUg ZXhwbGFpbmVkIGluIHRoZSByZWxldmFudAo+ICsgICAgICBzdHJ1Y3R1cmVzOiBFaXRoZXIgaW4g dGhlIGNvbW1lbnQgZm9yIHRoZSBsb2NrIGV4cGxhaW5pbmcgd2hhdCBpdAo+ICsgICAgICBwcm90 ZWN0cywgb3IgZGF0YSBmaWVsZHMgbmVlZCBhIG5vdGUgYWJvdXQgd2hpY2ggbG9jayBwcm90ZWN0 cyB0aGVtLCBvcgo+ICsgICAgICBib3RoLgo+ICsgICAgPC9wYXJhPgo+ICsgICAgPHBhcmE+Cj4g KyAgICAgIEZ1bmN0aW9ucyB3aGljaCBoYXZlIGEgbm9uLTxjb2RlPnZvaWQ8L2NvZGU+IHJldHVy biB2YWx1ZSBzaG91bGQgaGF2ZSBhCj4gKyAgICAgIHNlY3Rpb24gY2FsbGVkICJSZXR1cm5zIiBl eHBsYWluaW5nIHRoZSBleHBlY3RlZCByZXR1cm4gdmFsdWVzIGluCj4gKyAgICAgIGRpZmZlcmVu dCBjYXNlcyBhbiB0aGVpciBtZWFuaW5ncy4gQ3VycmVudGx5IHRoZXJlJ3Mgbm8gY29uc2Vuc3Vz IHdoZXRoZXIKPiArICAgICAgdGhhdCBzZWN0aW9uIG5hbWUgc2hvdWxkIGJlIGFsbCB1cHBlci1j YXNlIG9yIG5vdCwgYW5kIHdoZXRoZXIgaXQgc2hvdWxkCj4gKyAgICAgIGVuZCBpbiBhIGNvbG9u IG9yIG5vdC4gR28gd2l0aCB0aGUgZmlsZS1sb2NhbCBzdHlsZS4gT3RoZXIgY29tbW9uIHNlY3Rp b24KPiArICAgICAgbmFtZXMgYXJlICJOb3RlcyIgd2l0aCBpbmZvcm1hdGlvbiBmb3IgZGFuZ2Vy b3VzIG9yIHRyaWNreSBjb3JuZXIgY2FzZXMsCj4gKyAgICAgIGFuZCAiRklYTUUiIHdoZXJlIHRo ZSBpbnRlcmZhY2UgY291bGQgYmUgY2xlYW5lZCB1cC4KPiArICAgIDwvcGFyYT4KPiArICA8L3Nl Y3QxPgo+ICAgIDwvY2hhcHRlcj4KPiAgCj4gICAgPCEtLSBJbnRlcm5hbHMgLS0+Cj4gLS0gCj4g Mi41LjEKPiAKCi0tIApEYW5pZWwgVmV0dGVyClNvZnR3YXJlIEVuZ2luZWVyLCBJbnRlbCBDb3Jw b3JhdGlvbgpodHRwOi8vYmxvZy5mZndsbC5jaApfX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fXwpkcmktZGV2ZWwgbWFpbGluZyBsaXN0CmRyaS1kZXZlbEBsaXN0 cy5mcmVlZGVza3RvcC5vcmcKaHR0cDovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xp c3RpbmZvL2RyaS1kZXZlbAo=