Hi, On Wed, 10 Oct 2001, Emiliano wrote: > > Hmmm, I just transfered the entire manual into xml on my local system, > > using the phpdoc build system. > > Wow, teher's tooling to convert SGML into XML?
Yep, P&P[0]. Actually the SGML and XML DocBook versions are very similar, so it came down to adding closing tags where they were allowed to be missing in SGML, adding " around parameter values, and capitalizing some other parameter values. Other then that I had to fix some existing errors. There are still a few issues that I worked around that could be solved in a more gracefull way. > > > I have to make some changes so that the > > multilingual documentation works, and I have to incorporate the generation > > of images. When done, I can commit to CVS and move our documentation > > system over to DocBook-XML. > > > > What do you think? > > Cool. I'll go looking around for an XML editor. I used Xemacs and vi. My mandrake vim installation comes with a very nice xml mode, maybe you are intrested in my vimrc? >What version of > DocBook did you use? The same as the PHPDoc project currently uses: V3.1.7. I'll do some tests to upgrade this to the current DocBook XML version (V4.1.2) to be fully up to speed. > And what files did you actually transform? The > collection or the monolithic ones? The collection. I'm still playing around and may reduce the total number of files, but having multiple files works quite well within the PHP documentation buildsystem. It allows for creating translations quite well. I'm thinking of putting the complete function reference in one file, as it could be incorporated directly into the PHP manual if done that way. What do you think? > Once we've converted we should > probably move all the older stuff in a different directory (probably > even out of the midgard tree for clarity). No need to chuck'em just > yet, but get them out of the way of regular checkouts of the midgard > tree. Yep. I'll need a few more days to complete the transition and clean things up a little, then I'll be asking where to put the new stuff. Of course, the transition will give us a outdated manual running on newer technology. Could you perhaps send me a list of functions/methods that are not yet documented in the current online manual? wwr, [0] Patience & Perl -- 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]
