Learn how easy it is to sync an existing GitHub or Google Code repo to a SourceForge project! See Demo

Close

#252 Is 'rep' on methodparam a mistake?

v6.0
closed-rejected
Norman Walsh
DocBook (176)
5
2009-04-14
2008-07-18
Norman Walsh
No

What does it mean to repeat a method parameter? The same option isn't available on paramdef. I suspect this is an error, but perhaps I'm mistaken.

Discussion

  • Logged In: YES
    user_id=2194052
    Originator: NO

    In PHP there are lot of functions that take variable amount of optional arguments, all of them meaning the same.
    list() for instance uses this methodsynopsis:
    <methodsynopsis>
    <type>void</type><methodname>list</methodname>
    <methodparam><type>mixed</type><parameter>varname</parameter></methodparam>
    <methodparam rep="repeat" choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
    </methodsynopsis>

    Although this is the only case were we actually use this attribute, it does make sense I think.

     
  • Norman Walsh
    Norman Walsh
    2009-03-25

    The TC concluded that it probably was a mistake but that it might have some uses, so we won't make the backwards incompatible change of removing it.

     
  • Norman Walsh
    Norman Walsh
    2009-03-25

    • status: open --> open-rejected
     
  • Norman Walsh
    Norman Walsh
    2009-04-14

    • status: open-rejected --> closed-rejected