Title: [100642] trunk/Source/WebKit/gtk
- Revision
- 100642
- Author
- mrobin...@webkit.org
- Date
- 2011-11-17 10:24:44 -0800 (Thu, 17 Nov 2011)
Log Message
[GTK] Remove the last remaining WebKit1 gtkdoc warnings
https://bugs.webkit.org/show_bug.cgi?id=72627
Reviewed by Philippe Normand.
* webkit/webkitdownload.h: Add missing enum documentation.
* webkit/webkiterror.h: Ditto.
* webkit/webkitwebview.h: Ditto.
Modified Paths
Diff
Modified: trunk/Source/WebKit/gtk/ChangeLog (100641 => 100642)
--- trunk/Source/WebKit/gtk/ChangeLog 2011-11-17 18:07:29 UTC (rev 100641)
+++ trunk/Source/WebKit/gtk/ChangeLog 2011-11-17 18:24:44 UTC (rev 100642)
@@ -1,3 +1,14 @@
+2011-11-17 Martin Robinson <mrobin...@igalia.com>
+
+ [GTK] Remove the last remaining WebKit1 gtkdoc warnings
+ https://bugs.webkit.org/show_bug.cgi?id=72627
+
+ Reviewed by Philippe Normand.
+
+ * webkit/webkitdownload.h: Add missing enum documentation.
+ * webkit/webkiterror.h: Ditto.
+ * webkit/webkitwebview.h: Ditto.
+
2011-11-17 Mario Sanchez Prada <msanc...@igalia.com>
[Gtk] Ensure the parent for the webView's a11y object is set.
Modified: trunk/Source/WebKit/gtk/webkit/webkitdownload.h (100641 => 100642)
--- trunk/Source/WebKit/gtk/webkit/webkitdownload.h 2011-11-17 18:07:29 UTC (rev 100641)
+++ trunk/Source/WebKit/gtk/webkit/webkitdownload.h 2011-11-17 18:24:44 UTC (rev 100642)
@@ -34,6 +34,16 @@
#define WEBKIT_IS_DOWNLOAD_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), WEBKIT_TYPE_DOWNLOAD))
#define WEBKIT_DOWNLOAD_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), WEBKIT_TYPE_DOWNLOAD, WebKitDownloadClass))
+/**
+ * WebKitDownloadStatus:
+ * @WEBKIT_DOWNLOAD_STATUS_ERROR: The download failed because of an error other than user cancellation.
+ * @WEBKIT_DOWNLOAD_STATUS_CREATED: The download has not started yet.
+ * @WEBKIT_DOWNLOAD_STATUS_STARTED: The download has started, but has not completed yet.
+ * @WEBKIT_DOWNLOAD_STATUS_CANCELLED: The user canceled the download.
+ * @WEBKIT_DOWNLOAD_STATUS_FINISHED: The download completed successfully.
+ *
+ * Enum values used to denote the various states of a download.
+ **/
typedef enum {
WEBKIT_DOWNLOAD_STATUS_ERROR = -1,
WEBKIT_DOWNLOAD_STATUS_CREATED = 0,
@@ -42,6 +52,14 @@
WEBKIT_DOWNLOAD_STATUS_FINISHED
} WebKitDownloadStatus;
+/**
+ * WebKitDownloadError:
+ * @WEBKIT_DOWNLOAD_ERROR_CANCELLED_BY_USER: The download failed due to user cancellation.
+ * @WEBKIT_DOWNLOAD_ERROR_DESTINATION: The download failed due to disk write failure.
+ * @WEBKIT_DOWNLOAD_ERROR_NETWORK: The download failed due to a network error.
+ *
+ * Enum values used to denote the various download errors.
+ **/
typedef enum {
WEBKIT_DOWNLOAD_ERROR_CANCELLED_BY_USER,
WEBKIT_DOWNLOAD_ERROR_DESTINATION,
Modified: trunk/Source/WebKit/gtk/webkit/webkiterror.h (100641 => 100642)
--- trunk/Source/WebKit/gtk/webkit/webkiterror.h 2011-11-17 18:07:29 UTC (rev 100641)
+++ trunk/Source/WebKit/gtk/webkit/webkiterror.h 2011-11-17 18:24:44 UTC (rev 100642)
@@ -30,6 +30,18 @@
#define WEBKIT_POLICY_ERROR webkit_policy_error_quark ()
#define WEBKIT_PLUGIN_ERROR webkit_plugin_error_quark ()
+/* The enum values are synchronized with Mac's WebKit error values. */
+
+/**
+ * WebKitNetworkError:
+ * @WEBKIT_NETWORK_ERROR_FAILED: Generic load failure
+ * @WEBKIT_NETWORK_ERROR_TRANSPORT: Load failure due to transport error
+ * @WEBKIT_NETWORK_ERROR_UNKNOWN_PROTOCOL: Load failure due to unknown protocol
+ * @WEBKIT_NETWORK_ERROR_CANCELLED: Load failure due to cancellation
+ * @WEBKIT_NETWORK_ERROR_FILE_DOES_NOT_EXIST: Load failure due to missing file
+ *
+ * Enum values used to denote the various network errors.
+ **/
typedef enum {
WEBKIT_NETWORK_ERROR_FAILED = 399,
WEBKIT_NETWORK_ERROR_TRANSPORT = 300,
@@ -38,7 +50,16 @@
WEBKIT_NETWORK_ERROR_FILE_DOES_NOT_EXIST = 303,
} WebKitNetworkError;
-/* Sync'd with Mac's WebKit Errors */
+/**
+ * WebKitPolicyError:
+ * @WEBKIT_POLICY_ERROR_FAILED: Generic load failure due to policy error
+ * @WEBKIT_POLICY_ERROR_CANNOT_SHOW_MIME_TYPE: Load failure due to unsupported mime type
+ * @WEBKIT_POLICY_ERROR_CANNOT_SHOW_URL: Load failure due to URI that can not be shown
+ * @WEBKIT_POLICY_ERROR_FRAME_LOAD_INTERRUPTED_BY_POLICY_CHANGE: Load failure due to frame load interruption by policy change
+ * @WEBKIT_POLICY_ERROR_CANNOT_USE_RESTRICTED_PORT: Load failure due to port restriction
+ *
+ * Enum values used to denote the various policy errors.
+ **/
typedef enum {
WEBKIT_POLICY_ERROR_FAILED = 199,
WEBKIT_POLICY_ERROR_CANNOT_SHOW_MIME_TYPE = 100,
@@ -47,6 +68,17 @@
WEBKIT_POLICY_ERROR_CANNOT_USE_RESTRICTED_PORT = 103,
} WebKitPolicyError;
+/**
+ * WebKitPluginError:
+ * @WEBKIT_PLUGIN_ERROR_FAILED: Generic plugin load failure
+ * @WEBKIT_PLUGIN_ERROR_CANNOT_FIND_PLUGIN: Load failure due to missing plugin
+ * @WEBKIT_PLUGIN_ERROR_CANNOT_LOAD_PLUGIN: Load failure due to inability to load plugin
+ * @WEBKIT_PLUGIN_ERROR_JAVA_UNAVAILABLE: Load failue due to missing Java support that is required to load plugin
+ * @WEBKIT_PLUGIN_ERROR_CONNECTION_CANCELLED: Load failure due to connection cancellation
+ * @WEBKIT_PLUGIN_ERROR_WILL_HANDLE_LOAD: Load failure since plugin handles the load
+ *
+ * Enum values used to denote the various plugin errors.
+ **/
typedef enum {
WEBKIT_PLUGIN_ERROR_FAILED = 299,
WEBKIT_PLUGIN_ERROR_CANNOT_FIND_PLUGIN = 200,
Modified: trunk/Source/WebKit/gtk/webkit/webkitwebview.h (100641 => 100642)
--- trunk/Source/WebKit/gtk/webkit/webkitwebview.h 2011-11-17 18:07:29 UTC (rev 100641)
+++ trunk/Source/WebKit/gtk/webkit/webkitwebview.h 2011-11-17 18:24:44 UTC (rev 100642)
@@ -44,12 +44,31 @@
typedef struct _WebKitWebViewPrivate WebKitWebViewPrivate;
+/**
+ * WebKitNavigationResponse:
+ * @WEBKIT_NAVIGATION_RESPONSE_ACCEPT: Instruct WebKit to allow the navigation.
+ * @WEBKIT_NAVIGATION_RESPONSE_IGNORE: Instruct WebKit to ignore the navigation.
+ * @WEBKIT_NAVIGATION_RESPONSE_DOWNLOAD: Instruct WebKit to start a download of the destination instead.
+ *
+ * Enum values used to denote the various responses to a navigation policy decision.
+ **/
typedef enum {
WEBKIT_NAVIGATION_RESPONSE_ACCEPT,
WEBKIT_NAVIGATION_RESPONSE_IGNORE,
WEBKIT_NAVIGATION_RESPONSE_DOWNLOAD
} WebKitNavigationResponse;
+/**
+ * WebKitWebViewTargetInfo:
+ * @WEBKIT_WEB_VIEW_TARGET_INFO_HTML: Rich markup data
+ * @WEBKIT_WEB_VIEW_TARGET_INFO_TEXT: Text data
+ * @WEBKIT_WEB_VIEW_TARGET_INFO_IMAGE: Image data
+ * @WEBKIT_WEB_VIEW_TARGET_INFO_URI_LIST: URI list data
+ * @WEBKIT_WEB_VIEW_TARGET_INFO_NETSCAPE_URL: A single URL in the Netscape protocol
+ *
+ * Enum values used to denote the info value of various selection types. These can be used
+ * to interpret the data WebKitGTK+ publishes via GtkClipboard and drag-and-drop.
+ **/
typedef enum
{
WEBKIT_WEB_VIEW_TARGET_INFO_HTML,
@@ -59,6 +78,17 @@
WEBKIT_WEB_VIEW_TARGET_INFO_NETSCAPE_URL
} WebKitWebViewTargetInfo;
+/**
+ * WebKitWebViewViewMode:
+ * @WEBKIT_WEB_VIEW_VIEW_MODE_WINDOWED: Windowed view mode
+ * @WEBKIT_WEB_VIEW_VIEW_MODE_FLOATING: Floating view mode
+ * @WEBKIT_WEB_VIEW_VIEW_MODE_FULLSCREEN: Fullscreen view mode
+ * @WEBKIT_WEB_VIEW_VIEW_MODE_MAXIMIZED: Maximized view mode
+ * @WEBKIT_WEB_VIEW_VIEW_MODE_MINIMIZED: Minimized view mode
+ *
+ * Enum values used to denote the various types of view modes. See the
+ * #WebKitWebView:view-mode property.
+ **/
typedef enum
{
WEBKIT_WEB_VIEW_VIEW_MODE_WINDOWED,
_______________________________________________
webkit-changes mailing list
webkit-changes@lists.webkit.org
http://lists.webkit.org/mailman/listinfo.cgi/webkit-changes