From acb441a51977a27953a02b750a325df88166cbba Mon Sep 17 00:00:00 2001 From: Drew Jaynes Date: Sat, 26 Oct 2013 20:28:34 +0000 Subject: [PATCH] Inline documentation for hooks in wp-admin/includes/schema.php. Props johnafish, kpdesign. Fixes #25498. git-svn-id: https://develop.svn.wordpress.org/trunk@25938 602fd350-edb4-49c9-b593-d223f7449a82 --- src/wp-admin/includes/schema.php | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/src/wp-admin/includes/schema.php b/src/wp-admin/includes/schema.php index f88f79d052..ef626c3c6b 100644 --- a/src/wp-admin/includes/schema.php +++ b/src/wp-admin/includes/schema.php @@ -330,8 +330,12 @@ function populate_options() { global $wpdb, $wp_db_version, $current_site, $wp_current_db_version; $guessurl = wp_guess_url(); - - do_action('populate_options'); + /** + * Fires before creating WordPress options and populating their default values. + * + * @since 2.6.0 + */ + do_action( 'populate_options' ); if ( ini_get('safe_mode') ) { // Safe mode can break mkdir() so use a flat structure by default. @@ -841,13 +845,13 @@ function install_network() { endif; /** - * populate network settings + * Populate network settings. * * @since 3.0.0 * - * @param int $network_id id of network to populate + * @param int $network_id ID of network to populate. * @return bool|WP_Error True on success, or WP_Error on warning (with the install otherwise successful, - * so the error code must be checked) or failure. + * so the error code must be checked) or failure. */ function populate_network( $network_id = 1, $domain = '', $email = '', $site_name = '', $path = '/', $subdomain_install = false ) { global $wpdb, $current_site, $wp_db_version, $wp_rewrite; @@ -945,8 +949,8 @@ We hope you enjoy your new site. Thanks! * * @since 3.7.0 * - * @param array $sitemeta Associative of meta keys and values to be inserted. - * @param int $network_id Network ID being created. + * @param array $sitemeta Associative array of network meta keys and values to be inserted. + * @param int $network_id ID of network to populate. */ $sitemeta = apply_filters( 'populate_network_meta', $sitemeta, $network_id );