Snipped proposed versions:
> <note role="seealso">
> <para>
> <function>somefunc1</function>
> <function>somefunc2</function>
> </para>
> </note>
> If we want a more list like construct, it's a bit more markup heavy:
>
> <itemizedlist role="seealso">
> <listitem>
> <para><function>somefunc1</function></para>
> </listitem>
> <listitem>
> <para><function>somefunc2</function></para>
> </listitem>
> </itemizedlist>
What would be the advantage of using the list? The first
one looks much nicer except one question, I assume the
following will render fine:
<note role="seealso">
<para>
<function>example</function>
<link linkend="ref.stream">Stream Functions</link>
</para>
</note>
Point is not only functions will be listed and we will
have to be careful on how ',' and 'and' will look. I
can't think of a good example but I know some places
have things that won't fit nicely in this predefined
mold. So, I guess they'll just have to be rewritten
to fit which shouldn't be a big deal.
Regards,
Philip
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
