Re: CVS update: phpdoc

On Jun 07, Grzegorz BRZESKI wrote: > Paul Andersen wrote: > > > > PHP might be feature complete. But the manual has a lot of work to > > go. > > If I could just point few things, which I noticed last week: > - SNMP section in HTML manual on PHP site is out of date There were new functions added, but I'm not sure if they came with documentation. The online documentation also hasn't been regenerated from the source for a while, which I'm working on. > - no section in manual about YP module Nobody has written one. > From my own expirience I use the HTML version of manual on PHP site more > often than the docs which come with distribution. I would prefer it to > be the first one to get synchronised. But this is just my own opinnion. Well, one problem is that people tend to get confused about new functions being listed that aren't available to them. And I suspect nobody uses the docs that come with the distribution because they come in an unusable format. (Now that I've set up the various tools to generate the documentation on a couple of systems, I can do it pretty quickly, but most people are probably not going to bother, especially if they're not using Red Hat.) My eventual goal is that the online documentation be updated from the SGML source regularly (automatically), and that a snapshot of the manual in HTML format be included in each release tarball. > I could help a bit with the documentation but due to the nature of my > work I'm not able to be available to do this on day to day basis. Nobody is being paid to do this on a day-to-day basis that I know of. People come and go, and contribute when they can. If you think you can help, please pitch in! Jim