From 2d2353cbde52e927dfc436291b19d2d03d6cb2d1 Mon Sep 17 00:00:00 2001
From: Eric Lewis <eric.andrew.lewis@gmail.com>
Date: Wed, 27 Jan 2016 02:55:27 +0000
Subject: [PATCH] General: Document the difference between site_url() and
 home_url().

`site_url()` returns a url where WordPress application files are accessible (e.g. where the `wp-admin/` folder resides). `home_url()` returns a url where the front-end of the WordPress site can be visited.

See #35238.

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


git-svn-id: http://core.svn.wordpress.org/trunk@36375 1a063a9b-81f0-0310-95a4-ce76da25c4cd
---
 wp-includes/link-template.php | 10 ++++++----
 wp-includes/version.php       |  2 +-
 2 files changed, 7 insertions(+), 5 deletions(-)

diff --git a/wp-includes/link-template.php b/wp-includes/link-template.php
index 4a1a5cb8b3..ee02cd732a 100644
--- a/wp-includes/link-template.php
+++ b/wp-includes/link-template.php
@@ -2925,7 +2925,7 @@ function get_shortcut_link() {
 }
 
 /**
- * Retrieve the home url for the current site.
+ * Retrieve the url for the current site where the front-end of the site is accessible.
  *
  * Returns the 'home' option with the appropriate protocol, 'https' if
  * {@see is_ssl()} and 'http' otherwise. If `$scheme` is 'http' or 'https',
@@ -2943,7 +2943,7 @@ function home_url( $path = '', $scheme = null ) {
 }
 
 /**
- * Retrieve the home url for a given site.
+ * Retrieve the url for a given site where the front-end of the site is accessible.
  *
  * Returns the 'home' option with the appropriate protocol, 'https' if
  * {@see is_ssl()} and 'http' otherwise. If `$scheme` is 'http' or 'https',
@@ -3000,7 +3000,8 @@ function get_home_url( $blog_id = null, $path = '', $scheme = null ) {
 }
 
 /**
- * Retrieve the site url for the current site.
+ * Retrieve the url for the current site where WordPress application files
+ * (e.g. wp-blog-header.php or the wp-admin/ folder) are accessible.
  *
  * Returns the 'site_url' option with the appropriate protocol, 'https' if
  * is_ssl() and 'http' otherwise. If $scheme is 'http' or 'https', is_ssl() is
@@ -3017,7 +3018,8 @@ function site_url( $path = '', $scheme = null ) {
 }
 
 /**
- * Retrieve the site url for a given site.
+ * Retrieve the url for a given site where WordPress application files
+ * (e.g. wp-blog-header.php or the wp-admin/ folder) are accessible.
  *
  * Returns the 'site_url' option with the appropriate protocol, 'https' if
  * {@see is_ssl()} and 'http' otherwise. If `$scheme` is 'http' or 'https',
diff --git a/wp-includes/version.php b/wp-includes/version.php
index 13f5d7fe6b..0216715cc2 100644
--- a/wp-includes/version.php
+++ b/wp-includes/version.php
@@ -4,7 +4,7 @@
  *
  * @global string $wp_version
  */
-$wp_version = '4.5-alpha-36407';
+$wp_version = '4.5-alpha-36408';
 
 /**
  * Holds the WordPress DB revision, increments when changes are made to the WordPress DB schema.