Re: using the new doc format

Looks much better Philip, http://livedocs.homelinux.com/en/function.mysqli-connect.html with the source http://cvs.php.net/co.php/phpdoc/en/reference/mysqli/functions/mysqli-connect.xml?r=1.15 incase anyone was lazy Why does the spacing start at 2? "Philip Olson" <philip@cornado.com> wrote in message news:Pine.BSF.4.10.10408052148440.78550-100000@merlin.pegasi.net... > Hello! > > We agreed to use the new format so newly introduced documentation > should use it. Examples of its use can be found in the exif and > mysqli docs; and within the HOWTO. Many of the new entities live > within language-defs.ent For functions, the order should be: > > Description > Return Values > CHANGELOG > Examples > See Also > > All documentation moved from peardoc into phpdoc should use this > new format. > > Conversion of the current phpdocs should wait until it's figured > out how it'll be done. How about we implement a checkout system > where one person works on an entire extension one at a time and > during this process the following could also take place: > > - Implement newly introduced entities, like &example.output; > - Implement the CHANGELOG > - Rewrite all examples to meet our coding standards (CS) > - Fix whitespace (WS) > - Anything else? > > If doing all of this together is difficult for translators then > it could be split up but it seems like a prime time to update > everything. > > Regards, > Philip