From mboxrd@z Thu Jan 1 00:00:00 1970 From: Graham Whaley Subject: Re: [PATCH] scripts/kernel-doc: Improve Markdown results Date: Mon, 24 Aug 2015 15:34:40 +0100 Message-ID: <1440426880.11872.2.camel@linux.intel.com> References: <1440185942-31030-1-git-send-email-danilo.cesar@collabora.co.uk> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <1440185942-31030-1-git-send-email-danilo.cesar@collabora.co.uk> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: intel-gfx-bounces@lists.freedesktop.org Sender: "Intel-gfx" To: Danilo Cesar Lemes de Paula , Daniel Vetter , dri-devel Cc: Michal Marek , Herbert Xu , Jonathan Corbet , Stephan Mueller , intel-gfx , Randy Dunlap , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Laurent Pinchart List-Id: intel-gfx@lists.freedesktop.org T24gRnJpLCAyMDE1LTA4LTIxIGF0IDE2OjM5IC0wMzAwLCBEYW5pbG8gQ2VzYXIgTGVtZXMgZGUg UGF1bGEgd3JvdGU6Cj4gVXNpbmcgcGFuZG9jIGFzIHRoZSBNYXJrZG93biBlbmdpbmUgY2F1c2Ug c29tZSBtaW5vciBzaWRlIGVmZmVjdHMgYXMKPiBwYW5kb2MgaW5jbHVkZXMgIG1haW4gPHBhcmE+ IHRhZ3MgZm9yIGFsbW9zdCBldmVyeXRoaW5nLgo+IE9yaWdpbmFsIE1hcmtkb3duIHN1cHBvcnQg YXBwcm9hY2ggcmVtb3ZlcyB0aG9zZSBtYWluIHRhZ3MsIGJ1dCBpdAo+IGNhdXNlZAo+IHNvbWUg aW5jb25zaXN0ZW5jaWVzIHdoZW4gdGhhdCB0YWcgaXMgbm90IHRoZSBtYWluIG9uZSwgbGlrZToK PiA8c29tZXRoaW5nPi4uPC9zb21ldGhpbmc+Cj4gPHBhcmE+Li4uPC9wYXJhPgo+IAo+IEFzIGtl cm5lbC1kb2Mgd2FzIGFscmVhZHkgaW5jbHVkaW5nIGEgPHBhcmE+IHRhZywgaXQgY2F1c2VzIHRo ZQo+IHByZXNlbmNlCj4gb2YgZG91YmxlIDxwYXJhPiB0YWdzICg8cGFyYT48cGFyYT4pLCB3aGlj aCBpcyBub3Qgc3VwcG9ydGVkIGJ5Cj4gRG9jQm9vawo+IHNwZWMuCj4gCj4gSHRtbCB0YXJnZXQg Z2V0cyBhd2F5IHdpdGggaXQsIHNvIGl0IGNhdXNlcyBubyBoYXJtLCBhbHRob3VnaCBvdGhlcgo+ IHRhcmdldHMgbWlnaHQgbm90IGJlIHNvIGx1Y2t5IChwZGYgYXMgZXhhbXBsZSkuCj4gCj4gV2Un cmUgbm93IGRlbGVnYXRpbmcgdGhlIGluY2x1c2lvbiBvZiB0aGUgbWFpbiA8cGFyYT4gdGFnIHRv IHBhbmRvYwo+IG9ubHksIGFzIGl0IGtub3dzIHdoZW4gaXQncyBuZWNlc3Nhcnkgb3Igbm90Lgo+ IAo+IFRoYXQgYmVoYXZpb3IgY2F1c2VzIGEgY29ybmVyIGNhc2UsIHRoZSBvbmx5IHNpdHVhdGlv biB3aGVyZSB3ZSdyZQo+IGNlcnRhaW5seSB0aGF0IDxwYXJhPiBpcyBub3QgbmVlZGVkLCB3aGlj aCBpcyB0aGUgPHJlZnB1cnBvc2U+Cj4gY29udGVudC4KPiBGb3IgdGhvc2UgY2FzZXMsIHdlJ3Jl IHVzaW5nIGEgJG91dHB1dF9tYXJrZG93bl9ub3BhcmEgPSAxIGNvbnRyb2wKPiB2YXIuCj4gCj4g U2lnbmVkLW9mZi1ieTogRGFuaWxvIENlc2FyIExlbWVzIGRlIFBhdWxhIDwKCgpGZWVsIGZyZWUg dG8gYWRkIG15OgpUZXN0ZWQtYnk6IEdyYWhhbSBXaGFsZXkgPGdyYWhhbS53aGFsZXlAbGludXgu aW50ZWwuY29tPgoKIEdyYWhhbQo+IGRhbmlsby5jZXNhckBjb2xsYWJvcmEuY28udWs+Cj4gQ2M6 IFJhbmR5IER1bmxhcCA8cmR1bmxhcEBpbmZyYWRlYWQub3JnPgo+IENjOiBEYW5pZWwgVmV0dGVy IDxkYW5pZWwudmV0dGVyQGZmd2xsLmNoPgo+IENjOiBMYXVyZW50IFBpbmNoYXJ0IDxsYXVyZW50 LnBpbmNoYXJ0QGlkZWFzb25ib2FyZC5jb20+Cj4gQ2M6IEpvbmF0aGFuIENvcmJldCA8Y29yYmV0 QGx3bi5uZXQ+Cj4gQ2M6IEhlcmJlcnQgWHUgPGhlcmJlcnRAZ29uZG9yLmFwYW5hLm9yZy5hdT4K PiBDYzogU3RlcGhhbiBNdWVsbGVyIDxzbXVlbGxlckBjaHJvbm94LmRlPgo+IENjOiBNaWNoYWwg TWFyZWsgPG1tYXJla0BzdXNlLmN6Pgo+IENjOiBsaW51eC1rZXJuZWxAdmdlci5rZXJuZWwub3Jn Cj4gQ2M6IGxpbnV4LWRvY0B2Z2VyLmtlcm5lbC5vcmcKPiBDYzogaW50ZWwtZ2Z4IDxpbnRlbC1n ZnhAbGlzdHMuZnJlZWRlc2t0b3Aub3JnPgo+IENjOiBkcmktZGV2ZWwgPGRyaS1kZXZlbEBsaXN0 cy5mcmVlZGVza3RvcC5vcmc+Cj4gQ2M6IEdyYWhhbSBXaGFsZXkgPGdyYWhhbS53aGFsZXlAbGlu dXguaW50ZWwuY29tPgo+IC0tLQo+ICBUaGFua3MgdG8gR3JhaGFtIFdoYWxleSB3aG8gaGVscGVk IG1lIHRvIGRlYnVnIHRoaXMuCj4gCj4gIHNjcmlwdHMva2VybmVsLWRvYyB8IDQ4ICsrKysrKysr KysrKysrKysrKysrKysrKysrKysrKysrKystLS0tLS0tLS0tCj4gLS0tLQo+ICAxIGZpbGUgY2hh bmdlZCwgMzQgaW5zZXJ0aW9ucygrKSwgMTQgZGVsZXRpb25zKC0pCj4gCj4gZGlmZiAtLWdpdCBh L3NjcmlwdHMva2VybmVsLWRvYyBiL3NjcmlwdHMva2VybmVsLWRvYwo+IGluZGV4IDM4NTBjMWUu LjEyYTEwNmMgMTAwNzU1Cj4gLS0tIGEvc2NyaXB0cy9rZXJuZWwtZG9jCj4gKysrIGIvc2NyaXB0 cy9rZXJuZWwtZG9jCj4gQEAgLTI4OCw2ICsyODgsNyBAQCBteSAkdXNlX21hcmtkb3duID0gMDsK PiAgbXkgJHZlcmJvc2UgPSAwOwo+ICBteSAkb3V0cHV0X21vZGUgPSAibWFuIjsKPiAgbXkgJG91 dHB1dF9wcmVmb3JtYXR0ZWQgPSAwOwo+ICtteSAkb3V0cHV0X21hcmtkb3duX25vcGFyYSA9IDA7 Cj4gIG15ICRub19kb2Nfc2VjdGlvbnMgPSAwOwo+ICBteSBAaGlnaGxpZ2h0cyA9IEBoaWdobGln aHRzX21hbjsKPiAgbXkgJGJsYW5rbGluZSA9ICRibGFua2xpbmVfbWFuOwo+IEBAIC01MjksOCAr NTMwLDExIEBAIHN1YiBtYXJrZG93bl90b19kb2Nib29rIHsKPiAgCWNsb3NlKENITERfT1VUKTsK PiAgCWNsb3NlKENITERfRVJSKTsKPiAgCj4gLQkjIHBhbmRvYyBpbnNpc3RzIGluIGFkZGluZyBN YWluIDxwYXJhPjwvcGFyYT4sIHdlIHNob3VsZAo+IHJlbW92ZSB0aGVtLgo+IC0JJGNvbnRlbnQg PX4gczpcQVxzKjxwYXJhPlxzKlxuKC4qKVxuPC9wYXJhPlxaJDokMTplZ3NtOwo+ICsJaWYgKCRv dXRwdXRfbWFya2Rvd25fbm9wYXJhKSB7Cj4gKwkJIyBwYW5kb2MgaW5zaXN0cyBpbiBhZGRpbmcg TWFpbiA8cGFyYT48L3BhcmE+LAo+IHNvbWV0aW1lcyB3ZQo+ICsJCSMgd2FudCB0byByZW1vdmUg dGhlbS4KPiArCQkkY29udGVudCA9fgo+IHM6XEFccyo8cGFyYT5ccypcbiguKilcbjwvcGFyYT5c WiQ6JDE6ZWdzbTsKPiArCX0KPiAgCj4gIAlyZXR1cm4gJGNvbnRlbnQ7Cj4gIH0KPiBAQCAtNjA1 LDcgKzYwOSw3IEBAIHN1YiBvdXRwdXRfaGlnaGxpZ2h0IHsKPiAgCSAgICAkbGluZSA9fiBzL15c cyovLzsKPiAgCX0KPiAgCWlmICgkbGluZSBlcSAiIil7Cj4gLQkgICAgaWYgKCEgJG91dHB1dF9w cmVmb3JtYXR0ZWQpIHsKPiArCSAgICBpZiAoISAkb3V0cHV0X3ByZWZvcm1hdHRlZCAmJiAhICR1 c2VfbWFya2Rvd24pIHsKPiAgCQlwcmludCAkbGluZXByZWZpeCwgbG9jYWxfdW5lc2NhcGUoJGJs YW5rbGluZSk7Cj4gIAkgICAgfQo+ICAJfSBlbHNlIHsKPiBAQCAtMTAyNiw3ICsxMDMwLDcgQEAg c3ViIG91dHB1dF9zZWN0aW9uX3htbCglKSB7Cj4gIAkgICAgIyBwcm9ncmFtbGlzdGluZyBpcyBh bHJlYWR5IGluY2x1ZGVkIGJ5IHBhbmRvYwo+ICAJICAgIHByaW50ICI8cHJvZ3JhbWxpc3Rpbmc+ XG4iIHVubGVzcyAkdXNlX21hcmtkb3duOwo+ICAJICAgICRvdXRwdXRfcHJlZm9ybWF0dGVkID0g MTsKPiAtCX0gZWxzZSB7Cj4gKwl9IGVsc2lmICghICR1c2VfbWFya2Rvd24pIHsKPiAgCSAgICBw cmludCAiPHBhcmE+XG4iOwo+ICAJfQo+ICAJb3V0cHV0X2hpZ2hsaWdodCgkYXJnc3snc2VjdGlv bnMnfXskc2VjdGlvbn0pOwo+IEBAIC0xMDM0LDcgKzEwMzgsNyBAQCBzdWIgb3V0cHV0X3NlY3Rp b25feG1sKCUpIHsKPiAgCWlmICgkc2VjdGlvbiA9fiBtL0VYQU1QTEUvaSkgewo+ICAJICAgIHBy aW50ICI8L3Byb2dyYW1saXN0aW5nPlxuIiB1bmxlc3MgJHVzZV9tYXJrZG93bjsKPiAgCSAgICBw cmludCAiPC9pbmZvcm1hbGV4YW1wbGU+XG4iOwo+IC0JfSBlbHNlIHsKPiArCX0gZWxzaWYgKCEg JHVzZV9tYXJrZG93bikgewo+ICAJICAgIHByaW50ICI8L3BhcmE+XG4iOwo+ICAJfQo+ICAJcHJp bnQgIjwvcmVmc2VjdDE+XG4iOwo+IEBAIC0xMDY2LDcgKzEwNzAsOSBAQCBzdWIgb3V0cHV0X2Z1 bmN0aW9uX3htbCglKSB7Cj4gICAgICBwcmludCAiIDxyZWZuYW1lPiIgLiAkYXJnc3snZnVuY3Rp b24nfSAuICI8L3JlZm5hbWU+XG4iOwo+ICAgICAgcHJpbnQgIiA8cmVmcHVycG9zZT5cbiI7Cj4g ICAgICBwcmludCAiICAiOwo+ICsgICAgJG91dHB1dF9tYXJrZG93bl9ub3BhcmEgPSAxOwo+ICAg ICAgb3V0cHV0X2hpZ2hsaWdodCAoJGFyZ3N7J3B1cnBvc2UnfSk7Cj4gKyAgICAkb3V0cHV0X21h cmtkb3duX25vcGFyYSA9IDA7Cj4gICAgICBwcmludCAiIDwvcmVmcHVycG9zZT5cbiI7Cj4gICAg ICBwcmludCAiPC9yZWZuYW1lZGl2PlxuIjsKPiAgCj4gQEAgLTExMDQsMTAgKzExMTAsMTIgQEAg c3ViIG91dHB1dF9mdW5jdGlvbl94bWwoJSkgewo+ICAJICAgICRwYXJhbWV0ZXJfbmFtZSA9fiBz L1xbLiovLzsKPiAgCj4gIAkgICAgcHJpbnQgIiAgPHZhcmxpc3RlbnRyeT5cbiAgCj4gIDx0ZXJt PjxwYXJhbWV0ZXI+JHBhcmFtZXRlcjwvcGFyYW1ldGVyPjwvdGVybT5cbiI7Cj4gLQkgICAgcHJp bnQgIiAgIDxsaXN0aXRlbT5cbiAgICA8cGFyYT5cbiI7Cj4gKwkgICAgcHJpbnQgIiAgIDxsaXN0 aXRlbT5cbiI7Cj4gKwkgICAgcHJpbnQgIiAgICA8cGFyYT5cbiIgdW5sZXNzICR1c2VfbWFya2Rv d247Cj4gIAkgICAgJGxpbmVwcmVmaXg9IiAgICAgIjsKPiAgCSAgIAo+ICBvdXRwdXRfaGlnaGxp Z2h0KCRhcmdzeydwYXJhbWV0ZXJkZXNjcyd9eyRwYXJhbWV0ZXJfbmFtZX0pOwo+IC0JICAgIHBy aW50ICIgICAgPC9wYXJhPlxuICAgPC9saXN0aXRlbT5cbiAKPiAgPC92YXJsaXN0ZW50cnk+XG4i Owo+ICsJICAgIHByaW50ICIgICAgPC9wYXJhPlxuIiB1bmxlc3MgJHVzZV9tYXJrZG93bjsKPiAr CSAgICBwcmludCAiICAgPC9saXN0aXRlbT5cbiAgPC92YXJsaXN0ZW50cnk+XG4iOwo+ICAJfQo+ ICAJcHJpbnQgIiA8L3ZhcmlhYmxlbGlzdD5cbiI7Cj4gICAgICB9IGVsc2Ugewo+IEBAIC0xMTQz LDcgKzExNTEsOSBAQCBzdWIgb3V0cHV0X3N0cnVjdF94bWwoJSkgewo+ICAgICAgcHJpbnQgIiA8 cmVmbmFtZT4iIC4gJGFyZ3N7J3R5cGUnfSAuICIgIiAuICRhcmdzeydzdHJ1Y3QnfSAuCj4gIjwv cmVmbmFtZT5cbiI7Cj4gICAgICBwcmludCAiIDxyZWZwdXJwb3NlPlxuIjsKPiAgICAgIHByaW50 ICIgICI7Cj4gKyAgICAkb3V0cHV0X21hcmtkb3duX25vcGFyYSA9IDE7Cj4gICAgICBvdXRwdXRf aGlnaGxpZ2h0ICgkYXJnc3sncHVycG9zZSd9KTsKPiArICAgICRvdXRwdXRfbWFya2Rvd25fbm9w YXJhID0gMDsKPiAgICAgIHByaW50ICIgPC9yZWZwdXJwb3NlPlxuIjsKPiAgICAgIHByaW50ICI8 L3JlZm5hbWVkaXY+XG4iOwo+ICAKPiBAQCAtMTE5Niw5ICsxMjA2LDExIEBAIHN1YiBvdXRwdXRf c3RydWN0X3htbCglKSB7Cj4gICAgICAgICgkYXJnc3sncGFyYW1ldGVyZGVzY3MnfXskcGFyYW1l dGVyX25hbWV9IG5lICR1bmRlc2NyaWJlZCkgfHwKPiBuZXh0Owo+ICAgICAgICBwcmludCAiICAg IDx2YXJsaXN0ZW50cnk+IjsKPiAgICAgICAgcHJpbnQgIiAgICAgIDx0ZXJtPiRwYXJhbWV0ZXI8 L3Rlcm0+XG4iOwo+IC0gICAgICBwcmludCAiICAgICAgPGxpc3RpdGVtPjxwYXJhPlxuIjsKPiAr ICAgICAgcHJpbnQgIiAgICAgIDxsaXN0aXRlbT5cbiI7Cj4gKyAgICAgIHByaW50ICIgICAgICAg ICA8cGFyYT5cbiIgdW5sZXNzICR1c2VfbWFya2Rvd247Cj4gICAgICAgIG91dHB1dF9oaWdobGln aHQoJGFyZ3N7J3BhcmFtZXRlcmRlc2NzJ317JHBhcmFtZXRlcl9uYW1lfSk7Cj4gLSAgICAgIHBy aW50ICIgICAgICA8L3BhcmE+PC9saXN0aXRlbT5cbiI7Cj4gKyAgICAgIHByaW50ICIgICAgICAg ICA8L3BhcmE+XG4iIHVubGVzcyAkdXNlX21hcmtkb3duOwo+ICsgICAgICBwcmludCAiICAgICAg PC9saXN0aXRlbT5cbiI7Cj4gICAgICAgIHByaW50ICIgICAgPC92YXJsaXN0ZW50cnk+XG4iOwo+ ICAgICAgfQo+ICAgICAgcHJpbnQgIiAgPC92YXJpYWJsZWxpc3Q+XG4iOwo+IEBAIC0xMjM3LDcg KzEyNDksOSBAQCBzdWIgb3V0cHV0X2VudW1feG1sKCUpIHsKPiAgICAgIHByaW50ICIgPHJlZm5h bWU+ZW51bSAiIC4gJGFyZ3N7J2VudW0nfSAuICI8L3JlZm5hbWU+XG4iOwo+ICAgICAgcHJpbnQg IiA8cmVmcHVycG9zZT5cbiI7Cj4gICAgICBwcmludCAiICAiOwo+ICsgICAgJG91dHB1dF9tYXJr ZG93bl9ub3BhcmEgPSAxOwo+ICAgICAgb3V0cHV0X2hpZ2hsaWdodCAoJGFyZ3N7J3B1cnBvc2Un fSk7Cj4gKyAgICAkb3V0cHV0X21hcmtkb3duX25vcGFyYSA9IDA7Cj4gICAgICBwcmludCAiIDwv cmVmcHVycG9zZT5cbiI7Cj4gICAgICBwcmludCAiPC9yZWZuYW1lZGl2PlxuIjsKPiAgCj4gQEAg LTEyNjcsOSArMTI4MSwxMSBAQCBzdWIgb3V0cHV0X2VudW1feG1sKCUpIHsKPiAgCj4gICAgICAg IHByaW50ICIgICAgPHZhcmxpc3RlbnRyeT4iOwo+ICAgICAgICBwcmludCAiICAgICAgPHRlcm0+ JHBhcmFtZXRlcjwvdGVybT5cbiI7Cj4gLSAgICAgIHByaW50ICIgICAgICA8bGlzdGl0ZW0+PHBh cmE+XG4iOwo+ICsgICAgICBwcmludCAiICAgICAgPGxpc3RpdGVtPlxuIjsKPiArICAgICAgcHJp bnQgIiAgICAgICAgIDxwYXJhPlxuIiB1bmxlc3MgJHVzZV9tYXJrZG93bjsKPiAgICAgICAgb3V0 cHV0X2hpZ2hsaWdodCgkYXJnc3sncGFyYW1ldGVyZGVzY3MnfXskcGFyYW1ldGVyX25hbWV9KTsK PiAtICAgICAgcHJpbnQgIiAgICAgIDwvcGFyYT48L2xpc3RpdGVtPlxuIjsKPiArICAgICAgcHJp bnQgIiAgICAgICAgIDwvcGFyYT5cbiIgdW5sZXNzICR1c2VfbWFya2Rvd247Cj4gKyAgICAgIHBy aW50ICIgICAgICA8L2xpc3RpdGVtPlxuIjsKPiAgICAgICAgcHJpbnQgIiAgICA8L3Zhcmxpc3Rl bnRyeT5cbiI7Cj4gICAgICB9Cj4gICAgICBwcmludCAiICA8L3ZhcmlhYmxlbGlzdD5cbiI7Cj4g QEAgLTEzMzUsMTQgKzEzNTEsMTQgQEAgc3ViIG91dHB1dF9ibG9ja2hlYWRfeG1sKCUpIHsKPiAg CWlmICgkc2VjdGlvbiA9fiBtL0VYQU1QTEUvaSkgewo+ICAJICAgIHByaW50ICI8ZXhhbXBsZT48 cGFyYT5cbiI7Cj4gIAkgICAgJG91dHB1dF9wcmVmb3JtYXR0ZWQgPSAxOwo+IC0JfSBlbHNlIHsK PiArCX0gZWxzaWYgKCEgJHVzZV9tYXJrZG93bikgewo+ICAJICAgIHByaW50ICI8cGFyYT5cbiI7 Cj4gIAl9Cj4gIAlvdXRwdXRfaGlnaGxpZ2h0KCRhcmdzeydzZWN0aW9ucyd9eyRzZWN0aW9ufSk7 Cj4gIAkkb3V0cHV0X3ByZWZvcm1hdHRlZCA9IDA7Cj4gIAlpZiAoJHNlY3Rpb24gPX4gbS9FWEFN UExFL2kpIHsKPiAgCSAgICBwcmludCAiPC9wYXJhPjwvZXhhbXBsZT5cbiI7Cj4gLQl9IGVsc2Ug ewo+ICsJfSBlbHNpZiAoISAkdXNlX21hcmtkb3duKSB7Cj4gIAkgICAgcHJpbnQgIjwvcGFyYT4i Owo+ICAJfQo+ICAJaWYgKCEkYXJnc3snY29udGVudC1vbmx5J30pIHsKPiBAQCAtMjY4NCw3ICsy NzAwLDExIEBAIHN1YiBwcm9jZXNzX2ZpbGUoJCkgewo+ICAJCXsKPiAgCQkJaWYgKCAkMSBlcSAi IiApCj4gIAkJCXsKPiAtCQkJCSRjb250ZW50cyAuPSAkYmxhbmtsaW5lOwo+ICsJCQkJaWYgKCR1 c2VfbWFya2Rvd24pIHsKPiArCQkJCQkkY29udGVudHMgLj0gIlxuIjsKPiArCQkJCX0gZWxzZSB7 Cj4gKwkJCQkJJGNvbnRlbnRzIC49ICRibGFua2xpbmU7Cj4gKwkJCQl9Cj4gIAkJCX0KPiAgCQkJ ZWxzZQo+ICAJCQl7Cl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fCkludGVsLWdmeCBtYWlsaW5nIGxpc3QKSW50ZWwtZ2Z4QGxpc3RzLmZyZWVkZXNrdG9wLm9y ZwpodHRwOi8vbGlzdHMuZnJlZWRlc2t0b3Aub3JnL21haWxtYW4vbGlzdGluZm8vaW50ZWwtZ2Z4 Cg==