From 9d57742bb5f4a5d3c2871b835c0d87dc4257bc32 Mon Sep 17 00:00:00 2001
From: Peter Westwood <westi@git.wordpress.org>
Date: Sat, 22 Nov 2008 10:39:58 +0000
Subject: [PATCH] phpdoc and notice fix for wp_page_menu(). Fixes #8315 props
 jacobsantos.

git-svn-id: https://develop.svn.wordpress.org/trunk@9844 602fd350-edb4-49c9-b593-d223f7449a82
---
 wp-includes/post-template.php | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/wp-includes/post-template.php b/wp-includes/post-template.php
index 703e84be66..bb1c0cebdd 100644
--- a/wp-includes/post-template.php
+++ b/wp-includes/post-template.php
@@ -635,7 +635,25 @@ function wp_list_pages($args = '') {
 }
 
 /**
- * Display menu of pages.
+ * Display or retrieve list of pages with optional home link.
+ *
+ * The arguments are listed below and part of the arguments are for {@link
+ * wp_list_pages()} function. Check that function for more info on those
+ * arguments.
+ *
+ * <ul>
+ * <li><strong>sort_column</strong> - How to sort the list of pages. Defaults
+ * to page title. Use column for posts table.</li>
+ * <li><strong>menu_class</strong> - Class to use for the div ID which contains
+ * the page list. Defaults to 'menu'.</li>
+ * <li><strong>echo</strong> - Whether to echo list or return it. Defaults to
+ * echo.</li>
+ * <li><strong>link_before</strong> - Text before show_home argument text.</li>
+ * <li><strong>link_after</strong> - Text after show_home argument text.</li>
+ * <li><strong>show_home</strong> - If you set this argument, then it will
+ * display the link to the home page. The show_home argument really just needs
+ * to be set to the value of the text of the link.</li>
+ * </ul>
  *
  * @since 2.7.0
  *
@@ -649,7 +667,7 @@ function wp_page_menu( $args = array() ) {
 	$menu = '';
 
 	// Show Home in the menu
-	if ( !empty($args['show_home']) ) {
+	if ( isset($args['show_home']) && ! empty($args['show_home']) ) {
 		if ( true === $args['show_home'] || '1' === $args['show_home'] || 1 === $args['show_home'] )
 			$text = __('Home');
 		else