[Webkit-unassigned] [Bug 18383] New: [GTK] The "hovering-over-link" signal arguments aren't documented.

[bugzilla-daemon at webkit.org]

http://bugs.webkit.org/show_bug.cgi?id=18383

           Summary: [GTK] The "hovering-over-link" signal arguments aren't
                    documented.
           Product: WebKit
           Version: 526+ (Nightly build)
          Platform: All
        OS/Version: All
            Status: UNCONFIRMED
          Severity: Trivial
          Priority: P2
         Component: WebKit API
        AssignedTo: webkit-unassigned at lists.webkit.org
        ReportedBy: carlos at cmartin.tk


As the title says, the arguments passed to the "hovering-over-link" signal
callback aren't documented and you have to grep the source to figure out the
order. This patch documents it.

I can't see any option to attach the patch, so I'm posting it inline. I hope it
doesn'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'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("hovering-over-link",
             G_TYPE_FROM_CLASS(webViewClass),
             (GSignalFlags)(G_SIGNAL_RUN_LAST | G_SIGNAL_ACTION),


-- 
Configure bugmail: http://bugs.webkit.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug, or are watching the assignee.