Re: Kernel docs: muddying the waters a bit

Mauro Carvalho Chehab writes: > On my tests, Sphinix seemed too limited to format tables. Asciidoc > produced an output that worked better. Yes, asciidoc has much more flexibility in table formatting, including the ability to control text layout within cells and full

Re: Kernel docs: muddying the waters a bit

Jonathan Corbet writes: > Indeed, I doubt many people want the DocBook itself. Might be nice to actually have a set of requirements before anyone tries to select a suitable system then :-) Here's my current set: asciidocsphinx htmlvia docbook native

Re: Kernel docs: muddying the waters a bit

Jonathan Corbet writes: > Asciidoc is a credible solution to the formatted documentation problem, > but it's not the only such; I'd like to be sure that we pick the right > one. I worry that asciidoc seems to be aimed mostly at small documents, > and that the project itself

Re: [RFC] A first shot at asciidoc-based formatted docs

Keith Packard <kei...@keithp.com> writes: > The goal would be to create an html document which could be used without > javascript, and that would work without css as well. I've managed to hack up asciidoc to generate the TOC within the document, rather than requiring javascript.

Re: [RFC] A first shot at asciidoc-based formatted docs

Jani Nikula writes: > One of the chief complaints with the current pipeline (and some of the > proposals) has been the need to install lots of tools with lots of > dependencies. I would like to avoid the need to install bleeding edge > tools and stick to what's already