[PATCH 0/4] Add support for Hyperlinks and Markup on kernel-doc
Jonathan Corbet
corbet at lwn.net
Thu Aug 13 16:20:20 PDT 2015
On Thu, 13 Aug 2015 20:09:35 -0300
Danilo Cesar Lemes de Paula <danilo.cesar at collabora.co.uk> 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
More information about the dri-devel
mailing list