[fw-db] Non obvious parameter

Hi,

Here is some random feedback on the way method are document.
IMHO When implementing a method it should be quite obvious what to pass
in parameter or it should be implement in an other way.

In Zend I see a lot of comment like:

@param mixed $spec The column(s) and direction to order by

qWhat the hell is this strange obscure mixed parameter?
It could be:

array('col_name1', 'col_name2')
array('col_name1' => 'ASC', 'col_name2' => 'DESC')
array('col_name1', 'col_name2' => 'DESC')
'col_name1 ASC, col_name2 DESC'
'col_name1, col_name2 DESC'
array('ASC' => array( 'col_name2', 'col_name1'))
array('col_name1 ASC', 'col_name2 DESC')
...

Do you suggest me to flip the coin?

--
-- Mathieu Suen
--