From 747243cc0e35a34cd48c12fed6b7d4430cd68997 Mon Sep 17 00:00:00 2001
From: zzak <zzak@b2dd03c8-39d4-4d8f-98ff-823fe69b080e>
Date: Sun, 27 Jul 2014 21:27:10 +0000
Subject: [PATCH] * lib/uri/common.rb: [DOC] [Bug #9563] Recommend using
 URI.escape   before parsing a uri to avoid invalid characters. Reported by  
 Evgeniy Serykh.

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@46984 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
---
 ChangeLog         | 6 ++++++
 lib/uri/common.rb | 3 +++
 2 files changed, 9 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 7c1a26ebae..6445c04122 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+Mon Jul 28 06:24:54 2014  Zachary Scott  <e@zzak.io>
+
+	* lib/uri/common.rb: [DOC] [Bug #9563] Recommend using URI.escape
+	  before parsing a uri to avoid invalid characters. Reported by
+	  Evgeniy Serykh.
+
 Mon Jul 28 05:55:56 2014  Zachary Scott  <e@zzak.io>
 
 	* time.c: [DOC] Clarify %Y in strftime, which can accept any digits
diff --git a/lib/uri/common.rb b/lib/uri/common.rb
index 006b271477..6378541cbe 100644
--- a/lib/uri/common.rb
+++ b/lib/uri/common.rb
@@ -219,6 +219,9 @@ module URI
   #   p uri.host
   #   # => "www.ruby-lang.org"
   #
+  # It's recommended to first ::escape the provided +uri_str+ if there are any
+  # invalid URI characters.
+  #
   def self.parse(uri)
     RFC3986_PARSER.parse(uri)
   end