Re: pecl/intl docs

On Nov 28, 2007, at 2:28 PM, Stanislav Malyshev wrote:

Hi! With generous help from Hannes I have now pecl/intl docs brought up to the standards of modern PHP manual documenting. So I intend to merge them with the main manual. They can be seen at: http://cvs.php.net/viewvc.cgi/pecl/intl/doc/intl/ If you see anything wrong with them, please tell me, otherwise I intend to merge them into REF_STRUCT_DEV tree tomorrow.

Hello Stanislav, The main problem I see involves whitespace. For example: - XML must be indented one space, so: <foo> <para> bar </para> </foo> There are some exceptions like <refpurpose>, <methodsynopsis>, short <entry>'s, but the skeletons show those. Mainly I'm referring to <para> problems with sometimes zero, double, triple, quadruple, ... spacing. - PHP code must use the PEAR coding standards

     <programlisting role="php">

<![CDATA[ <?php $a = 'foo'; if ($a === 'foo') {

    echo 'yep';

} ?> ]]>

     </programlisting>

- Width should be about 78 characters, although this is flexible. But really long lines should not exist. Regards, Philip