Hi again, http://livedocs.homelinux.com/en/function.mysqli-connect.html
Instead of having each parameter in a paragraph, should we be adopting a more rigid varlist approach? For example: http://pear.php.net/manual/en/package.mail.mail.send.php "Philip Olson" <[EMAIL PROTECTED]> wrote in message news:[EMAIL PROTECTED] > 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
