> > Livedocs still has a main problem: the links. > > What problem? that they are not compatible? or?
Maybe you've never looked at livedoc's code. I was one of the livedocs' hackers and I've reviewed the code several times. There are some problems with docbook IDs for example (just check your build log). There are also problems with OO functions and generating links to them. There is also the problem with name colision in DOM/Domxml. I've made a patch a long time ago to fix some related problems. Wez has also done some work on this, but there are still some open bugs. Just check some OO pages, like SPL, tidy or SOAP. (if you need a more technical answer, just mail me ;-)) > > Livedocs isn't also working well with windows. Latest changes by Wez to make > > the paths relatives broke livedocs on windows, because of diffences on > > slashes (/ versus \) between phpdoc build system and livedoc's. I've already > > reported this problem a while ago, along with some solutions/patches to > > solve the problem. > > Since the docs are going to be made and hosted on a linux server, I > don't see the big problem with that in terms of making php.net run on > livedocs The problem isn't on the server where livedocs is hosted. The problem is just on the building process. If the DB is built in a linux server it will run fine on windows. (windows can also build the DB, but with absolute paths) But as we have patched livedocs to work with windows/cygwin, I think it would be good if the build process worked without any bug on windows. > > The docweb project was largely advertised on all doc mailling lists. > > Livedocs is in alpha stage. It has a couple of well know bugs. So, first > > let's fix them, and then make it public. > > Is it the intention that http://docs.php.net is going to some day > replace http://www.php.net/docs.php ? No! doc.php.net is designed for developpers, documenters and translators. It isn't aimed for public. It will serve as a livedocs testbed, as well as revcheck for translators, list of undocumented functions, functions without examples, etc.... Nuno
