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

ppapi/api/dev/ppb_url_util_dev.idl

 /* Copyright (c) 2012 The Chromium Authors. All rights reserved.
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 /**
  * This file defines the <code>PPB_URLUtil_Dev</code> interface.
  */
 
 label Chrome {
   M17 = 0.6

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

You should version the interface (create a 0.7). For an example of this see
ppb_file_chooser_dev.idl:
https://code.google.com/p/chromium/codesearch#chromium/src/ppapi/api/dev/ppb_...

 };
 
 /*
  * A component specifies the range of the part of the URL. The begin specifies
  * the index into the string of the first character of that component. The len
  * specifies the length of that component.
  *
  * This range does not include any special delimiter for that component, so
  * the scheme doesn't include the trailing colon, the username and password
  * don't include the @ and :, the port doesn't include the colon, the query
@@ skipping 117 matching lines @@
    * streamed to the plugin if it were a NPAPI plugin. This is usually the src
    * attribute on the <embed> element, but the rules are obscure and different
    * based on whether the plugin is loaded from an <embed> element or an
    * <object> element.
    * 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 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);
 };