On 2006/01/06, at 14:40, Tim Cross wrote: > 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.
It would be nice if the source format was an easily translatable format: are there xliff convertors for it ? for example. .po based conversion are ok, but localisation standards have greatly evolved in the last few years and opensource tools are following very close. Docbook-xml would seem like a good choice. JC Helary _______________________________________________ Gardeners mailing list [email protected] http://www.lispniks.com/mailman/listinfo/gardeners
