db: move db methods doc to interface class
replace getAssoc calls with two columns with getPair calls
move PEAR::DB specific @see to DbPear
replace confusing getCol($sql, 0, $params) with getColumn($sql, $params)