Hi, On Tue, 9 Oct 2001, Emiliano wrote: > > I would prefer single files per part/section, but I will accept > > whatever the majority thinks is appropriate. Reason for that is, I am > > not using Word Perfect, and I wouldn't buy it just for editing SGML - > > I would rather use emacs for it :-) > > I'm not going there :) (vi user myself), Will emacs be able to handle > the files?
Yes, it will be able to handle the files. I don't know anything of an sgml mode to emacs, but just normal file editing will work. > > But anyway, whatever gets decided... Another thing is, what about > > DocBookXML? AFAIK this is the way to go nowadays. Who else is working > > on the documentation? Maybe you should discusss this... > > I'm all for DocbookXML. More XML tools than SGML tools anyway. Votes? > Volunteers for the conversion? Where can I find the DTD for > DocbookXML? I'm for the transition too, but I'd like someone to point me to the XML tools to use then. The manual on the site is generated on Envida's machines and I would have to change that process to use XML tools in stead of SGML tools. > > > If people think it's a good idea, I'd propose > > > to make the monolithic files the defnitive source and over time clear > > > out the others. > > > > Whether monithic or not, cleaning up would be good :-) monolithic = one file per section non-monolithic = current system with one file per function and what not? The splitting up into one file per function was done in the past so that the same source can be used to generate man-pages from the documentation. At least for the function reference I think it would be nice to keep these files apart, as in combination with XML it would allow us to create an online editing tool for the function reference, which would probably be less hostile to documentation volunteers than hardcore SGML/XML editing and CVS access. wkr, -- Envida http://www.envida.net/ Armand A. Verstappen Graadt van Roggenweg 328 [EMAIL PROTECTED] 3531 AH Utrecht tel: +31 (0)30 298 2255 Postbus 19127 fax: +31 (0)30 298 2111 3501 DC Utrecht --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
