From 2f548f1e6b3b1b737ad5ba52b0e919558cac8b08 Mon Sep 17 00:00:00 2001
From: Drew Jaynes <info@drewapicture.com>
Date: Thu, 19 Sep 2013 02:27:09 +0000
Subject: [PATCH] Add phpdoc blocks in wp-admin/credits.php.

Props siobhan, markoheijnen.
Fixes #20425.

Built from https://develop.svn.wordpress.org/trunk@25491


git-svn-id: http://core.svn.wordpress.org/trunk@25412 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-admin/credits.php | 29 +++++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)

diff --git a/wp-admin/credits.php b/wp-admin/credits.php
index 35a906e891..65da470494 100644
--- a/wp-admin/credits.php
+++ b/wp-admin/credits.php
@@ -11,6 +11,15 @@ require_once( './admin.php' );
 
 $title = __( 'Credits' );
 
+/**
+ * Retrieve the contributor credits.
+ *
+ * @global string $wp_version The current WordPress version.
+ *
+ * @since 3.2.0
+ *
+ * @return array A list of all of the contributors.
+*/
 function wp_credits() {
 	global $wp_version;
 	$locale = get_locale();
@@ -36,10 +45,30 @@ function wp_credits() {
 	return $results;
 }
 
+/**
+ * Retrieve the link to a contributor's WordPress.org profile page.
+ *
+ * @access private
+ * @since 3.2.0
+ *
+ * @param string &$display_name The contributor's display name, passed by reference.
+ * @param string $user_name     The contributor's username.
+ * @param string $profiles      URL to the contributor's WordPress.org profile page.
+ * @return string A contributor's display name, hyperlinked to a WordPress.org profile page.
+ */
 function _wp_credits_add_profile_link( &$display_name, $username, $profiles ) {
 	$display_name = '<a href="' . esc_url( sprintf( $profiles, $username ) ) . '">' . esc_html( $display_name ) . '</a>';
 }
 
+/**
+ * Retrieve the link to an external library used in WordPress.
+ *
+ * @access private
+ * @since 3.2.0
+ *
+ * @param string &$data External library data, passed by reference.
+ * @return string Link to the external library.
+ */
 function _wp_credits_build_object_link( &$data ) {
 	$data = '<a href="' . esc_url( $data[1] ) . '">' . $data[0] . '</a>';
 }