diff --git a/core/includes/common.inc b/core/includes/common.inc
index b3dc9cb..d55b807 100644
--- a/core/includes/common.inc
+++ b/core/includes/common.inc
@@ -1698,13 +1698,13 @@ function format_xml_elements($array) {
  *
  * For example:
  * @code
- *   $output = format_plural($node->comment_count, '1 comment', '@count comments');
+ *   $output = format_plural($node->comment_count, '@count comment', '@count comments');
  * @endcode
  *
  * Example with additional replacements:
  * @code
  *   $output = format_plural($update_count,
- *     'Changed the content type of 1 post from %old-type to %new-type.',
+ *     'Changed the content type of @count post from %old-type to %new-type.',
  *     'Changed the content type of @count posts from %old-type to %new-type.',
  *     array('%old-type' => $info->old_type, '%new-type' => $info->new_type));
  * @endcode
@@ -1713,8 +1713,9 @@ function format_xml_elements($array) {
  *   The item count to display.
  * @param $singular
  *   The string for the singular case. Make sure it is clear this is singular,
- *   to ease translation (e.g. use "1 new comment" instead of "1 new"). Do not
- *   use @count in the singular string.
+ *   to ease translation (e.g. use "@count new comment" instead of "@count
+ *   new"). Make sure to use @count in the singular string, so that it will
+ *   appear in the exported .po files.
  * @param $plural
  *   The string for the plural case. Make sure it is clear this is plural, to
  *   ease translation. Use @count in place of the item count, as in