Fix/cleanup YUIDoc.

Sets up main methods with YUIDoc annotations (so that `then`, `catch`, `finally` show up in the docs at least).