From mboxrd@z Thu Jan 1 00:00:00 1970 From: Laurent Pinchart Subject: Re: [PATCH 1/5] [RFC] drm: Documentation style guide Date: Tue, 08 Dec 2015 15:49:03 +0200 Message-ID: <1617380.AVJsV4oWYx@avalon> References: <1449564561-3896-1-git-send-email-daniel.vetter@ffwll.ch> <20151208095905.GA5523@Sovereign.cs.lth.se> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20151208095905.GA5523@Sovereign.cs.lth.se> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: dri-devel@lists.freedesktop.org Cc: Daniel Vetter , Intel Graphics Development , Daniel Vetter List-Id: intel-gfx@lists.freedesktop.org SGVsbG8sCgpPbiBUdWVzZGF5IDA4IERlY2VtYmVyIDIwMTUgMTA6NTk6MDUgUGllcnJlIE1vcmVh dSB3cm90ZToKPiBPbiAwOTo0OSBBTSAtIERlYyAwOCAyMDE1LCBEYW5pZWwgVmV0dGVyIHdyb3Rl Ogo+ID4gRXZlcnkgdGltZSBJIHR5cGUgb3IgcmV2aWV3IGRvY3MgdGhpcyBzZWVtcyBhIGJpdCBk aWZmZXJlbnQuIFRyeSB0bwo+ID4gZG9jdW1lbnQgdGhlIGNvbW1vbiBzdHlsZSBzbyB3ZSBjYW4g dHJ5IHRvIHVuaWZ5IGF0IGxlYXN0IG5ldyBkb2NzLgo+ID4gCj4gPiBTaWduZWQtb2ZmLWJ5OiBE YW5pZWwgVmV0dGVyIDxkYW5pZWwudmV0dGVyQGludGVsLmNvbT4KPiA+IC0tLQo+ID4gCj4gPiAg RG9jdW1lbnRhdGlvbi9Eb2NCb29rL2dwdS50bXBsIHwgMzcgKysrKysrKysrKysrKysrKysrKysr KysrKysrKysrKysrKysrKwo+ID4gIDEgZmlsZSBjaGFuZ2VkLCAzNyBpbnNlcnRpb25zKCspCj4g PiAKPiA+IGRpZmYgLS1naXQgYS9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svZ3B1LnRtcGwKPiA+IGIv RG9jdW1lbnRhdGlvbi9Eb2NCb29rL2dwdS50bXBsIGluZGV4IDg2ZTViMTJhNDliYS4uNTY5OGM5 M2RhZThiIDEwMDY0NAo+ID4gLS0tIGEvRG9jdW1lbnRhdGlvbi9Eb2NCb29rL2dwdS50bXBsCj4g PiArKysgYi9Eb2N1bWVudGF0aW9uL0RvY0Jvb2svZ3B1LnRtcGwKPiA+IEBAIC0xMjQsNiArMTI0 LDQzIEBACj4gPiAgICAgIDxwYXJhPgo+ID4gICAgICAgIFtJbnNlcnQgZGlhZ3JhbSBvZiB0eXBp Y2FsIERSTSBzdGFjayBoZXJlXQo+ID4gICAgICA8L3BhcmE+Cj4gPiArICA8c2VjdDE+Cj4gPiAr ICAgIDx0aXRsZT5TdHlsZSBHdWlkZWxpbmVzPC90aXRsZT4KPiA+ICsgICAgPHBhcmE+Cj4gPiAr ICAgICAgRm9yIGNvbnNpc3RlbmN5IHRoZXNlIGRvY3VtZW50YXRpb25zIHVzZSBBbWVyaWNhbiBF bmdsaXNoLgo+ID4gQWJicmV2aWF0aW9ucwo+ID4gKyAgICAgIGFyZSB3cml0dGVuIGFzIGFsbC11 cHBlcmNhc2UsIGZvciBleGFtcGxlOiBEUk0sIEtNUywgSU9DVEwsIENSVEMsCj4gPiBhbmQgc28K PiA+ICsgICAgICBvbi4gVG8gYWlkIGluIHJlYWRpbmcgZG9jdW1lbnRhdGlvbnMgbWFrZSBmdWxs IHVzZSBvZiB0aGUgbWFya3VwCj4gPiArICAgICAgY2hhcmFjdGVycyBrZXJuZWxkb2MgcHJvdmlk ZXM6IEBwYXJhbWV0ZXIgZm9yIGZ1bmN0aW9uIHBhcmFtdGVycywKPiA+IEBtZW1iZXIKPgo+IHBh cmFtdGVycyAtPiBwYXJhbWV0ZXJzCj4gCj4gPiArICAgICAgZm9yIHN0cnVjdHVyZSBtZW1iZXJz LCAmYW1wO3N0cnVjdHVyZSB0byByZWZlcm5jZSBzdHJ1Y3R1cmVzIGFuZAo+IAo+IHJlZmVybmNl IC0+IHJlZmVyZW5jZQo+IAo+ID4gKyAgICAgIGZ1bmN0aW9uKCkgZm9yIGZ1bmN0aW9ucy4gVGhl c2UgYWxsIGdldCBhdXRvbWF0aWNhbGx5IGh5cGVybGlua2VkCj4gPiBpZgo+ID4gKyAgICAgIGtl cm5lbGRvYyBmb3IgdGhlIHJlZmVyZW5jZWMgb2JqZWN0cyBleGlzdHMgV2hlbiByZWZlcmVuY2lu Zwo+ID4gZW50cmllcyBpbgo+Cj4gcmVmZXJlbmNlYyAtPiByZWZlcmVuY2VkLCBtaXNzaW5nICcu JyBhZnRlciBleGlzdHMKPiAKPiA+ICsgICAgICBmdW5jdGlvbiB2dGFibGVzIHBsZWFzZSB1c2Ug LSZsdDt2ZnVuYygpLiBOb3RlIHRoYXQgd2l0aCBrZXJuZWxkb2MKPiA+IGRvZXMKPgo+IElzbid0 ICJ3aXRoIiB0b28gbXVjaCBoZXJlPyAiTm90ZSB0aGF0IGtlcm5lbGRvYyBkb2VzIG5vdCBb4oCm XSI/Cj4gCj4gPiArICAgICAgbm90IHN1cHBvcnQgcmVmZXJuY2luZyBzdHJ1Y3QgbWVtYmVycyBk aXJlY3RseSwgc28gcGxlYXNlIGFkZCBhCj4gPiByZWZlcmVuY2UKPgo+IHJlZmVybmNpbmcgLT4g cmVmZXJlbmNpbmcKPiAKPiA+ICsgICAgICB0byB0aGUgdnRhYmxlIHN0cnVjdCBzb21ld2hlcmUg aW4gdGhlIHNhbWUgcGFyYWdyYXBoIG9yIGF0IGxlYXN0Cj4gPiBzZWN0aW9uLgo+ID4gKyAgICA8 L3BhcmE+Cj4gPiArICAgIDxwYXJhPgo+ID4gKyAgICAgIEV4Y2VwdCBpbiBzcGVjaWFsIHNpdHVh dGlvbnMgKHRvIHNlcGFyYXRlIGxvY2tlZCBmcm9tIHVubG9ja2VkCj4gPiB2YXJpYW50cykKPiA+ ICsgICAgICBsb2NraW5nIHJlcXVpcmVtZW50cyBmb3IgZnVuY3Rpb25zIGFyZW4ndCBkb2N1bWVu dGVkIGluIHRoZQo+ID4ga2VybmVsZG9jLgo+ID4gKyAgICAgIEluc3RlYWQgbG9ja2luZyBzaG91 bGQgYmUgY2hlY2sgYXQgcnVudGltZSB1c2luZyBlLmcuCj4gPiArICAgICAgPGNvZGU+V0FSTl9P TighbXV0ZXhfaXNfbG9ja2VkKC4uLikpOzwvY29kZT4uIFNpbmNlIGl0J3MgbXVjaAo+ID4gZWFz aWVyIHRvCj4gPiArICAgICAgaWdub3JlIGRvY3VtZW50YXRpb24gdGhhbiBydW50aW1lIG5vaXNl IHRoaXMgcHJvdmlkZXMgbW9yZSB2YWx1ZS4KPiA+IEFuZCBvbgo+ID4gKyAgICAgIHRvcCBvZiB0 aGF0IHJ1bnRpbWUgY2hlY2tzIGRvIG5lZWQgdG8gYmUgdXBkYXRlZCB3aGVuIHRoZSBsb2NraW5n Cj4gPiBydWxlcwo+ID4gKyAgICAgIGNoYW5nZSwgaW5jcmVhc2luZyB0aGUgY2hhbmdlcyB0aGF0 IHRoZXkncmUgY29ycmVjdC4gV2l0aGluIHRoZQoKcy9jaGFuZ2VzL2NoYW5jZXMvCgo+ID4gKyAg ICAgIGRvY3VtZW50YXRpb24gdGhlIGxvY2tpbmcgcnVsZXMgc2hvdWxkIGJlIGV4cGxhaW5lZCBp biB0aGUgcmVsZXZhbnQKPiA+ICsgICAgICBzdHJ1Y3R1cmVzOiBFaXRoZXIgaW4gdGhlIGNvbW1l bnQgZm9yIHRoZSBsb2NrIGV4cGxhaW5pbmcgd2hhdCBpdAo+ID4gKyAgICAgIHByb3RlY3RzLCBv ciBkYXRhIGZpZWxkcyBuZWVkIGEgbm90ZSBhYm91dCB3aGljaCBsb2NrIHByb3RlY3RzCj4gPiB0 aGVtLCBvcgo+ID4gKyAgICAgIGJvdGguCj4gPiArICAgIDwvcGFyYT4KPiA+ICsgICAgPHBhcmE+ Cj4gPiArICAgICAgRnVuY3Rpb25zIHdoaWNoIGhhdmUgYSBub24tPGNvZGU+dm9pZDwvY29kZT4g cmV0dXJuIHZhbHVlIHNob3VsZAo+ID4gaGF2ZSBhCj4gPiArICAgICAgc2VjdGlvbiBjYWxsZWQg IlJldHVybnMiIGV4cGxhaW5pbmcgdGhlIGV4cGVjdGVkIHJldHVybiB2YWx1ZXMgaW4KPiA+ICsg ICAgICBkaWZmZXJlbnQgY2FzZXMgYW4gdGhlaXIgbWVhbmluZ3MuIEN1cnJlbnRseSB0aGVyZSdz IG5vIGNvbnNlbnN1cwoKcy9hbi9hbmQvCgpBcGFydCBmcm9tIHRoYXQsCgpBY2tlZC1ieTogTGF1 cmVudCBQaW5jaGFydCA8bGF1cmVudC5waW5jaGFydEBpZGVhc29uYm9hcmQuY29tPgoKPiA+IHdo ZXRoZXIKPiA+ICsgICAgICB0aGF0IHNlY3Rpb24gbmFtZSBzaG91bGQgYmUgYWxsIHVwcGVyLWNh c2Ugb3Igbm90LCBhbmQgd2hldGhlciBpdAo+ID4gc2hvdWxkCj4gPiArICAgICAgZW5kIGluIGEg Y29sb24gb3Igbm90LiBHbyB3aXRoIHRoZSBmaWxlLWxvY2FsIHN0eWxlLiBPdGhlciBjb21tb24K PiA+IHNlY3Rpb24KPiA+ICsgICAgICBuYW1lcyBhcmUgIk5vdGVzIiB3aXRoIGluZm9ybWF0aW9u IGZvciBkYW5nZXJvdXMgb3IgdHJpY2t5IGNvcm5lcgo+ID4gY2FzZXMsCj4gPiArICAgICAgYW5k ICJGSVhNRSIgd2hlcmUgdGhlIGludGVyZmFjZSBjb3VsZCBiZSBjbGVhbmVkIHVwLgo+IAo+IFdo eSBub3QgZGVmaW5lIChhbmQgdXNlKSBhIHNpbmdsZSBzdHlsZSBmb3IgbmFtaW5nIGFsbCBzZWN0 aW9ucz8gT2xkCj4gZG9jdW1lbnRhdGlvbiBtaWdodCBub3QgdXNlIGl0LCBidXQgaXQgc2hvdWxk IGJlIGRvYWJsZSB0byB1cGdyYWRlIHRob3NlIG9sZAo+IGRvY3VtZW50cy4KPiAKPiA+ICsgICAg PC9wYXJhPgo+ID4gKyAgPC9zZWN0MT4KPiA+IAo+ID4gICAgPC9jaGFwdGVyPgo+ID4gICAgPCEt LSBJbnRlcm5hbHMgLS0+CgotLSAKUmVnYXJkcywKCkxhdXJlbnQgUGluY2hhcnQKCl9fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmRyaS1kZXZlbCBtYWlsaW5n IGxpc3QKZHJpLWRldmVsQGxpc3RzLmZyZWVkZXNrdG9wLm9yZwpodHRwOi8vbGlzdHMuZnJlZWRl c2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vZHJpLWRldmVsCg==