diff --git a/lib/jekyll/page.rb b/lib/jekyll/page.rb
index 032fe265..bbdeb868 100644
--- a/lib/jekyll/page.rb
+++ b/lib/jekyll/page.rb
@@ -73,7 +73,8 @@ module Jekyll
       }).to_s
     end
 
-    # See url.rb for an explanation
+    # Returns a hash of URL placeholder names (as symbols) mapping to the
+    # desired placeholder replacements. For details see "url.rb"
     def url_placeholders
       {
         :path       => @dir,
diff --git a/lib/jekyll/post.rb b/lib/jekyll/post.rb
index 8a52efc3..6ecc8b2b 100644
--- a/lib/jekyll/post.rb
+++ b/lib/jekyll/post.rb
@@ -205,7 +205,8 @@ module Jekyll
       }).to_s
     end
 
-    # See url.rb for an explanation
+    # Returns a hash of URL placeholder names (as symbols) mapping to the
+    # desired placeholder replacements. For details see "url.rb"
     def url_placeholders
       {
         :year        => date.strftime("%Y"),