<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugs.webkit.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4.1"
          urlbase="https://bugs.webkit.org/"
          
          maintainer="admin@webkit.org"
>

    <bug>
          <bug_id>18383</bug_id>
          
          <creation_ts>2008-04-09 06:53:06 -0700</creation_ts>
          <short_desc>[GTK] The &quot;hovering-over-link&quot; signal arguments aren&apos;t documented.</short_desc>
          <delta_ts>2008-05-30 07:17:53 -0700</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>WebKit</product>
          <component>WebKit API</component>
          <version>528+ (Nightly build)</version>
          <rep_platform>All</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>Trivial</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Carlos Martín Nieto">carlos</reporter>
          <assigned_to name="Nobody">webkit-unassigned</assigned_to>
          <cc>jmalonzo</cc>
          

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>76718</commentid>
    <comment_count>0</comment_count>
    <who name="Carlos Martín Nieto">carlos</who>
    <bug_when>2008-04-09 06:53:06 -0700</bug_when>
    <thetext>As the title says, the arguments passed to the &quot;hovering-over-link&quot; signal callback aren&apos;t documented and you have to grep the source to figure out the order. This patch documents it.

I can&apos;t see any option to attach the patch, so I&apos;m posting it inline. I hope it doesn&apos;t get scrambled.

Index: WebKit/gtk/webkit/webkitwebview.cpp
===================================================================
--- WebKit/gtk/webkit/webkitwebview.cpp (revision 31670)
+++ WebKit/gtk/webkit/webkitwebview.cpp (working copy)
@@ -781,6 +781,14 @@
             WEBKIT_TYPE_WEB_FRAME,
             G_TYPE_STRING);
 
+    /**
+     * WebKitWebView::hovering-over-link:
+     * @web_view: the object on which the signal is emitted
+     * @title: the link&apos;s title
+     * @uri: the URI the link points to
+     *
+     * When the cursor is over a link, this signal is emitted.
+     */
     webkit_web_view_signals[HOVERING_OVER_LINK] = g_signal_new(&quot;hovering-over-link&quot;,
             G_TYPE_FROM_CLASS(webViewClass),
             (GSignalFlags)(G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION),</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>76719</commentid>
    <comment_count>1</comment_count>
      <attachid>20429</attachid>
    <who name="Carlos Martín Nieto">carlos</who>
    <bug_when>2008-04-09 06:55:19 -0700</bug_when>
    <thetext>Created attachment 20429
Document the &quot;hoving-over-link&quot; signal arguments.

Here is the upload. I think the inline one is damaged.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81525</commentid>
    <comment_count>2</comment_count>
    <who name="Jan Alonzo">jmalonzo</who>
    <bug_when>2008-05-26 05:35:51 -0700</bug_when>
    <thetext>Hi Carlos

Thanks for the patch. Can you please set the &quot;Attachment Flags&quot; to &quot;r?&quot;, setting it for review so reviewers can review it?

Thanks.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81527</commentid>
    <comment_count>3</comment_count>
    <who name="Carlos Martín Nieto">carlos</who>
    <bug_when>2008-05-26 08:15:17 -0700</bug_when>
    <thetext>Done. Thanks for telling me, I didn&apos;t know I had to do that.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>81929</commentid>
    <comment_count>4</comment_count>
    <who name="Jan Alonzo">jmalonzo</who>
    <bug_when>2008-05-30 07:17:53 -0700</bug_when>
    <thetext>Landed in r34263</thetext>
  </long_desc>
      
          <attachment
              isobsolete="0"
              ispatch="1"
              isprivate="0"
          >
            <attachid>20429</attachid>
            <date>2008-04-09 06:55:19 -0700</date>
            <delta_ts>2008-05-29 09:20:59 -0700</delta_ts>
            <desc>Document the &quot;hoving-over-link&quot; signal arguments.</desc>
            <filename>webkit-hover-link.patch</filename>
            <type>text/plain</type>
            <size>777</size>
            <attacher name="Carlos Martín Nieto">carlos</attacher>
            
              <data encoding="base64">SW5kZXg6IFdlYktpdC9ndGsvd2Via2l0L3dlYmtpdHdlYnZpZXcuY3BwCj09PT09PT09PT09PT09
PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0KLS0t
IFdlYktpdC9ndGsvd2Via2l0L3dlYmtpdHdlYnZpZXcuY3BwCShyZXZpc2lvbiAzMTY3MCkKKysr
IFdlYktpdC9ndGsvd2Via2l0L3dlYmtpdHdlYnZpZXcuY3BwCSh3b3JraW5nIGNvcHkpCkBAIC03
ODEsNiArNzgxLDE0IEBACiAgICAgICAgICAgICBXRUJLSVRfVFlQRV9XRUJfRlJBTUUsCiAgICAg
ICAgICAgICBHX1RZUEVfU1RSSU5HKTsKIAorICAgIC8qKgorICAgICAqIFdlYktpdFdlYlZpZXc6
OmhvdmVyaW5nLW92ZXItbGluazoKKyAgICAgKiBAd2ViX3ZpZXc6IHRoZSBvYmplY3Qgb24gd2hp
Y2ggdGhlIHNpZ25hbCBpcyBlbWl0dGVkCisgICAgICogQHRpdGxlOiB0aGUgbGluaydzIHRpdGxl
CisgICAgICogQHVyaTogdGhlIFVSSSB0aGUgbGluayBwb2ludHMgdG8KKyAgICAgKgorICAgICAq
IFdoZW4gdGhlIGN1cnNvciBpcyBvdmVyIGEgbGluaywgdGhpcyBzaWduYWwgaXMgZW1pdHRlZC4K
KyAgICAgKi8KICAgICB3ZWJraXRfd2ViX3ZpZXdfc2lnbmFsc1tIT1ZFUklOR19PVkVSX0xJTktd
ID0gZ19zaWduYWxfbmV3KCJob3ZlcmluZy1vdmVyLWxpbmsiLAogICAgICAgICAgICAgR19UWVBF
X0ZST01fQ0xBU1Mod2ViVmlld0NsYXNzKSwKICAgICAgICAgICAgIChHU2lnbmFsRmxhZ3MpKEdf
U0lHTkFMX1JVTl9MQVNUIHwgR19TSUdOQUxfQUNUSU9OKSwK
</data>
<flag name="review"
          id="9325"
          type_id="1"
          status="+"
          setter="alp"
    />
          </attachment>
      

    </bug>

</bugzilla>