On Jan 9, 2008 1:57 PM, Simion Onea <[EMAIL PROTECTED]> wrote:
> Hi!
>
> While translating the file "appendices/migration52.xml" I found an 
> interesting situation in the lists of new/changed functions in different 
> extensions.
> For example, take lines 736 and 746. They mention two functions in the SPL 
> and XMLReader extensions respectively:
>   array iterator_to_array(Traversable it [, bool use_keys = true])
> and
>   <function>XMLReader::open</function>
>
> Notice that in one case the complete function definition is used, while in 
> the second case only the function name is used.
> There are many such situations in this file. What should we do in this case? 
> I think it would be good to bring them to a common format and apply the 
> necessary tags.
> I can take this task.

If the function isn't documented yet then I think the full
funcsynopsis is needed, for documented functions it is enough to name
the function (and the new parameter when appropriate).

-Hannes

Reply via email to