Gabor Hojtsy wrote:

   <refsect1>
    <title>See also</title>
    <para>
     <function>mysqli_prepare</function>,
     <function>mysqli_stmt_errno</function>,
     <function>mysqli_stmt_error</function>,
     <function>mysqli_bind_result</function>
    </para>
   </refsect1>


as well as the return values, etc. I'm fine with the methodsynopsis ;)


From my view it's easier to read cause you see on first look what you need - you don't have to read the complete text e.g. if you forgot return types, and want to check it in documentation.


This manpage like structure was what I have been proposing for a long time :) Rasmus said that the docs should be consistent, and if we change to this style, it would be logical to change the docs at once. But IMHO we will not be able to do that, and this structure is more logical, so why not to keep it? It does not seem to be confusing.

so we need a mega patch ? ;) I can work on it if needed !


didou

Reply via email to