Add GetPluginRefererURL to PPB_URLUtil_Dev interface to get the 'Referer' HTTP header value that wa…

ppapi/api/dev/ppb_url_util_dev.idl

Index: ppapi/api/dev/ppb_url_util_dev.idl
===================================================================
--- ppapi/api/dev/ppb_url_util_dev.idl	(revision 219784)
+++ ppapi/api/dev/ppb_url_util_dev.idl	(working copy)
@@ -146,4 +146,13 @@
    */
   PP_Var GetPluginInstanceURL([in] PP_Instance instance,
                               [out] PP_URLComponents_Dev components);
+  /*
+   * Returns the 'Referer' HTTP header value that was sent by the request
+   * that loaded plug-in. Undefined value means 'Referer' header is absent.

[bbudge, 2013/08/27 18:16:07]

Wording is a bit awkward. How about this?
Returns the Referer URL of the HTTP request that loaded the plugin. This is the
value of the 'Referer' header of the request. An undefined value means the
'Referer' header was absent.

+   * The components pointer, if non-NULL and the canonicalized URL is valid,
+   * will identify the components of the resulting URL. Components may be NULL
+   * to specify that no component information is necessary.
+   */
+  PP_Var GetPluginRefererURL([in] PP_Instance instance,
+                             [out] PP_URLComponents_Dev components);
 };