Changeset 41289 for trunk/src/wp-includes/ms-functions.php

Timestamp:

08/22/2017 11:51:11 AM (7 years ago)

Author:

johnbillion

Message:

General: Improve terminology used when referring to installations of WordPress and its extensions.

"Install" is not a noun, and while it might be acceptable to use the verb as a noun, it is not correct. Using the correct
noun, "installation", increases clarity, especially for non-native English speakers.

This change fixes the usage in user-facing text and in developer documentation.

Fixes #41620

File:

• trunk/src/wp-includes/ms-functions.php (modified) (10 diffs)

trunk/src/wp-includes/ms-functions.php

@@ -587 +587 @@
 
     /*
-     * On sub dir installs, some names are so illegal, only a filter can
+     * On sub dir installations, some names are so illegal, only a filter can
      * spring them from jail.
      */
@@ -681 +681 @@
      *
      *     @type string         $domain     Domain for the site.
-     *     @type string         $path       Path for the site. Used in subdirectory installs.
+     *     @type string         $path       Path for the site. Used in subdirectory installations.
      *     @type string         $blogname   The unique site name (slug).
      *     @type string         $blog_title Blog title.
@@ -1165 +1165 @@
  * for events that should affect all new sites.
  *
- * On subdirectory installs, $domain is the same as the main site's
+ * On subdirectory installations, $domain is the same as the main site's
  * domain, and the path is the subdirectory name (eg 'example.com'
- * and '/blog1/'). On subdomain installs, $domain is the new subdomain +
+ * and '/blog1/'). On subdomain installations, $domain is the new subdomain +
  * root domain (eg 'blog1.example.com'), and $path is '/'.
  *
@@ -1181 +1181 @@
  *                           updated. Otherwise, keys and values will be used to set options for
  *                           the new site. Default empty array.
- * @param int    $network_id Optional. Network ID. Only relevant on multi-network installs.
+ * @param int    $network_id Optional. Network ID. Only relevant on multi-network installations.
  * @return int|WP_Error Returns WP_Error object on failure, the new site ID on success.
  */
@@ -1241 +1241 @@
      * @param string $domain     Site domain.
      * @param string $path       Site path.
-     * @param int    $network_id Network ID. Only relevant on multi-network installs.
+     * @param int    $network_id Network ID. Only relevant on multi-network installations.
      * @param array  $meta       Meta data. Used to set initial site options.
      */
@@ -1353 +1353 @@
  * @param string $domain     The domain to be checked.
  * @param string $path       The path to be checked.
- * @param int    $network_id Optional. Network ID. Relevant only on multi-network installs.
+ * @param int    $network_id Optional. Network ID. Relevant only on multi-network installations.
  * @return int
  */
@@ -1375 +1375 @@
      * @param string   $domain     Domain to be checked.
      * @param string   $path       Path to be checked.
-     * @param int      $network_id Network ID. Relevant only on multi-network installs.
+     * @param int      $network_id Network ID. Relevant only on multi-network installations.
      */
     return apply_filters( 'domain_exists', $result, $domain, $path, $network_id );
@@ -1392 +1392 @@
  * @param string $domain     The domain of the new site.
  * @param string $path       The path of the new site.
- * @param int    $network_id Unless you're running a multi-network install, be sure to set this value to 1.
+ * @param int    $network_id Unless you're running a multi-network installation, be sure to set this value to 1.
  * @return int|false The ID of the new row
  */
@@ -2571 +2571 @@
 
 /**
- * Retrieves a list of reserved site on a sub-directory Multisite install.
+ * Retrieves a list of reserved site on a sub-directory Multisite installation.
  *
  * @since 4.4.0
@@ -2584 +2584 @@
 
     /**
-     * Filters reserved site names on a sub-directory Multisite install.
+     * Filters reserved site names on a sub-directory Multisite installation.
      *
      * @since 3.0.0