> NO. MORE burden! > Please lets forget XML before we write yet another line on that. > > To my opinion, the tcl doctools format is the simplest most natural > to understand and write format I've come accross when writing short(er) > man pages. And this is the bulk of that we need....
Relax! I won't delete the src directory and replace it with XSLT scripts :-) I felt into the format-discussion-trap again, sorry. When using doctools we have various output formats available, nroff, html, tmml, latex, wiki (see src/README.doc). We can put stuff below docroot, into man/, on the wiki. The technical stuff and format is already there. The general problem is: We don't _want_ to write documentation. Not for man pages and not for the Wiki. If we make it a priority we can surely provide appropriate templates that everyone feels comfortable with. We just have to cut the Gordian knot. Bernd.
