Hi Junio. > > In short, although I do appreciate Johannes's and Sam's attempt, > I would really prefer to see us pick some externally maintained > alternative, instead of inventing a homebrew system that we need > to maintain ourselves. It is rumored that git has much higher > developer count vs loc count ratio than many other open source > projects, doing the documentation format is not part of our > project, and I'd rather see them spend time working on git, not > building and maintaining AsciiDoc lookalike. For the kernel I would like to see a tool that does: o Based on nicely formatted ascii/utf-8 be able to: - Generate good looking and easy to read HTML - Possible generate other output formats too And if the kernel folks do not like it then at least the possibility to run this on kbuild documentation locally so I can generate nice html docs for that part. For a kernel integrated tool the dependencies shall be minimal which is where asciidoc fails today. If asciidoc people could address this issue for the simpler output format then the tool IMO would have a much stronger position. Sam - To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html
