drush_confirm() code comments have several issues that need fixed to make them display properly on the API site, and to conform to Drupal's Doxygen and comment formatting conventions. Most importantly...
- The function doesn't appear on api.drush.org at all due (I believe) to an unclosed
@defgroupcomment right above it.
@returndirectives are incomplete and misformatted.
Patch to follow.