diff --git a/dialog.module b/dialog.module
index 6b771d4..04076a7 100644
--- a/dialog.module
+++ b/dialog.module
@@ -202,7 +202,7 @@ function dialog_library_alter(&$libraries, $module) {
  * The normalized type is a short, lowercase version of the format, such as
  * 'html', 'json' or 'atom'.
  *
- * @return
+ * @return string|bool
  *   The normalized type of a given request as a string or FALSE if a format
  *   could not be detected.
  */
diff --git a/includes/dialog.commands.inc b/includes/dialog.commands.inc
index ccf8b42..109306f 100644
--- a/includes/dialog.commands.inc
+++ b/includes/dialog.commands.inc
@@ -13,7 +13,7 @@
  * @param bool $persist
  *   (optional) Whether to persist the dialog in the DOM or not.
  *
- * @return
+ * @return array
  *   An array suitable for use with the ajax_render() function.
  */
 function dialog_command_close_dialog($selector = NULL, $persist = FALSE) {
@@ -30,7 +30,7 @@ function dialog_command_close_dialog($selector = NULL, $persist = FALSE) {
  * @param bool $persist
  *   (optional) Whether to persist the dialog in the DOM or not.
  *
- * @return
+ * @return array
  *   An array suitable for use with the ajax_render() function.
  */
 function dialog_command_close_modal_dialog($persist = FALSE) {
@@ -55,7 +55,7 @@ function dialog_command_close_modal_dialog($persist = FALSE) {
  *   on the content of the dialog. If left empty, the settings will be
  *   populated automatically from the current request.
  *
- * @return
+ * @return array
  *   An array suitable for use with the ajax_render() function.
  */
 function dialog_command_open_dialog($selector, $title, $content, array $dialog_options = array(), $settings = NULL) {
@@ -102,7 +102,7 @@ function dialog_command_open_dialog($selector, $title, $content, array $dialog_o
  *   on the content of the dialog. If left empty, the settings will be
  *   populated automatically from the current request.
  *
- * @return
+ * @return array
  *   An array suitable for use with the ajax_render() function.
  */
 function dialog_command_open_modal_dialog($title, $content, array $dialog_options = array(), $settings = NULL) {
@@ -123,7 +123,7 @@ function dialog_command_open_modal_dialog($title, $content, array $dialog_option
  * @param mixed $option_value
  *   The value of the option to be passed to the dialog.
  *
- * @return
+ * @return array
  *   An array suitable for use with the ajax_render() function.
  */
 function dialog_command_set_dialog_option($selector, $option_name, $option_value) {
@@ -144,7 +144,7 @@ function dialog_command_set_dialog_option($selector, $option_name, $option_value
  * @param string $title
  *   The title that will be set on the dialog.
  *
- * @return
+ * @return array
  *   An array suitable for use with the ajax_render() function.
  */
 function dialog_command_set_dialog_title($selector, $title) {
diff --git a/modules/dialog_comment/dialog_comment.module b/modules/dialog_comment/dialog_comment.module
index 2bd45b9..07332c8 100644
--- a/modules/dialog_comment/dialog_comment.module
+++ b/modules/dialog_comment/dialog_comment.module
@@ -72,6 +72,9 @@ function dialog_comment_theme_registry_alter(&$theme_registry) {
  *   An associative array containing:
  *   - node: The comment node.
  *
+ * @return string
+ *   Returns a link.
+ *
  * @ingroup themeable
  */
 function dialog_comment_comment_post_forbidden($variables) {