From mboxrd@z Thu Jan 1 00:00:00 1970 From: Danilo Cesar Lemes de Paula Subject: Re: [PATCH 0/4] Add support for Hyperlinks and Markup on kernel-doc Date: Fri, 14 Aug 2015 14:26:16 -0300 Message-ID: <55CE24B8.5030508@collabora.co.uk> References: <1437675387-25719-1-git-send-email-danilo.cesar@collabora.co.uk> <20150723222912.50ba8f9f@lwn.net> <55CD23AF.1090307@collabora.co.uk> <20150813172020.459bb599@xps.lwn.net> Mime-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Return-path: In-Reply-To: <20150813172020.459bb599@xps.lwn.net> List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dri-devel-bounces@lists.freedesktop.org Sender: "dri-devel" To: Jonathan Corbet Cc: Michal Marek , Herbert Xu , linux-doc@vger.kernel.org, Stephan Mueller , Daniel Vetter , intel-gfx , Randy Dunlap , linux-kernel@vger.kernel.org, dri-devel , Laurent Pinchart List-Id: dri-devel@lists.freedesktop.org T24gMDgvMTMvMjAxNSAwODoyMCBQTSwgSm9uYXRoYW4gQ29yYmV0IHdyb3RlOgo+IE9uIFRodSwg MTMgQXVnIDIwMTUgMjA6MDk6MzUgLTAzMDAKPiBEYW5pbG8gQ2VzYXIgTGVtZXMgZGUgUGF1bGEg PGRhbmlsby5jZXNhckBjb2xsYWJvcmEuY28udWs+IHdyb3RlOgo+IAo+PiBEaWQgeW91IGZpbmQg dGltZSB0byB0YWtlIGEgbG9vayBvbiB0aGlzPwo+IAo+IE5vLiAgSnVzdCB3aGVuIEkgdGhvdWdo dCB0aGluZ3MgY291bGRuJ3QgZ2V0IGNyYXppZXIsIG15IGxhcHRvcCBkaWVkLiAgCj4gCj4gCWh0 dHBzOi8vcGx1cy5nb29nbGUuY29tLytKb25hdGhhbkNvcmJldC9wb3N0cy9GQkhwNDhkUGI5NQo+ IAo+IFdoYXQgc3BhcmUgdGltZSBJIGhhZCBoYXMgYmVlbiBkZWRpY2F0ZWQgdG8gcmVjb3Zlcmlu ZyBmcm9tIHRoYXQgaW4gdGltZQo+IHRvIGdpdmUgbXkgdGFsayBuZXh0IHdlZWsuCgpUaG9zZSBl dmlsIG1hY2hpbmVzLi4uID0pCgo+ICAKPj4gSSB1bmRlcnN0YW5kIHRoYXQgdGhlcmUncyBzb21l IGRpc2N1c3Npb24gYmVoaW5kIHRoZSBjdXJ0YWlucyByZWdhcmRpbmcKPj4gdGhlIG1hcmtkb3du IHN1cHBvcnQsIGJ1dCB0aGUgY3Jvc3MtcmVmZXJlbmNlLWh5cGVybGluayBwYXRjaCBpcyBhbHNv IGluCj4+IHRoZSBzYW1lIHBhdGNoIHNlcmllcy4gSXQgZG9lc24ndCBjaGFuZ2UgYW55IHRleHQg aW4gdGhlIGRvY2Jvb2sgdW5sZXNzCj4+IHRoZXJlJ3MgcmVhbGx5IGEgY3Jvc3MtcmVmZXJlbmNl IGxpbmsgdG8gaXQuIERpZmZlcmVudCBmcm9tIHRoZSBtYXJrZG93bgo+PiBzdXBwb3J0ICh3aGVu IHBlb3BsZSBzdGFydCB0byB1c2UgbWFya2Rvd24gdG8gd3JpdGUgZG9jcyBpdCB3aWxsIGJlIGhh cmQKPj4gdG8gZ28gYmFjayksIHRoZSBjcm9zcy1saW5rIHN0dWZmIGRvZXNuJ3QgcmVxdWlyZS9j cmVhdGUgYW55IGNoYW5nZSB0bwo+PiBjdXJyZW50IGRvY3VtZW50YXRpb24sIGl0IGlzIHByZXR0 eSBzYWZlIHRvIHVzZS4KPj4KPj4gV291bGQgeW91IG1pbmQgdG8gc2hhcmUgeW91ciBwbGFucyBh Ym91dCB0aGlzPwo+IAo+IE5vIGJlaGluZC10aGUtY3VydGFpbnMgZGlzY3Vzc2lvbnMgaGFwcGVu aW5nLCBvciwgbGV0J3Mgc2F5LCBpZiB0aGVyZQo+IGFyZSwgSSd2ZSBub3QgYmVlbiBpbnZpdGVk IGVpdGhlci4KCkkgbWVhbnQgdGhlIEtlcm5lbCBzdW1taXQgbWFpbGluZyBsaXN0LCBidXQgbG9v a3MgbGlrZSB0aGF0IHRocmVhZCBkaWVkCmV2ZW4gYmVmb3JlIG15IHBhdGNoZXMuCgo+IAo+IEkn ZCBsaWtlIHRvIGdldCBiYWNrIHRvIHRoZSBjcm9zcy1yZWZlcmVuY2Ugc3R1ZmYuICBMYXN0IEkg dHJpZWQsIGl0Cj4gZmFpbGVkIHdoaWxlIGJ1aWxkaW5nIHRoZSBtZWRpYSBkb2NzOyBoYXZlIHlv dSBiZWVuIGFibGUgdG8gbG9vayBhdAo+IHRoYXQ/ICAKCkkgZGlkLCBhbmQgSSBkaWRuJ3QgZmlu ZCBhbnl0aGluZy4KTWVkaWEgQVBJIGFscmVhZHkgc3BpdHMgbG90cyBvZiB3YXJuaW5ncyB3aXRo b3V0IG15IHBhdGNoLiBJIGRpZCBzZW5kCnRob3NlIHdhcm5pbmdzIHRvIGEgZmlsZSBhbmQgY291 bnQgdGhlbS4gTXkgcGF0Y2ggcHJvZHVjZXMgdGhlIHNhbWUKYW1vdW50IG9mIHdhcm5pbmdzIGFz IHRoZSBvcmlnaW5hbCBicmFuY2guCkkgZGlkLCBob3dldmVyLCB1c2UgYSBjbGVhbiBidWlsZCB0 byB0ZXN0IHRoYXQuIERhbmllbCBWZXR0ZXIgY29tcGxhaW5lZAp0aGF0IHRoZSBEb2N1bWVudGF0 aW9uIHdhcyBiZWluZyByZWJ1aWx0IGFsbCB0aGUgdGltZSwgc29tZXRoaW5nIHdyb25nCndpdGgg dGhlIGRlcGVuZGVuY2llcy4gSSBkaWQgZml4IHRoYXQgaW4gdjIuIE1heWJlIHRoZSBlcnJvcnMg eW91IGdvdAp3ZXJlIHJlbGF0ZWQgdG8gaXQ/CgoKPiAKPiBMb25nZXIgdGVybSwgYXMgeW91IG1h eSBrbm93IGZyb20gdGhlIGtlcm5lbCBzdW1taXQgZGlzY3Vzc2lvbnMsIEknZAo+IHJlYWxseSBs aWtlIHRvIGdldCByaWQgb2YgYSBsb3Qgb2YgdGhlIFhNTCBndW5rIGFuZCBwdXQgaW4gc29tZXRo aW5nIG1vcmUKPiBzdHJhaWdodGZvcndhcmQsIGJlIGl0IGJhc2VkIG9uIE1hcmtkb3duIG9yIHNv bWV0aGluZyBlbHNlLiAgRG9pbmcgdGhhdCwKPiBob3dldmVyLCByZXF1aXJlcyB0aGF0IEkgZmlu ZCB0aGUgdGltZSB0byBpbXBsZW1lbnQgc29tZXRoaW5nIHRoYXQncwo+IGNvbnZpbmNpbmdseSBi ZXR0ZXIuICBJdCBtYXkgaGFwcGVuIHNvb24sIGJ1dCBJIHN1cmUgY2FuJ3QgZ3VhcmFudGVlIGl0 Lgo+IAo+IE1lYW53aGlsZSwgSSB0aGluayBpdCB3b3VsZCBiZSBhIGhvcnJpYmxlIG1pc3Rha2Ug dG8gZGVsYXkgdXNlZnVsIHdvcmsKPiBiZWNhdXNlIEkgaGF2ZSBhIGdsZWFtIGluIG15IGV5ZSB0 byBkbyBzb21ldGhpbmcgZGlmZmVyZW50IG9uZSBvZiB0aGVzZQo+IHllYXJzLCBzbyBJJ2xsIG5v dCBkbyB0aGF0LiAgSSBmdWxseSBleHBlY3QgdG8gbWVyZ2UgYWxsIG9mIHRoZSBzdHVmZgo+IHlv dSd2ZSBkb25lLCBJIGp1c3QgbmVlZCB0byBoYXZlIGEgZ29vZCBsb29rIGF0IGl0IGFuZCB0ZXN0 IGl0IG91dCBhCj4gYml0LiAgQXMgSSBzYWlkIGJlZm9yZSwgSSBjYW4ndCBwcm9taXNlIHRoYXQg Zm9yIHRoZSA0LjMgbWVyZ2Ugd2luZG93LAo+IGJ1dCBJJ2xsIHRyeS4KPiAKPiBBcG9sb2dpZXMs CgpObyBuZWVkIHRvIGFwb2xvZ2l6ZSwganVzdCB3YW50ZWQgdG8ga25vdyB3aGF0IHdhcyBnb2lu ZyBvbi4KCkRhbmlsbyBDZXNhcgpfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fXwpkcmktZGV2ZWwgbWFpbGluZyBsaXN0CmRyaS1kZXZlbEBsaXN0cy5mcmVlZGVz a3RvcC5vcmcKaHR0cDovL2xpc3RzLmZyZWVkZXNrdG9wLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2Ry aS1kZXZlbAo= From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755836AbbHNR0a (ORCPT ); Fri, 14 Aug 2015 13:26:30 -0400 Received: from bhuna.collabora.co.uk ([93.93.135.160]:59129 "EHLO bhuna.collabora.co.uk" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1755294AbbHNR02 (ORCPT ); Fri, 14 Aug 2015 13:26:28 -0400 Subject: Re: [PATCH 0/4] Add support for Hyperlinks and Markup on kernel-doc To: Jonathan Corbet References: <1437675387-25719-1-git-send-email-danilo.cesar@collabora.co.uk> <20150723222912.50ba8f9f@lwn.net> <55CD23AF.1090307@collabora.co.uk> <20150813172020.459bb599@xps.lwn.net> Cc: linux-doc@vger.kernel.org, Randy Dunlap , Daniel Vetter , Laurent Pinchart , Herbert Xu , Stephan Mueller , Michal Marek , linux-kernel@vger.kernel.org, intel-gfx , dri-devel From: Danilo Cesar Lemes de Paula X-Enigmail-Draft-Status: N1110 Message-ID: <55CE24B8.5030508@collabora.co.uk> Date: Fri, 14 Aug 2015 14:26:16 -0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.1.0 MIME-Version: 1.0 In-Reply-To: <20150813172020.459bb599@xps.lwn.net> Content-Type: text/plain; charset=windows-1252 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On 08/13/2015 08:20 PM, Jonathan Corbet wrote: > On Thu, 13 Aug 2015 20:09:35 -0300 > Danilo Cesar Lemes de Paula wrote: > >> Did you find time to take a look on this? > > No. Just when I thought things couldn't get crazier, my laptop died. > > https://plus.google.com/+JonathanCorbet/posts/FBHp48dPb95 > > What spare time I had has been dedicated to recovering from that in time > to give my talk next week. Those evil machines... =) > >> I understand that there's some discussion behind the curtains regarding >> the markdown support, but the cross-reference-hyperlink patch is also in >> the same patch series. It doesn't change any text in the docbook unless >> there's really a cross-reference link to it. Different from the markdown >> support (when people start to use markdown to write docs it will be hard >> to go back), the cross-link stuff doesn't require/create any change to >> current documentation, it is pretty safe to use. >> >> Would you mind to share your plans about this? > > No behind-the-curtains discussions happening, or, let's say, if there > are, I've not been invited either. I meant the Kernel summit mailing list, but looks like that thread died even before my patches. > > I'd like to get back to the cross-reference stuff. Last I tried, it > failed while building the media docs; have you been able to look at > that? I did, and I didn't find anything. Media API already spits lots of warnings without my patch. I did send those warnings to a file and count them. My patch produces the same amount of warnings as the original branch. I did, however, use a clean build to test that. Daniel Vetter complained that the Documentation was being rebuilt all the time, something wrong with the dependencies. I did fix that in v2. Maybe the errors you got were related to it? > > Longer term, as you may know from the kernel summit discussions, I'd > really like to get rid of a lot of the XML gunk and put in something more > straightforward, be it based on Markdown or something else. Doing that, > however, requires that I find the time to implement something that's > convincingly better. It may happen soon, but I sure can't guarantee it. > > Meanwhile, I think it would be a horrible mistake to delay useful work > because I have a gleam in my eye to do something different one of these > years, so I'll not do that. I fully expect to merge all of the stuff > you've done, I just need to have a good look at it and test it out a > bit. As I said before, I can't promise that for the 4.3 merge window, > but I'll try. > > Apologies, No need to apologize, just wanted to know what was going on. Danilo Cesar