Add pointers to newer classes provided by the OS

1 files changed, 6 insertions, 2 deletions

diff --git a/Foundation/GTMNSString+URLArguments.h b/Foundation/GTMNSString+URLArguments.h
index d4c7e09..b3a3e3e 100644
--- a/Foundation/GTMNSString+URLArguments.h
+++ b/Foundation/GTMNSString+URLArguments.h
@@ -22,7 +22,7 @@
 @interface NSString (GTMNSStringURLArgumentsAdditions)
 
 /// Returns a string that is escaped properly to be a URL argument.
-//
+///
 /// This differs from stringByAddingPercentEscapesUsingEncoding: in that it
 /// will escape all the reserved characters (per RFC 3986
 /// <http://www.ietf.org/rfc/rfc3986.txt>) which
@@ -30,10 +30,14 @@
 ///
 /// This will also escape '%', so this should not be used on a string that has
 /// already been escaped unless double-escaping is the desired result.
+///
+/// NOTE: Apps targeting iOS 8 or OS X 10.10 and later should use
+///       NSURLComponents and NSURLQueryItem to create properly-escaped
+///       URLs instead of using these category methods.
 - (NSString*)gtm_stringByEscapingForURLArgument;
 
 /// Returns the unescaped version of a URL argument
-//
+///
 /// This has the same behavior as stringByReplacingPercentEscapesUsingEncoding:,
 /// except that it will also convert '+' to space.
 - (NSString*)gtm_stringByUnescapingFromURLArgument;