The update to 1354 was a good reorganization and rewrite.
During it, some of the long examples of @params were taken out. http://drupal.org/node/1354/revisions/view/2415402/2546068
under (optional) there is no longer in the examples: Defaults to Blah.
Is it still the standard to have Defaults to... ?
for example
-* @param bool $third
-* (optional) TRUE if Third should be done. Defaults to FALSE.- * - element: (optional) Integer to distinguish between multiple pagers on one
- * page. Defaults to 0 (zero).