On Sat, Apr 23, 2011 at 09:18:05PM -0400, [email protected] wrote: > Thomas Adam <[email protected]> writes: > > > Hi all, > > > > At the moment though we have a lot man pages which still require raw *roff > > format to be used (such as those in modules/Fvwm* -- and bringing these in > > to line with using Asciidoc seems like a good idea as well. > ... > > [1] http://www.methods.co.nz/asciidoc/ > > Wow, cool. > > It's yet another documentation language but it looks like they > go to pains to make the markup as invisible as possible.
Yup, asciidoc is my format of choice. It actually evolved from a simple tool to add markup for printing to existing ascii documents which is why the "markup" mostly non existent. Without knowing anything about asciidoc, you can write documents like Theory of foobar ================ 1. Inroduction bla bla bla bla bla bla 2. Basics 2.1 Terms bla bla bla * foo * bar * baz Appendix A ---------- ... Appendix B ---------- ... Which are readable in vi *and* can be nicely converted to any other format *and* look good. > I think that might even make Dominik happy. ;-) I love asciidoc. It's a tool for hard core programmers that are forced to write documentation. Ciao Dominik ^_^ ^_^ -- Dominik Vogt
