Index: post.php
===================================================================
--- post.php	(revision 45778)
+++ post.php	(working copy)
@@ -4881,7 +4881,15 @@
 /**
  * Retrieve a page given its title.
  *
+ * If more than one post uses the same title, the post with the smallest ID will be returned.
+ * Be careful, In case of more than one post used the same title, it will check the oldest
+ * publication date not the smallest ID.
+ *
+ * Because this function uses the MySQL '=' comparison the $page_title will usually be matched
+ * as case insensitive with default collating.
+ *
  * @since 2.1.0
+ * @since 3.0.0 $post_type parameter was added.
  *
  * @global wpdb $wpdb WordPress database abstraction object.
  *