C Y writes: > Just curious - what are the main advantages of texinfo for something > like this? (Well, OK, I guess Emacs integration is an obvious one...) >
I guess the main thing about texinfo is that its been around for a long time and is the 'default' documentation format for GNU and many open source projects, plus 1. Emacs integration 2. Available via 'info' for non-emacs users 3. Various tools available for generating html, latex, ps etc from the texinfo sources. In reality, it would be good if documentation was in an even more 'generic' form, like docbook or sgml so that there is more flexibility in final format choices. However, decent authoring environments for working with such formats as docbook are expensive or, in the case of free and open source, still quite limited/slow to work with. I guess the main thing is that the format used is less important than consistency - though there is the open question regarding whether the use of texinfo as the 'official' documentation for a project actually results in less useful documentation than would occur with a more widely known markup language. Tim _______________________________________________ Gardeners mailing list [email protected] http://www.lispniks.com/mailman/listinfo/gardeners
