Ingo Schwarze <schwa...@usta.de>: > Consequently, i counsel anybody who has the choice of formatting > tools to avoid asciidoc and DocBook at all cost.
Your report is at best grossly exaggerated. Many of the things you call 'bugs' are defensible implementation choices given that the stylesheet is creating an output format output that will never be re-parsed. I have been maintaining the manual pages for all of my forty-odd projects in asciidoc for around ten years now and have not encountered the horrible problems you claim are endemic. Perhaps more to the point, asciidoc is in heavy use by the Linux kernel devs and the git crew. It has passed the test of field deployment. This tells us that whatever problems it has must be relatively minor and have workarounds. -- <a href="http://www.catb.org/~esr/">Eric S. Raymond</a>