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
