diff --git a/wp-admin/install-helper.php b/wp-admin/install-helper.php
index fb0d8f3216..b64494af44 100644
--- a/wp-admin/install-helper.php
+++ b/wp-admin/install-helper.php
@@ -10,26 +10,25 @@
* needing to use these functions a lot, you might experience time outs. If you
* do, then it is advised to just write the SQL code yourself.
*
- *
- * check_column('wp_links', 'link_description', 'mediumtext');
- * if (check_column($wpdb->comments, 'comment_author', 'tinytext'))
- * echo "ok\n";
+ * check_column( 'wp_links', 'link_description', 'mediumtext' );
+ * if ( check_column( $wpdb->comments, 'comment_author', 'tinytext' ) ) {
+ * echo "ok\n";
+ * }
*
- * $error_count = 0;
- * $tablename = $wpdb->links;
- * // check the column
- * if (!check_column($wpdb->links, 'link_description', 'varchar(255)')) {
- * $ddl = "ALTER TABLE $wpdb->links MODIFY COLUMN link_description varchar(255) NOT NULL DEFAULT '' ";
- * $q = $wpdb->query($ddl);
- * }
+ * $error_count = 0;
+ * $tablename = $wpdb->links;
+ * // Check the column.
+ * if ( ! check_column($wpdb->links, 'link_description', 'varchar( 255 )' ) ) {
+ * $ddl = "ALTER TABLE $wpdb->links MODIFY COLUMN link_description varchar(255) NOT NULL DEFAULT '' ";
+ * $q = $wpdb->query( $ddl );
+ * }
*
- * if (check_column($wpdb->links, 'link_description', 'varchar(255)')) {
- * $res .= $tablename . ' - ok
';
- * } else {
- * $res .= 'There was a problem with ' . $tablename . '
';
- * ++$error_count;
- * }
- *
+ * if ( check_column( $wpdb->links, 'link_description', 'varchar( 255 )' ) ) {
+ * $res .= $tablename . ' - ok
';
+ * } else {
+ * $res .= 'There was a problem with ' . $tablename . '
';
+ * ++$error_count;
+ * }
*
* @package WordPress
* @subpackage Plugin
diff --git a/wp-includes/l10n.php b/wp-includes/l10n.php
index 978835e257..8d4fedefd7 100644
--- a/wp-includes/l10n.php
+++ b/wp-includes/l10n.php
@@ -76,7 +76,7 @@ function get_locale() {
*
* If there is no translation, or the text domain isn't loaded, the original text is returned.
*
- * Note: Don't use translate() directly, use __() or related functions.
+ * *Note:* Don't use {@see translate()} directly, use `{@see __()} or related functions.
*
* @since 2.2.0
*
@@ -87,6 +87,7 @@ function get_locale() {
function translate( $text, $domain = 'default' ) {
$translations = get_translations_for_domain( $domain );
$translations = $translations->translate( $text );
+
/**
* Filter text with its translation.
*
@@ -364,15 +365,14 @@ function _nx($single, $plural, $number, $context, $domain = 'default') {
* strings and use them later.
*
* Example:
- *
- * $messages = array(
- * 'post' => _n_noop('%s post', '%s posts'),
- * 'page' => _n_noop('%s pages', '%s pages')
- * );
- * ...
- * $message = $messages[$type];
- * $usable_text = sprintf( translate_nooped_plural( $message, $count ), $count );
- *
+ *
+ * $messages = array(
+ * 'post' => _n_noop( '%s post', '%s posts' ),
+ * 'page' => _n_noop( '%s pages', '%s pages' ),
+ * );
+ * ...
+ * $message = $messages[ $type ];
+ * $usable_text = sprintf( translate_nooped_plural( $message, $count ), $count );
*
* @since 2.5.0
*
diff --git a/wp-includes/media.php b/wp-includes/media.php
index 00bf9db3d9..40a2922e25 100644
--- a/wp-includes/media.php
+++ b/wp-includes/media.php
@@ -3100,7 +3100,7 @@ function get_attached_media( $type, $post = 0 ) {
}
/**
- * Check the content blob for an