From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jonathan Corbet Subject: Re: [PATCH 0/4] Add support for Hyperlinks and Markup on kernel-doc Date: Thu, 13 Aug 2015 17:20:20 -0600 Message-ID: <20150813172020.459bb599@xps.lwn.net> References: <1437675387-25719-1-git-send-email-danilo.cesar@collabora.co.uk> <20150723222912.50ba8f9f@lwn.net> <55CD23AF.1090307@collabora.co.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Return-path: In-Reply-To: <55CD23AF.1090307@collabora.co.uk> Sender: linux-doc-owner@vger.kernel.org To: Danilo Cesar Lemes de Paula 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 List-Id: dri-devel@lists.freedesktop.org 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. > 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'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? 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, jon