On 09.09.2006, at 16:31, Vlad Seryakov wrote:
This is what we can base our documentation on, the question is: do we convert it into doctools or keep as html?
Why would you want to convert it in doctools? Such high-level docs is perfectly OK to be kept in HTML mode... Allright, if we'd to make pdf's one day, then it is OK to have it in neutral (doctools) format, but I doubt this is now worth the effort. Different is reference docs (man pages) because it is regularily used as help during programming. Now, I always have to go to sources to look what the Ns_BlaBlah is doing... with "man Ns_BlahBlah" I can refresh myself easily. Tcl has such man-based docs and I find it _INVALUABLE_ for development. Cheers Zoran
