aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--embed/ephy-embed-container.c5
-rw-r--r--embed/ephy-embed-persist.c6
-rw-r--r--embed/ephy-embed-shell.c45
-rw-r--r--embed/ephy-embed.c2
-rw-r--r--embed/ephy-history.c20
-rw-r--r--embed/ephy-web-view.c6
-rw-r--r--lib/ephy-dialog.c10
-rw-r--r--lib/ephy-node-db.c2
-rw-r--r--lib/ephy-node.c30
-rw-r--r--src/bookmarks/ephy-bookmarks.c35
-rw-r--r--src/ephy-extensions-manager.c3
-rw-r--r--src/ephy-notebook.c5
-rw-r--r--src/ephy-session.c6
-rw-r--r--src/ephy-shell.c44
-rw-r--r--src/ephy-statusbar.c2
-rw-r--r--src/ephy-toolbar.c5
-rw-r--r--src/ephy-window.c12
17 files changed, 212 insertions, 26 deletions
diff --git a/embed/ephy-embed-container.c b/embed/ephy-embed-container.c
index 1a55eb66a..50d1c143c 100644
--- a/embed/ephy-embed-container.c
+++ b/embed/ephy-embed-container.c
@@ -150,7 +150,7 @@ ephy_embed_container_remove_child (EphyEmbedContainer *container,
*
* Returns @container's active #EphyEmbed.
*
- * Return value: @container's active child
+ * Return value: (transfer none): @container's active child
**/
EphyEmbed *
ephy_embed_container_get_active_child (EphyEmbedContainer *container)
@@ -169,7 +169,8 @@ ephy_embed_container_get_active_child (EphyEmbedContainer *container)
*
* Returns the list of #EphyEmbed:s in the container.
*
- * Return value: a newly-allocated list of #EphyEmbed:s
+ * Return value: (element-type EphyEmbed) (transfer container):
+ * a newly-allocated list of #EphyEmbed:s
*/
GList *
ephy_embed_container_get_children (EphyEmbedContainer *container)
diff --git a/embed/ephy-embed-persist.c b/embed/ephy-embed-persist.c
index e78314970..2c82c0381 100644
--- a/embed/ephy-embed-persist.c
+++ b/embed/ephy-embed-persist.c
@@ -256,7 +256,8 @@ ephy_embed_persist_get_dest (EphyEmbedPersist *persist)
*
* Returns the #EphyEmbed from which @persist will download.
*
- * Return value: the #EphyEmbed from which @persist will download
+ * Return value: (transfer none): the #EphyEmbed from which @persist
+ * will download
**/
EphyEmbed *
ephy_embed_persist_get_embed (EphyEmbedPersist *persist)
@@ -289,7 +290,8 @@ ephy_embed_persist_get_fc_title (EphyEmbedPersist *persist)
* Returns the #EphyWindow which should serve as a parent for @persist's
* filechooser.
*
- * Return value: the #EphyWindow parent for @persist's filechooser
+ * Return value: (transfer none): the #EphyWindow parent for @persist's
+ * filechooser
**/
GtkWindow *
ephy_embed_persist_get_fc_parent (EphyEmbedPersist *persist)
diff --git a/embed/ephy-embed-shell.c b/embed/ephy-embed-shell.c
index e68618ec8..d8650a50b 100644
--- a/embed/ephy-embed-shell.c
+++ b/embed/ephy-embed-shell.c
@@ -156,7 +156,7 @@ ephy_embed_shell_finalize (GObject *object)
*
* Returns the favicons cache.
*
- * Return value: the favicons cache
+ * Return value: (transfer none): the favicons cache
**/
GObject *
ephy_embed_shell_get_favicon_cache (EphyEmbedShell *shell)
@@ -171,6 +171,11 @@ ephy_embed_shell_get_favicon_cache (EphyEmbedShell *shell)
return G_OBJECT (shell->priv->favicon_cache);
}
+/**
+ * ephy_embed_shell_get_global_history:
+ *
+ * Return value: (transfer none):
+ **/
GObject *
ephy_embed_shell_get_global_history (EphyEmbedShell *shell)
{
@@ -184,6 +189,11 @@ ephy_embed_shell_get_global_history (EphyEmbedShell *shell)
return G_OBJECT (shell->priv->global_history);
}
+/**
+ * ephy_embed_shell_get_downloader_view:
+ *
+ * Return value: (transfer none):
+ **/
GObject *
ephy_embed_shell_get_downloader_view (EphyEmbedShell *shell)
{
@@ -202,6 +212,11 @@ ephy_embed_shell_get_downloader_view (EphyEmbedShell *shell)
return G_OBJECT (shell->priv->downloader_view);
}
+/**
+ * ephy_embed_shell_get_downloader_view_nocreate:
+ *
+ * Return value: (transfer none):
+ **/
GObject *
ephy_embed_shell_get_downloader_view_nocreate (EphyEmbedShell *shell)
{
@@ -254,6 +269,11 @@ impl_get_embed_single (EphyEmbedShell *shell)
return G_OBJECT (shell->priv->embed_single);
}
+/**
+ * ephy_embed_shell_get_embed_single:
+ *
+ * Return value: (transfer none):
+ **/
GObject *
ephy_embed_shell_get_embed_single (EphyEmbedShell *shell)
{
@@ -262,6 +282,11 @@ ephy_embed_shell_get_embed_single (EphyEmbedShell *shell)
return klass->get_embed_single (shell);
}
+/**
+ * ephy_embed_shell_get_encodings:
+ *
+ * Return value: (transfer none):
+ **/
GObject *
ephy_embed_shell_get_encodings (EphyEmbedShell *shell)
{
@@ -345,7 +370,7 @@ ephy_embed_shell_class_init (EphyEmbedShellClass *klass)
*
* Retrieves the default #EphyEmbedShell object
*
- * Return value: the default #EphyEmbedShell
+ * Return value: (transfer none): the default #EphyEmbedShell
**/
EphyEmbedShell *
ephy_embed_shell_get_default (void)
@@ -359,7 +384,7 @@ ephy_embed_shell_get_default (void)
*
* Returns the adblock manager.
*
- * Return value: the adblock manager
+ * Return value: (transfer none): the adblock manager
**/
GObject *
ephy_embed_shell_get_adblock_manager (EphyEmbedShell *shell)
@@ -404,7 +429,12 @@ ephy_embed_shell_set_page_setup (EphyEmbedShell *shell,
gtk_page_setup_to_file (page_setup, path, NULL);
g_free (path);
}
-
+
+/**
+ * ephy_embed_shell_get_page_setup:
+ *
+ * Return value: (transfer none):
+ **/
GtkPageSetup *
ephy_embed_shell_get_page_setup (EphyEmbedShell *shell)
{
@@ -481,7 +511,12 @@ ephy_embed_shell_set_print_settings (EphyEmbedShell *shell,
gtk_print_settings_to_file (settings, path, NULL);
g_free (path);
}
-
+
+/**
+ * ephy_embed_shell_get_print_gettings:
+ *
+ * Return value: (transfer none):
+ **/
GtkPrintSettings *
ephy_embed_shell_get_print_settings (EphyEmbedShell *shell)
{
diff --git a/embed/ephy-embed.c b/embed/ephy-embed.c
index 39543ee9b..ebb5e64e4 100644
--- a/embed/ephy-embed.c
+++ b/embed/ephy-embed.c
@@ -882,7 +882,7 @@ ephy_embed_init (EphyEmbed *embed)
*
* Returns the #EphyWebView wrapped by @embed.
*
- * Returns: an #EphyWebView
+ * Returns: (transfer none): an #EphyWebView
**/
EphyWebView*
ephy_embed_get_web_view (EphyEmbed *embed)
diff --git a/embed/ephy-history.c b/embed/ephy-history.c
index 127420a48..ae0e563dc 100644
--- a/embed/ephy-history.c
+++ b/embed/ephy-history.c
@@ -740,6 +740,11 @@ internal_get_host (EphyHistory *eh, const char *url, gboolean create)
return host;
}
+/**
+ * ephy_history_get_host:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_history_get_host (EphyHistory *eh, const char *url)
{
@@ -875,6 +880,11 @@ impl_add_page (EphyHistory *eb,
return TRUE;
}
+/**
+ * ephy_history_get_page:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_history_get_page (EphyHistory *eb,
const char *url)
@@ -975,12 +985,22 @@ ephy_history_clear (EphyHistory *gh)
g_signal_emit (gh, signals[CLEARED], 0);
}
+/**
+ * ephy_history_get_hosts:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_history_get_hosts (EphyHistory *eb)
{
return eb->priv->hosts;
}
+/**
+ * ephy_history_get_pages:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_history_get_pages (EphyHistory *eb)
{
diff --git a/embed/ephy-web-view.c b/embed/ephy-web-view.c
index 4fbfa9859..72c511221 100644
--- a/embed/ephy-web-view.c
+++ b/embed/ephy-web-view.c
@@ -1739,7 +1739,7 @@ ephy_web_view_get_icon_address (EphyWebView *view)
* Returns the view's site icon as a #GdkPixbuf,
* or %NULL if it is not available.
*
- * Return value: a the view's site icon
+ * Return value: (transfer none): a the view's site icon
**/
GdkPixbuf *
ephy_web_view_get_icon (EphyWebView *view)
@@ -2008,8 +2008,8 @@ ephy_web_view_get_js_status (EphyWebView *view)
/**
* ephy_web_view_get_security_level:
* @view: an #EphyWebView
- * @level: return value of security level
- * @description: return value of the description of the security level
+ * @level: (out): return value of security level
+ * @description: (out): return value of the description of the security level
*
* Fetches the #EphyWebViewSecurityLevel and a string description of the
* security state of @view. The description will be a newly-allocated
diff --git a/lib/ephy-dialog.c b/lib/ephy-dialog.c
index 3d2226d70..f2a577358 100644
--- a/lib/ephy-dialog.c
+++ b/lib/ephy-dialog.c
@@ -1263,6 +1263,11 @@ ephy_dialog_run (EphyDialog *dialog)
return gtk_dialog_run (GTK_DIALOG (dialog->priv->dialog));
}
+/**
+ * ephy_dialog_get_control:
+ *
+ * Return value: (transfer none):
+ **/
GtkWidget *
ephy_dialog_get_control (EphyDialog *dialog,
const char *property_id)
@@ -1379,6 +1384,11 @@ ephy_dialog_finalize (GObject *object)
G_OBJECT_CLASS (parent_class)->finalize (object);
}
+/**
+ * ephy_dialog_get_parent:
+ *
+ * Return value: (transfer none):
+ **/
GtkWidget *
ephy_dialog_get_parent (EphyDialog *dialog)
{
diff --git a/lib/ephy-node-db.c b/lib/ephy-node-db.c
index 4e421f20e..2a9563198 100644
--- a/lib/ephy-node-db.c
+++ b/lib/ephy-node-db.c
@@ -197,7 +197,7 @@ ephy_node_db_set_immutable (EphyNodeDb *db, gboolean immutable)
*
* Returns the #EphyNode with id @id from @db, or %NULL if no such id exists.
*
- * Return value: an #EphyNode
+ * Return value: (transfer none): an #EphyNode
**/
EphyNode *
ephy_node_db_get_node_from_id (EphyNodeDb *db, guint id)
diff --git a/lib/ephy-node.c b/lib/ephy-node.c
index 9dcbfa16e..2fec271d2 100644
--- a/lib/ephy-node.c
+++ b/lib/ephy-node.c
@@ -380,6 +380,11 @@ ephy_node_new_with_id (EphyNodeDb *db, guint reserved_id)
return node;
}
+/**
+ * ephy_node_get_db:
+ *
+ * Return value: (transfer none):
+ **/
EphyNodeDb *
ephy_node_get_db (EphyNode *node)
{
@@ -758,6 +763,11 @@ ephy_node_get_property_float (EphyNode *node,
return retval;
}
+/**
+ * ephy_node_get_property_node:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_node_get_property_node (EphyNode *node,
guint property_id)
@@ -1208,6 +1218,11 @@ ephy_node_reorder_children (EphyNode *node,
ephy_node_emit_signal (node, EPHY_NODE_CHILDREN_REORDERED, new_order);
}
+/**
+ * ephy_node_get_children:
+ *
+ * Return value: (array) (element-type EphyNode) (transfer none):
+ **/
GPtrArray *
ephy_node_get_children (EphyNode *node)
{
@@ -1228,6 +1243,11 @@ ephy_node_get_n_children (EphyNode *node)
return ret;
}
+/**
+ * ephy_node_get_nth_child:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_node_get_nth_child (EphyNode *node,
guint n)
@@ -1276,6 +1296,11 @@ ephy_node_get_child_index (EphyNode *node,
return ret;
}
+/**
+ * ephy_node_get_next_child:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_node_get_next_child (EphyNode *node,
EphyNode *child)
@@ -1297,6 +1322,11 @@ ephy_node_get_next_child (EphyNode *node,
return ret;
}
+/**
+ * ephy_node_get_previous_child:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_node_get_previous_child (EphyNode *node,
EphyNode *child)
diff --git a/src/bookmarks/ephy-bookmarks.c b/src/bookmarks/ephy-bookmarks.c
index 3b7147a74..507426978 100644
--- a/src/bookmarks/ephy-bookmarks.c
+++ b/src/bookmarks/ephy-bookmarks.c
@@ -1937,30 +1937,55 @@ ephy_bookmarks_unset_keyword (EphyBookmarks *eb,
g_signal_emit (G_OBJECT (eb), ephy_bookmarks_signals[TREE_CHANGED], 0);
}
+/**
+ * ephy_bookmarks_get_smart_bookmarks:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_bookmarks_get_smart_bookmarks (EphyBookmarks *eb)
{
return eb->priv->smartbookmarks;
}
+/**
+ * ephy_bookmarks_get_keywords:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_bookmarks_get_keywords (EphyBookmarks *eb)
{
return eb->priv->keywords;
}
+/**
+ * ephy_bookmarks_get_bookmarks:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_bookmarks_get_bookmarks (EphyBookmarks *eb)
{
return eb->priv->bookmarks;
}
+/**
+ * ephy_bookmarks_get_favorites:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_bookmarks_get_favorites (EphyBookmarks *eb)
{
return eb->priv->favorites;
}
+/**
+ * ephy_bookmarks_get_local:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_bookmarks_get_local (EphyBookmarks *eb)
{
@@ -1971,12 +1996,22 @@ ephy_bookmarks_get_local (EphyBookmarks *eb)
#endif
}
+/**
+ * ephy_bookmarks_get_not_categorized:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_bookmarks_get_not_categorized (EphyBookmarks *eb)
{
return eb->priv->notcategorized;
}
+/**
+ * ephy_bookmarks_get_from_id:
+ *
+ * Return value: (transfer none):
+ **/
EphyNode *
ephy_bookmarks_get_from_id (EphyBookmarks *eb, long id)
{
diff --git a/src/ephy-extensions-manager.c b/src/ephy-extensions-manager.c
index 979e6d632..cb0157117 100644
--- a/src/ephy-extensions-manager.c
+++ b/src/ephy-extensions-manager.c
@@ -230,7 +230,8 @@ ephy_extensions_manager_register (EphyExtensionsManager *manager,
*
* Returns the list of known extensions.
*
- * Returns: a list of #EphyExtensionInfo
+ * Returns: (element-type EphyEmbed) (transfer container): a list of
+ * #EphyExtensionInfo
**/
GList *
ephy_extensions_manager_get_extensions (EphyExtensionsManager *manager)
diff --git a/src/ephy-notebook.c b/src/ephy-notebook.c
index 253e3a0d9..0ea261d11 100644
--- a/src/ephy-notebook.c
+++ b/src/ephy-notebook.c
@@ -679,6 +679,11 @@ ephy_notebook_set_show_tabs (EphyNotebook *nb,
update_tabs_visibility (nb, FALSE);
}
+/**
+ * ephy_notebook_get_focused_pages:
+ *
+ * Return value: (transfer none):
+ **/
GList *
ephy_notebook_get_focused_pages (EphyNotebook *nb)
{
diff --git a/src/ephy-session.c b/src/ephy-session.c
index e77d12b73..3919c6c1f 100644
--- a/src/ephy-session.c
+++ b/src/ephy-session.c
@@ -1601,7 +1601,8 @@ ephy_session_load (EphySession *session,
* ephy_session_get_windows:
* @session: the #EphySession
*
- * Returns: the list of open #EphyWindow:s.
+ * Returns: (element-type EphyWindow) (transfer container): the list of
+ * open #EphyWindow:s.
**/
GList *
ephy_session_get_windows (EphySession *session)
@@ -1659,7 +1660,8 @@ ephy_session_remove_window (EphySession *session,
* need to take an action (like opening an url) on
* a window but you dont have a target window.
*
- * Return value: the current active non-popup browser window, or NULL of there is none.
+ * Return value: (transfer none): the current active non-popup browser
+ * window, or NULL of there is none.
**/
EphyWindow *
ephy_session_get_active_window (EphySession *session)
diff --git a/src/ephy-shell.c b/src/ephy-shell.c
index b3964cb5e..3a42fd239 100644
--- a/src/ephy-shell.c
+++ b/src/ephy-shell.c
@@ -359,7 +359,7 @@ ephy_shell_finalize (GObject *object)
*
* Retrieve the default #EphyShell object
*
- * Return value: the default #EphyShell
+ * Return value: (transfer none): the default #EphyShell
**/
EphyShell *
ephy_shell_get_default (void)
@@ -589,7 +589,7 @@ ephy_shell_new_tab (EphyShell *shell,
*
* Returns current session.
*
- * Return value: the current session.
+ * Return value: (transfer none): the current session.
**/
GObject *
ephy_shell_get_session (EphyShell *shell)
@@ -639,6 +639,11 @@ ephy_shell_get_lockdown (EphyShell *shell)
return G_OBJECT (shell->priv->session);
}
+/**
+ * ephy_shell_get_bookmarks:
+ *
+ * Return value: (transfer none):
+ **/
EphyBookmarks *
ephy_shell_get_bookmarks (EphyShell *shell)
{
@@ -650,6 +655,11 @@ ephy_shell_get_bookmarks (EphyShell *shell)
return shell->priv->bookmarks;
}
+/**
+ * ephy_shell_get_toolbars_model:
+ *
+ * Return value: (transfer none):
+ **/
GObject *
ephy_shell_get_toolbars_model (EphyShell *shell, gboolean fullscreen)
{
@@ -696,6 +706,11 @@ ephy_shell_get_toolbars_model (EphyShell *shell, gboolean fullscreen)
}
}
+/**
+ * ephy_shell_get_extensions_manager:
+ *
+ * Return value: (transfer none):
+ **/
GObject *
ephy_shell_get_extensions_manager (EphyShell *es)
{
@@ -717,6 +732,11 @@ ephy_shell_get_extensions_manager (EphyShell *es)
return G_OBJECT (es->priv->extensions_manager);
}
+/**
+ * ephy_shell_get_net_monitor:
+ *
+ * Return value: (transfer none):
+ **/
GObject *
ephy_shell_get_net_monitor (EphyShell *shell)
{
@@ -760,6 +780,11 @@ toolwindow_hide_cb (GtkWidget *widget, EphyShell *es)
g_object_unref (ephy_shell);
}
+/**
+ * ephy_shell_get_bookmarks_editor:
+ *
+ * Return value: (transfer none):
+ **/
GtkWidget *
ephy_shell_get_bookmarks_editor (EphyShell *shell)
{
@@ -780,6 +805,11 @@ ephy_shell_get_bookmarks_editor (EphyShell *shell)
return shell->priv->bme;
}
+/**
+ * ephy_shell_get_history_window:
+ *
+ * Return value: (transfer none):
+ **/
GtkWidget *
ephy_shell_get_history_window (EphyShell *shell)
{
@@ -801,6 +831,11 @@ ephy_shell_get_history_window (EphyShell *shell)
return shell->priv->history_window;
}
+/**
+ * ephy_shell_get_pdm_dialog:
+ *
+ * Return value: (transfer none):
+ **/
GObject *
ephy_shell_get_pdm_dialog (EphyShell *shell)
{
@@ -819,6 +854,11 @@ ephy_shell_get_pdm_dialog (EphyShell *shell)
return shell->priv->pdm_dialog;
}
+/**
+ * ephy_shell_get_prefs_dialog:
+ *
+ * Return value: (transfer none):
+ **/
GObject *
ephy_shell_get_prefs_dialog (EphyShell *shell)
{
diff --git a/src/ephy-statusbar.c b/src/ephy-statusbar.c
index a30d57f39..c3c7abbab 100644
--- a/src/ephy-statusbar.c
+++ b/src/ephy-statusbar.c
@@ -342,7 +342,7 @@ ephy_statusbar_remove_widget (EphyStatusbar *statusbar,
* ephy_statusbar_get_security_frame:
* @statusbar: an #EphyStatusbar
*
- * Return value: the statusbar's lock icon frame
+ * Return value: (transfer none): the statusbar's lock icon frame
*/
GtkWidget *
ephy_statusbar_get_security_frame (EphyStatusbar *statusbar)
diff --git a/src/ephy-toolbar.c b/src/ephy-toolbar.c
index 7442bc225..3cd3eee16 100644
--- a/src/ephy-toolbar.c
+++ b/src/ephy-toolbar.c
@@ -358,6 +358,11 @@ ephy_toolbar_set_window (EphyToolbar *toolbar,
/* public functions */
+/**
+ * ephy_toolbar_get_action_group
+ *
+ * Return value: (transfer none):
+ **/
GtkActionGroup *
ephy_toolbar_get_action_group (EphyToolbar *toolbar)
{
diff --git a/src/ephy-window.c b/src/ephy-window.c
index a734e94f9..5991190f7 100644
--- a/src/ephy-window.c
+++ b/src/ephy-window.c
@@ -3884,7 +3884,7 @@ ephy_window_new_with_chrome (EphyWebViewChrome chrome,
*
* Returns this window's UI manager.
*
- * Return value: an #GtkUIManager
+ * Return value: (transfer none): an #GtkUIManager
**/
GObject *
ephy_window_get_ui_manager (EphyWindow *window)
@@ -3900,7 +3900,7 @@ ephy_window_get_ui_manager (EphyWindow *window)
*
* Returns this window's toolbar as an #EggEditableToolbar.
*
- * Return value: an #EggEditableToolbar
+ * Return value: (transfer none): an #EggEditableToolbar
**/
GtkWidget *
ephy_window_get_toolbar (EphyWindow *window)
@@ -3916,7 +3916,7 @@ ephy_window_get_toolbar (EphyWindow *window)
*
* Returns the #GtkNotebook used by this window.
*
- * Return value: the @window's #GtkNotebook
+ * Return value: (transfer none): the @window's #GtkNotebook
**/
GtkWidget *
ephy_window_get_notebook (EphyWindow *window)
@@ -3932,7 +3932,7 @@ ephy_window_get_notebook (EphyWindow *window)
*
* Returns the #EphyFindToolbar used by this window.
*
- * Return value: the @window's #EphyFindToolbar
+ * Return value: (transfer none): the @window's #EphyFindToolbar
**/
GtkWidget *
ephy_window_get_find_toolbar (EphyWindow *window)
@@ -3948,7 +3948,7 @@ ephy_window_get_find_toolbar (EphyWindow *window)
*
* Returns this window's statusbar as an #EphyStatusbar.
*
- * Return value: This window's statusbar
+ * Return value: (transfer none): This window's statusbar
**/
GtkWidget *
ephy_window_get_statusbar (EphyWindow *window)
@@ -4196,7 +4196,7 @@ ephy_window_get_is_print_preview (EphyWindow *window)
* Returns the #EphyEmbedEvent for the current context menu.
* Use this to get the event from the action callback.
*
- * Return value: an #EphyEmbedEvent, or %NULL
+ * Return value: (transfer none): an #EphyEmbedEvent, or %NULL
**/
EphyEmbedEvent *
ephy_window_get_context_event (EphyWindow *window)