Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932120AbbHMXUX (ORCPT ); Thu, 13 Aug 2015 19:20:23 -0400 Received: from tex.lwn.net ([70.33.254.29]:54798 "EHLO vena.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753955AbbHMXUW (ORCPT ); Thu, 13 Aug 2015 19:20:22 -0400 Date: Thu, 13 Aug 2015 17:20:20 -0600 From: Jonathan Corbet 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 Subject: Re: [PATCH 0/4] Add support for Hyperlinks and Markup on kernel-doc Message-ID: <20150813172020.459bb599@xps.lwn.net> In-Reply-To: <55CD23AF.1090307@collabora.co.uk> References: <1437675387-25719-1-git-send-email-danilo.cesar@collabora.co.uk> <20150723222912.50ba8f9f@lwn.net> <55CD23AF.1090307@collabora.co.uk> Organization: LWN.net X-Mailer: Claws Mail 3.11.1 (GTK+ 2.24.28; x86_64-redhat-linux-gnu) MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Content-Length: 2172 Lines: 50 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 -- To unsubscribe from this list: send the line "unsubscribe linux-kernel" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html Please read the FAQ at http://www.tux.org/lkml/