From mboxrd@z Thu Jan 1 00:00:00 1970 From: Lukas Wunner Subject: Re: [PATCH] drm: Documentation style guide Date: Wed, 9 Dec 2015 16:19:42 +0100 Message-ID: <20151209151942.GA29631@wunner.de> 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: 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: Daniel Vetter Cc: Intel Graphics Development , DRI Development List-Id: dri-devel@lists.freedesktop.org SGksCgpJIHdvdWxkbid0IG5vcm1hbGx5IG5pdHBpY2sgbGlrZSB0aGlzIGJ1dCBzaW5jZSBJIHdh cyByZWFkaW5nIGl0IGFueXdheQphbmQgeW91IHdlcmUgYXNraW5nIGZvciAiT0NEIGRvYyBzdHls ZSB0aGluZyIuIDotKQoKVGhpcyBpcyBhIHByb29mcmVhZCBvZiB0aGUgZm9yY2UtcHVzaGVkIHYy IGluIGRybS1pbnRlbC1uaWdodGx5Cig5YTg3MzBkZGZlMWQpLgoKCj4gKyAgPHNlY3QxPgo+ICsg ICAgPHRpdGxlPlN0eWxlIEd1aWRlbGluZXM8L3RpdGxlPgo+ICsgICAgPHBhcmE+Cj4gKyAgICAg IEZvciBjb25zaXN0ZW5jeSB0aGlzIGRvY3VtZW50YXRpb24gdXNlIEFtZXJpY2FuIEVuZ2xpc2gu IEFiYnJldmlhdGlvbnMKICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg ICAgICBeCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgcy91 c2UvdXNlcy8KCj4gKyAgICAgIGFyZSB3cml0dGVuIGFzIGFsbC11cHBlcmNhc2UsIGZvciBleGFt cGxlOiBEUk0sIEtNUywgSU9DVEwsIENSVEMsIGFuZCBzbwo+ICsgICAgICBvbi4gVG8gYWlkIGlu IHJlYWRpbmcgZG9jdW1lbnRhdGlvbnMgbWFrZSBmdWxsIHVzZSBvZiB0aGUgbWFya3VwCiAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgIF4KICAgICAgICAgICAgICAgICAgICAgICAgICAgICAg aW5zZXJ0IGNvbW1hCgo+ICsgICAgICBjaGFyYWN0ZXJzIGtlcm5lbGRvYyBwcm92aWRlczogQHBh cmFtZXRlciBmb3IgZnVuY3Rpb24gcGFyYW1ldGVycywgQG1lbWJlcgo+ICsgICAgICBmb3Igc3Ry dWN0dXJlIG1lbWJlcnMsICZhbXA7c3RydWN0dXJlIHRvIHJlZmVyZW5jZSBzdHJ1Y3R1cmVzIGFu ZAo+ICsgICAgICBmdW5jdGlvbigpIGZvciBmdW5jdGlvbnMuIFRoZXNlIGFsbCBnZXQgYXV0b21h dGljYWxseSBoeXBlcmxpbmtlZCBpZgo+ICsgICAgICBrZXJuZWxkb2MgZm9yIHRoZSByZWZlcmVu Y2VkIG9iamVjdHMgZXhpc3RzLiBXaGVuIHJlZmVyZW5jaW5nIGVudHJpZXMgaW4KPiArICAgICAg ZnVuY3Rpb24gdnRhYmxlcyBwbGVhc2UgdXNlIC0mbHQ7dmZ1bmMoKS4gTm90ZSB0aGF0IGtlcm5l bGRvYyBkb2VzCiAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgXgogICAgICAg ICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICZndDsKCj4gKyAgICAgIG5vdCBzdXBwb3J0 IHJlZmVyZW5jaW5nIHN0cnVjdCBtZW1iZXJzIGRpcmVjdGx5LCBzbyBwbGVhc2UgYWRkIGEgcmVm ZXJlbmNlCj4gKyAgICAgIHRvIHRoZSB2dGFibGUgc3RydWN0IHNvbWV3aGVyZSBpbiB0aGUgc2Ft ZSBwYXJhZ3JhcGggb3IgYXQgbGVhc3Qgc2VjdGlvbi4KPiArICAgIDwvcGFyYT4KPiArICAgIDxw YXJhPgo+ICsgICAgICBFeGNlcHQgaW4gc3BlY2lhbCBzaXR1YXRpb25zICh0byBzZXBhcmF0ZSBs b2NrZWQgZnJvbSB1bmxvY2tlZCB2YXJpYW50cykKPiArICAgICAgbG9ja2luZyByZXF1aXJlbWVu dHMgZm9yIGZ1bmN0aW9ucyBhcmVuJ3QgZG9jdW1lbnRlZCBpbiB0aGUga2VybmVsZG9jLgo+ICsg ICAgICBJbnN0ZWFkIGxvY2tpbmcgc2hvdWxkIGJlIGNoZWNrIGF0IHJ1bnRpbWUgdXNpbmcgZS5n Lgo+ICsgICAgICA8Y29kZT5XQVJOX09OKCFtdXRleF9pc19sb2NrZWQoLi4uKSk7PC9jb2RlPi4g U2luY2UgaXQncyBtdWNoIGVhc2llciB0bwo+ICsgICAgICBpZ25vcmUgZG9jdW1lbnRhdGlvbiB0 aGFuIHJ1bnRpbWUgbm9pc2UgdGhpcyBwcm92aWRlcyBtb3JlIHZhbHVlLiBBbmQgb24KPiArICAg ICAgdG9wIG9mIHRoYXQgcnVudGltZSBjaGVja3MgZG8gbmVlZCB0byBiZSB1cGRhdGVkIHdoZW4g dGhlIGxvY2tpbmcgcnVsZXMKPiArICAgICAgY2hhbmdlLCBpbmNyZWFzaW5nIHRoZSBjaGFuY2Vz IHRoYXQgdGhleSdyZSBjb3JyZWN0LiBXaXRoaW4gdGhlCj4gKyAgICAgIGRvY3VtZW50YXRpb24g dGhlIGxvY2tpbmcgcnVsZXMgc2hvdWxkIGJlIGV4cGxhaW5lZCBpbiB0aGUgcmVsZXZhbnQKPiAr ICAgICAgc3RydWN0dXJlczogRWl0aGVyIGluIHRoZSBjb21tZW50IGZvciB0aGUgbG9jayBleHBs YWluaW5nIHdoYXQgaXQKPiArICAgICAgcHJvdGVjdHMsIG9yIGRhdGEgZmllbGRzIG5lZWQgYSBu b3RlIGFib3V0IHdoaWNoIGxvY2sgcHJvdGVjdHMgdGhlbSwgb3IKPiArICAgICAgYm90aC4KPiAr ICAgIDwvcGFyYT4KPiArICAgIDxwYXJhPgo+ICsgICAgICBGdW5jdGlvbnMgd2hpY2ggaGF2ZSBh IG5vbi08Y29kZT52b2lkPC9jb2RlPiByZXR1cm4gdmFsdWUgc2hvdWxkIGhhdmUgYQo+ICsgICAg ICBzZWN0aW9uIGNhbGxlZCAiUmV0dXJucyIgZXhwbGFpbmluZyB0aGUgZXhwZWN0ZWQgcmV0dXJu IHZhbHVlcyBpbgo+ICsgICAgICBkaWZmZXJlbnQgY2FzZXMgYW5kIHRoZWlyIG1lYW5pbmdzLiBD dXJyZW50bHkgdGhlcmUncyBubyBjb25zZW5zdXMgd2hldGhlcgo+ICsgICAgICB0aGF0IHNlY3Rp b24gbmFtZSBzaG91bGQgYmUgYWxsIHVwcGVyLWNhc2Ugb3Igbm90LCBhbmQgd2hldGhlciBpdCBz aG91bGQKPiArICAgICAgZW5kIGluIGEgY29sb24gb3Igbm90LiBHbyB3aXRoIHRoZSBmaWxlLWxv Y2FsIHN0eWxlLiBPdGhlciBjb21tb24gc2VjdGlvbgo+ICsgICAgICBuYW1lcyBhcmUgIk5vdGVz IiB3aXRoIGluZm9ybWF0aW9uIGZvciBkYW5nZXJvdXMgb3IgdHJpY2t5IGNvcm5lciBjYXNlcywK PiArICAgICAgYW5kICJGSVhNRSIgd2hlcmUgdGhlIGludGVyZmFjZSBjb3VsZCBiZSBjbGVhbmVk IHVwLgo+ICsgICAgPC9wYXJhPgo+ICsgIDwvc2VjdDE+CgpPdGhlcndpc2UgbG9va3MgbmljZSwg dGhhbmsgeW91IQoKQmVzdCByZWdhcmRzLAoKTHVrYXMKX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fX19fX19fX19fX18KZHJpLWRldmVsIG1haWxpbmcgbGlzdApkcmktZGV2ZWxA bGlzdHMuZnJlZWRlc2t0b3Aub3JnCmh0dHA6Ly9saXN0cy5mcmVlZGVza3RvcC5vcmcvbWFpbG1h bi9saXN0aW5mby9kcmktZGV2ZWwK