Re: [PATCH 0/4] Add support for Hyperlinks and Markup on kernel-doc

From: Jonathan Corbet
Date: Thu Aug 13 2015 - 19:20:40 EST


On Thu, 13 Aug 2015 20:09:35 -0300
Danilo Cesar Lemes de Paula <danilo.cesar@xxxxxxxxxxxxxxx> 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@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/