Re: MySQLi

On Thu, 22 May 2003, Georg Richter wrote: > On Thursday 22 May 2003 22:28, Philip Olson wrote: > > > > > There is no information on how to install mysqli, > > how to configure it, what it is, what php and mysql > > versions are needed ... nothing. Until this happens, > > it doesn't seem worthy for any generation and will > > only lead to chaos and confusion. > > It's EXPERIMENTAL for PHP5 and I don't see a reason to remove it cause there > are currently no installation instructions. Several people are working on the > documentation already, and also some people are using (better testing) > ext/mysqli already. MySQLi was never added to manual.xml.in. People are working on the docs, that's good, but imho reference.xml is not ready enough for this to be generated and will cause more confusion than good. > Not all of them want to grab the cvs-tree, changing the manual.xml.in file, > installing docbook-stuff and compile documentation. Every extension listed in the manual has proper information in reference.xml and friends. It won't take long to add simple information like that mysqli requires mysql 4.1+, or that to compile it you use --with=mysqli (or whatever)... It's an important part of the documentation especially for popular extensions like mysql. The fact that there are now two mysql extensions is confusing enough. Anyway, John has agreed to add this information. Also, we should add to the ext/mysql docs that they won't work with 4.1+. And less importantly, the reference.xml currently holds all constant information with most entries listing the constant name as also the value, that's weird. Also, why does there even need to be a constant values column? > > There is lot of other stuff in the manual which could be removed first. The topic of which extensions should be generated is another story, and BC comes into play. Regards, Philip