[ docbook-RFEs-2021383 ] Is 'rep' on methodparam a mistake?

[SourceForge.net <no...@so...>]

RFEs item #2021383, was opened at 2008-07-18 06:55
Message generated for change (Settings changed) made by nwalsh
You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=384107&aid=2021383&group_id=21935

Please note that this message will contain a full copy of the comment thread,
including the initial issue submission, for this request,
not just the latest update.
Category: DocBook
Group: v6.0
Status: Open
>Resolution: Rejected
Priority: 5
Private: No
Submitted By: Norman Walsh (nwalsh)
Assigned to: Norman Walsh (nwalsh)
Summary: Is 'rep' on methodparam a mistake?

Initial Comment:
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.

----------------------------------------------------------------------

>Comment By: Norman Walsh (nwalsh)
Date: 2009-03-25 14:09

Message:
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.


----------------------------------------------------------------------

Comment By: Norman Walsh (nwalsh)
Date: 2009-01-21 16:36

Message:
Looks like it was a mistake.

http://markmail.org/search/?q=list%3Adocbook+rep+methodparam+repeatable#query:list%3Adocbook%20rep%20methodparam%20repeatable+page:1+mid:qluorttkaeb6lmnx+state:results


----------------------------------------------------------------------

Comment By: Hannes Magnusson (bjori)
Date: 2008-08-26 05:08

Message:
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.


----------------------------------------------------------------------

You can respond by visiting: 
https://sourceforge.net/tracker/?func=detail&atid=384107&aid=2021383&group_id=21935