aboutsummaryrefslogtreecommitdiffstats
path: root/doc/reference
diff options
context:
space:
mode:
authorXan Lopez <xan@gnome.org>2009-12-31 04:07:02 +0800
committerXan Lopez <xan@gnome.org>2009-12-31 04:23:09 +0800
commiteaa19fb5739761d835ccaad80f0266affcb971c4 (patch)
tree83261598c0103b285cff3e78bb43a2b4f7fa9e56 /doc/reference
parentfab4ce42cdef5d1046b0f17d77dbca9dc384962d (diff)
downloadgsoc2013-epiphany-eaa19fb5739761d835ccaad80f0266affcb971c4.tar
gsoc2013-epiphany-eaa19fb5739761d835ccaad80f0266affcb971c4.tar.gz
gsoc2013-epiphany-eaa19fb5739761d835ccaad80f0266affcb971c4.tar.bz2
gsoc2013-epiphany-eaa19fb5739761d835ccaad80f0266affcb971c4.tar.lz
gsoc2013-epiphany-eaa19fb5739761d835ccaad80f0266affcb971c4.tar.xz
gsoc2013-epiphany-eaa19fb5739761d835ccaad80f0266affcb971c4.tar.zst
gsoc2013-epiphany-eaa19fb5739761d835ccaad80f0266affcb971c4.zip
Revert "docs: remove generated templates"
This reverts commit 3deb6e06fd3cccaf26bca8c81bf1f83ef7993dd6. This broke distcheck.
Diffstat (limited to 'doc/reference')
-rw-r--r--doc/reference/Makefile.am162
-rw-r--r--doc/reference/tmpl/EphyContentPolicy.sgml19
-rw-r--r--doc/reference/tmpl/EphySingle.sgml64
-rw-r--r--doc/reference/tmpl/ephy-embed-factory.sgml34
-rw-r--r--doc/reference/tmpl/ephy-embed-persist.sgml235
-rw-r--r--doc/reference/tmpl/ephy-embed-single.sgml69
-rw-r--r--doc/reference/tmpl/ephy-embed.sgml399
-rw-r--r--doc/reference/tmpl/ephy-extensions-manager.sgml37
-rw-r--r--doc/reference/tmpl/ephy-glade.sgml25
-rw-r--r--doc/reference/tmpl/ephy-icon-entry.sgml53
-rw-r--r--doc/reference/tmpl/ephy-location-entry.sgml217
-rw-r--r--doc/reference/tmpl/ephy-node-db.sgml123
-rw-r--r--doc/reference/tmpl/ephy-password-manager.sgml78
-rw-r--r--doc/reference/tmpl/ephy-permission-manager.sgml78
-rw-r--r--doc/reference/tmpl/ephy-search-entry.sgml49
-rw-r--r--doc/reference/tmpl/ephy-session.sgml84
-rw-r--r--doc/reference/tmpl/ephy-shell.sgml129
-rw-r--r--doc/reference/tmpl/ephy-spinner.sgml58
-rw-r--r--doc/reference/tmpl/ephy-tab.sgml202
-rw-r--r--doc/reference/tmpl/ephy-window.sgml110
-rw-r--r--doc/reference/tmpl/ephy-zoom-control.sgml56
-rw-r--r--doc/reference/tmpl/epiphany-unused.sgml1043
-rw-r--r--doc/reference/tmpl/mozilla-embed-event.sgml35
23 files changed, 3346 insertions, 13 deletions
diff --git a/doc/reference/Makefile.am b/doc/reference/Makefile.am
index d8c000c2c..ed9ae2aa5 100644
--- a/doc/reference/Makefile.am
+++ b/doc/reference/Makefile.am
@@ -9,21 +9,13 @@ DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
# documenting functions and macros.
DOC_SOURCE_DIR=../..
-# Extra options to pass to gtkdoc-scangobj. Not normally needed.
-SCANGOBJ_OPTIONS="--type-init-func=g_thread_init(NULL);g_type_init()"
-
# Extra options to supply to gtkdoc-scan.
SCAN_OPTIONS=
# Extra options to supply to gtkdoc-mkdb.
-MKDB_OPTIONS=--sgml-mode --output-format=xml --source-suffixes=h,c
-
-# Extra options to supply to gtkdoc-mktmpl
-# e.g. MKTMPL_OPTIONS=--only-section-tmpl
-MKTMPL_OPTIONS=
+MKDB_OPTIONS=--sgml-mode --output-format=xml
-# Extra options to supply to gtkdoc-fixref. Not normally needed.
-# e.g. FIXXREF_OPTIONS=--extra-dir=../gdk-pixbuf/html --extra-dir=../gdk/html
+# Extra options to supply to gtkdoc-fixref.
FIXXREF_OPTIONS=
# Used for dependencies.
@@ -134,7 +126,7 @@ GTKDOC_LIBS = \
$(top_builddir)/lib/widgets/libephywidgets.la \
$(top_builddir)/lib/libephymisc.la \
$(top_builddir)/lib/egg/libegg.la \
- $(DEPENDENCIES_LIBS) \
+ $(DEPENDENCIES_LIBS) \
$(DBUS_LIBS) \
$(LIBINTL)
@@ -152,5 +144,149 @@ endif
# $(DOC_MODULE)-overrides.txt file and uncomment the second line here.
DOC_OVERRIDES =
-# This includes the standard gtk-doc make rules, copied by gtkdocize.
-include $(top_srcdir)/gtk-doc.make
+# include common portion ...
+# include $(top_srcdir)/gtk-doc.make
+# We need to copy/paste this to be able to change LD_LIBRARY_PATH
+
+if GTK_DOC_USE_LIBTOOL
+GTKDOC_CC = $(LIBTOOL) --mode=compile $(CC) $(INCLUDES) $(AM_CFLAGS) $(CFLAGS)
+GTKDOC_LD = $(LIBTOOL) --mode=link $(CC) $(AM_CFLAGS) $(CFLAGS) $(LDFLAGS)
+else
+GTKDOC_CC = $(CC) $(INCLUDES) $(AM_CFLAGS) $(CFLAGS)
+GTKDOC_LD = $(CC) $(AM_CFLAGS) $(CFLAGS) $(LDFLAGS)
+endif
+
+# We set GPATH here; this gives us semantics for GNU make
+# which are more like other make's VPATH, when it comes to
+# whether a source that is a target of one rule is then
+# searched for in VPATH/GPATH.
+#
+GPATH = $(srcdir)
+
+TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)
+
+EXTRA_DIST = \
+ $(content_files) \
+ $(HTML_IMAGES) \
+ $(DOC_MAIN_SGML_FILE) \
+ $(DOC_MODULE).types \
+ $(DOC_MODULE)-sections.txt \
+ $(DOC_MODULE)-overrides.txt
+
+DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \
+ $(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp
+
+SCANOBJ_FILES = \
+ $(DOC_MODULE).args \
+ $(DOC_MODULE).hierarchy \
+ $(DOC_MODULE).interfaces \
+ $(DOC_MODULE).prerequisites \
+ $(DOC_MODULE).signals
+
+CLEANFILES = $(SCANOBJ_FILES) $(DOC_MODULE)-scan.o $(DOC_MODULE)-unused.txt $(DOC_STAMPS)
+
+if ENABLE_GTK_DOC
+all-local: html-build.stamp
+
+#### scan ####
+
+scan-build.stamp: $(HFILE_GLOB)
+ @echo '*** Scanning header files ***'
+ @-chmod -R u+w $(srcdir)
+ if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null ; then \
+ CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" gtkdoc-scangobj $(SCANGOBJ_OPTIONS) --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \
+ else \
+ cd $(srcdir) ; \
+ for i in $(SCANOBJ_FILES) ; do \
+ test -f $$i || touch $$i ; \
+ done \
+ fi
+ cd $(srcdir) && \
+ gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(SCAN_OPTIONS) $(EXTRA_HFILES)
+ touch scan-build.stamp
+
+$(DOC_MODULE)-decl.txt $(SCANOBJ_FILES): scan-build.stamp
+ @true
+
+#### templates ####
+
+tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt $(DOC_MODULE)-overrides.txt
+ @echo '*** Rebuilding template files ***'
+ @-chmod -R u+w $(srcdir)
+ cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE)
+ touch tmpl-build.stamp
+
+tmpl.stamp: tmpl-build.stamp
+ @true
+
+#### xml ####
+
+sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) $(srcdir)/tmpl/*.sgml
+ @echo '*** Building XML ***'
+ @-chmod -R u+w $(srcdir)
+ cd $(srcdir) && \
+ gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --output-format=xml $(MKDB_OPTIONS)
+ touch sgml-build.stamp
+
+sgml.stamp: sgml-build.stamp
+ @true
+
+#### html ####
+
+html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files)
+ @echo '*** Building HTML ***'
+ @-chmod -R u+w $(srcdir)
+ rm -rf $(srcdir)/html
+ mkdir $(srcdir)/html
+ cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
+ test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html )
+ @echo '-- Fixing Crossreferences'
+ cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS)
+ touch html-build.stamp
+endif
+
+##############
+
+clean-local:
+ rm -f *~ *.bak
+
+maintainer-clean-local: clean
+ cd $(srcdir) && rm -rf xml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
+
+install-data-local:
+ $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)
+ (installfiles=`echo $(srcdir)/html/*`; \
+ if test "$$installfiles" = '$(srcdir)/html/*'; \
+ then echo '-- Nothing to install' ; \
+ else \
+ for i in $$installfiles; do \
+ echo '-- Installing '$$i ; \
+ $(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \
+ done; \
+ echo '-- Installing $(srcdir)/html/index.sgml' ; \
+ $(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR) || :; \
+ fi)
+
+uninstall-local:
+ rm -f $(DESTDIR)$(TARGET_DIR)/*
+
+#
+# Require gtk-doc when making dist
+#
+if ENABLE_GTK_DOC
+dist-check-gtkdoc:
+else
+dist-check-gtkdoc:
+ @echo "*** gtk-doc must be installed and enabled in order to make dist"
+ @false
+endif
+
+dist-hook: dist-check-gtkdoc dist-hook-local
+ mkdir $(distdir)/tmpl
+ mkdir $(distdir)/xml
+ mkdir $(distdir)/html
+ -cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
+ -cp $(srcdir)/xml/*.xml $(distdir)/xml
+ -cp $(srcdir)/html/* $(distdir)/html
+
+.PHONY : dist-hook-local
diff --git a/doc/reference/tmpl/EphyContentPolicy.sgml b/doc/reference/tmpl/EphyContentPolicy.sgml
new file mode 100644
index 000000000..5cd2d4f61
--- /dev/null
+++ b/doc/reference/tmpl/EphyContentPolicy.sgml
@@ -0,0 +1,19 @@
+<!-- ##### SECTION Title ##### -->
+EphyContentPolicy
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
diff --git a/doc/reference/tmpl/EphySingle.sgml b/doc/reference/tmpl/EphySingle.sgml
new file mode 100644
index 000000000..5ecfb7239
--- /dev/null
+++ b/doc/reference/tmpl/EphySingle.sgml
@@ -0,0 +1,64 @@
+<!-- ##### SECTION Title ##### -->
+EphySingle
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION Init ##### -->
+<para>
+
+</para>
+
+@aOwner:
+@Returns:
+
+
+<!-- ##### FUNCTION Detach ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION EmitPermissionNotification ##### -->
+<para>
+
+</para>
+
+@name:
+@aSubject:
+@Returns:
+
+
+<!-- ##### FUNCTION mozilla_cookie_to_ephy_cookie ##### -->
+<para>
+
+</para>
+
+@cookie:
+@Returns:
+
+
+<!-- ##### FUNCTION mozilla_permission_to_ephy_permission ##### -->
+<para>
+
+</para>
+
+@perm:
+@Returns:
+
+
diff --git a/doc/reference/tmpl/ephy-embed-factory.sgml b/doc/reference/tmpl/ephy-embed-factory.sgml
new file mode 100644
index 000000000..eda17fe3a
--- /dev/null
+++ b/doc/reference/tmpl/ephy-embed-factory.sgml
@@ -0,0 +1,34 @@
+<!-- ##### SECTION Title ##### -->
+EphyEmbedFactory
+
+<!-- ##### SECTION Short_Description ##### -->
+Factory for creating new embed objects
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+#EphyEmbed, #EphyEmbedPersist and #EphyEmbedSingle are all interfaces. In the
+interest of abstraction, the only recommended way to create new instances of
+the objects which implement these interfaces is to use #EphyEmbedFactory.
+</para>
+<para>
+To create a new instance of an #EphyEmbed, #EphyEmbedPersist or
+#EphyEmbedSingle, use ephy_embed_factory_new_object().
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION ephy_embed_factory_new_object ##### -->
+<para>
+
+</para>
+
+@type:
+@Returns:
+
+
diff --git a/doc/reference/tmpl/ephy-embed-persist.sgml b/doc/reference/tmpl/ephy-embed-persist.sgml
new file mode 100644
index 000000000..32fa72e63
--- /dev/null
+++ b/doc/reference/tmpl/ephy-embed-persist.sgml
@@ -0,0 +1,235 @@
+<!-- ##### SECTION Title ##### -->
+EphyEmbedPersist
+
+<!-- ##### SECTION Short_Description ##### -->
+A class to download files
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+An #EphyEmbedPersist is a relatively simple way to save a web page or file to
+disk. It is an abstract class, implemented by #MozillaEmbedPersist.
+</para>
+<para>
+To create an #EphyEmbedPersist, use ephy_embed_factory_new_object(). Next, call
+ephy_embed_persist_set_flags() and ephy_embed_persist_set_embed(). Depending
+on the flags, you may also want to call ephy_embed_persist_set_dest() or
+ephy_embed_persist_set_source(). Finally, call ephy_embed_persist_save() to
+save the file.
+</para>
+<para>
+<example>
+<title>Saving the current web page to disk</title>
+<programlisting>#<![CDATA[include <epiphany/ephy-embed-persist.h>]]>
+#<![CDATA[include <epiphany/ephy-embed.h>
+
+static void
+save_source_completed_cb (EphyEmbedPersist *persist,
+ gpointer dummy)
+{
+ g_print ("Download to %]]><![CDATA[s complete.\n",
+ ephy_embed_persist_get_dest (persist));
+}
+
+void
+save_page (EphyEmbed *embed,
+ const char *filename)
+{
+ EphyEmbedPersist *persist;
+
+ persist = EPHY_EMBED_PERSIST
+ (ephy_embed_factory_new_object ("EphyEmbedPersist"));
+
+ ephy_embed_persist_set_embed (persist, embed);
+ ephy_embed_persist_set_flags (persist, EMBED_PERSIST_NO_VIEW |
+ EMBED_PERSIST_COPY_PAGE);
+ ephy_embed_persist_set_dest (persist, filename);
+
+ g_signal_connect (persist, "completed",
+ G_CALLBACK (save_source_completed_cb), NULL);
+
+ ephy_embed_persist_save (persist);
+
+ g_object_unref (persist);
+}]]>
+</programlisting>
+</example>
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION ephy_embed_persist_set_dest ##### -->
+<para>
+
+</para>
+
+@persist:
+@value:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_set_embed ##### -->
+<para>
+
+</para>
+
+@persist:
+@value:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_set_fc_title ##### -->
+<para>
+
+</para>
+
+@persist:
+@value:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_set_fc_parent ##### -->
+<para>
+
+</para>
+
+@persist:
+@value:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_set_flags ##### -->
+<para>
+
+</para>
+
+@persist:
+@value:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_set_max_size ##### -->
+<para>
+
+</para>
+
+@persist:
+@value:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_set_persist_key ##### -->
+<para>
+
+</para>
+
+@persist:
+@value:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_set_source ##### -->
+<para>
+
+</para>
+
+@persist:
+@value:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_get_dest ##### -->
+<para>
+
+</para>
+
+@persist:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_get_embed ##### -->
+<para>
+
+</para>
+
+@persist:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_get_fc_title ##### -->
+<para>
+
+</para>
+
+@persist:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_get_fc_parent ##### -->
+<para>
+
+</para>
+
+@persist:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_get_flags ##### -->
+<para>
+
+</para>
+
+@persist:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_get_max_size ##### -->
+<para>
+
+</para>
+
+@persist:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_get_persist_key ##### -->
+<para>
+
+</para>
+
+@persist:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_get_source ##### -->
+<para>
+
+</para>
+
+@persist:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_save ##### -->
+<para>
+
+</para>
+
+@persist:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_cancel ##### -->
+<para>
+
+</para>
+
+@persist:
+
+
+<!-- ##### FUNCTION ephy_embed_persist_to_string ##### -->
+<para>
+
+</para>
+
+@persist:
+@Returns:
+
+
diff --git a/doc/reference/tmpl/ephy-embed-single.sgml b/doc/reference/tmpl/ephy-embed-single.sgml
new file mode 100644
index 000000000..e49aa628b
--- /dev/null
+++ b/doc/reference/tmpl/ephy-embed-single.sgml
@@ -0,0 +1,69 @@
+<!-- ##### SECTION Title ##### -->
+EphyEmbedSingle
+
+<!-- ##### SECTION Short_Description ##### -->
+An interface to the global embedded browser
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+While Epiphany is running, its global embed_shell variable (an #EphyEmbedShell)
+holds a reference to an #EphyEmbedSingle. The only class which implements
+#EphyEmbedSingle is #MozillaEmbedSingle, so the two types are interchangeable
+via casting.
+</para>
+<para>
+<example>
+<title>Acquiring an <structname>EphyEmbedSingle</structname></title>
+<programlisting>#<![CDATA[include <ephy-embed-shell.h>]]>
+#<![CDATA[include <ephy-embed-single.h>
+
+EphyEmbedSingle *ephy_single;
+
+/* embed_shell is a global variable, initialized as Epiphany starts */
+ephy_single = ephy_embed_shell_get_embed_single (embed_shell);
+]]></programlisting>
+</example>
+</para>
+<para>
+Since there is only one #EphyEmbedShell, there is only one #EphyEmbedSingle. It
+is used to perform browser-related actions which do not refer to an individual
+#EphyEmbed.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION ephy_embed_single_clear_cache ##### -->
+<para>
+
+</para>
+
+@single:
+
+
+<!-- ##### FUNCTION ephy_embed_single_clear_auth_cache ##### -->
+<para>
+
+</para>
+
+@single:
+
+
+<!-- ##### FUNCTION ephy_embed_single_open_window ##### -->
+<para>
+
+</para>
+
+@single:
+@parent:
+@address:
+@name:
+@features:
+@Returns:
+
+
diff --git a/doc/reference/tmpl/ephy-embed.sgml b/doc/reference/tmpl/ephy-embed.sgml
new file mode 100644
index 000000000..bfa4157ee
--- /dev/null
+++ b/doc/reference/tmpl/ephy-embed.sgml
@@ -0,0 +1,399 @@
+<!-- ##### SECTION Title ##### -->
+EphyEmbed
+
+<!-- ##### SECTION Short_Description ##### -->
+An interface to the widget displaying web pages
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+Each #EphyTab contains an #EphyEmbed. An #EphyEmbed is an interface; right now
+it is only implemented by #MozillaEmbed, but whenever possible, #EphyEmbed's
+functions should be used instead of their #MozillaEmbed equivalents.
+</para>
+<para>
+#EphyEmbed's most important functions can be divided into sets:
+</para>
+<itemizedlist>
+<listitem>Functions which affect navigation</listitem>
+<listitem>Functions which return information about the displayed web
+page</listitem>
+<listitem>Functions which manipulate the session history</listitem>
+</itemizedlist>
+<para>The first two sets of functions are self-explanitory.</para>
+<para>The session history functions are used to traverse the embedded browser's
+history. Each #EphyEmbed remembers a history of the web pages it has visited.
+There can be a maximum limit, however; for #MozillaEmbed, this limit is
+determined by Mozilla's browser.sessionhistory.max_entries preference. Because
+of this limit, ephy_embed_shistory_n_items() will not necessarily return the
+number of web pages visited in the embed's lifetime; likewise,
+ephy_embed_shistory_go_nth() will not always return to the user's home page
+when called with a 0 argument.</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+Using #EphyEmbed instead of #MozillaEmbed is good practice. However, using a
+#MozillaEmbed or even a #GtkMozEmbed may be necessary in certain cases (this can
+be done by casting).
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT EphyEmbed ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL EphyEmbed::close-request ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL EphyEmbed::content-blocked ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EphyEmbed::dom-content-loaded ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EphyEmbed::ge-context-menu ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL EphyEmbed::ge-document-type ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EphyEmbed::ge-dom-mouse-click ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL EphyEmbed::ge-dom-mouse-down ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+@Returns:
+
+<!-- ##### SIGNAL EphyEmbed::ge-favicon ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EphyEmbed::ge-feed-link ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
+<!-- ##### SIGNAL EphyEmbed::ge-modal-alert ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL EphyEmbed::ge-modal-alert-closed ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+
+<!-- ##### SIGNAL EphyEmbed::ge-new-window ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EphyEmbed::ge-popup-blocked ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
+<!-- ##### SIGNAL EphyEmbed::ge-search-key-press ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@event:
+@Returns:
+
+<!-- ##### SIGNAL EphyEmbed::ge-search-link ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+@arg2:
+@arg3:
+
+<!-- ##### SIGNAL EphyEmbed::new-document-now ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@:
+@Param2:
+
+<!-- ##### STRUCT EphyEmbedIface ##### -->
+<para>
+
+</para>
+
+@base_iface:
+@context_menu:
+@favicon:
+@feed_link:
+@search_link:
+@dom_mouse_click:
+@dom_mouse_down:
+@dom_content_loaded:
+@popup_blocked:
+@content_blocked:
+@modal_alert:
+@modal_alert_closed:
+@document_type:
+@new_window:
+@search_key_press:
+@close_request:
+@new_document_now:
+@load_url:
+@load:
+@can_go_up:
+@get_go_up_list:
+@go_up:
+@get_title:
+@get_location:
+@get_link_message:
+@get_js_status:
+@get_security_level:
+@show_page_certificate:
+@set_print_preview_mode:
+@print_preview_n_pages:
+@print_preview_navigate:
+@has_modified_forms:
+@get_document_type:
+@get_load_percent:
+@get_load_status:
+@get_navigation_flags:
+@get_typed_address:
+@set_typed_address:
+@get_address:
+@get_status_message:
+@get_icon:
+@get_icon_address:
+@get_is_blank:
+@get_loading_title:
+@get_visibility:
+
+<!-- ##### ENUM EphyEmbedChrome ##### -->
+<para>
+Determines which aspects of the user interface should be displayed. Most of the
+time, an #EphyEmbed's chrome will simply be %EPHY_EMBED_CHROME_DEFAULT. However,
+windows opened with JavaScript often use a nonstandard chrome.
+</para>
+
+@EPHY_EMBED_CHROME_MENUBAR: %TRUE for the #EphyEmbed's containing #EphyWindow
+ to display its menubar.
+@EPHY_EMBED_CHROME_TOOLBAR: %TRUE for the #EphyEmbed's containing #EphyWindow
+ to display its toolbars.
+@EPHY_EMBED_CHROME_STATUSBAR: %TRUE for the #EphyEmbed's containing #EphyWindow
+ to display its statusbar.
+@EPHY_EMBED_CHROME_BOOKMARKSBAR:
+
+<!-- ##### FUNCTION ephy_embed_load_url ##### -->
+<para>
+
+</para>
+
+@embed:
+@url:
+
+
+<!-- ##### FUNCTION ephy_embed_get_title ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_get_location ##### -->
+<para>
+
+</para>
+
+@embed:
+@toplevel:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_get_link_message ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_get_js_status ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_can_go_up ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_get_go_up_list ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_go_up ##### -->
+<para>
+
+</para>
+
+@embed:
+
+
+<!-- ##### FUNCTION ephy_embed_get_security_level ##### -->
+<para>
+
+</para>
+
+@embed:
+@level:
+@description:
+
+
+<!-- ##### FUNCTION ephy_embed_print_preview_n_pages ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_embed_print_preview_navigate ##### -->
+<para>
+
+</para>
+
+@embed:
+@type:
+@page:
+
+
+<!-- ##### FUNCTION ephy_embed_has_modified_forms ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+
diff --git a/doc/reference/tmpl/ephy-extensions-manager.sgml b/doc/reference/tmpl/ephy-extensions-manager.sgml
new file mode 100644
index 000000000..e7d7c7bae
--- /dev/null
+++ b/doc/reference/tmpl/ephy-extensions-manager.sgml
@@ -0,0 +1,37 @@
+<!-- ##### SECTION Title ##### -->
+EphyExtensionsManager
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION ephy_extensions_manager_load ##### -->
+<para>
+
+</para>
+
+@manager:
+@identifier:
+
+
+<!-- ##### FUNCTION ephy_extensions_manager_unload ##### -->
+<para>
+
+</para>
+
+@manager:
+@identifier:
+
+
diff --git a/doc/reference/tmpl/ephy-glade.sgml b/doc/reference/tmpl/ephy-glade.sgml
new file mode 100644
index 000000000..96c99456f
--- /dev/null
+++ b/doc/reference/tmpl/ephy-glade.sgml
@@ -0,0 +1,25 @@
+<!-- ##### SECTION Title ##### -->
+EphyGlade
+
+<!-- ##### SECTION Short_Description ##### -->
+Load a glade XML definition
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+Epiphany has its own convenience wrapper around glade_xml_new() which will
+automatically connect all a widget's signals and return the #GtkWidget root
+object.
+</para>
+<para>
+After retrieving a #GladeXML object from ephy_glade_widget_new(), regular
+#GladeXML functions can be called on that object.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
diff --git a/doc/reference/tmpl/ephy-icon-entry.sgml b/doc/reference/tmpl/ephy-icon-entry.sgml
new file mode 100644
index 000000000..6ed857e9f
--- /dev/null
+++ b/doc/reference/tmpl/ephy-icon-entry.sgml
@@ -0,0 +1,53 @@
+<!-- ##### SECTION Title ##### -->
+EphyIconEntry
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT EphyIconEntry ##### -->
+<para>
+
+</para>
+
+@entry:
+
+<!-- ##### FUNCTION ephy_icon_entry_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_icon_entry_pack_widget ##### -->
+<para>
+
+</para>
+
+@entry:
+@widget:
+@start:
+
+
+<!-- ##### FUNCTION ephy_icon_entry_get_entry ##### -->
+<para>
+
+</para>
+
+@entry:
+@Returns:
+
+
diff --git a/doc/reference/tmpl/ephy-location-entry.sgml b/doc/reference/tmpl/ephy-location-entry.sgml
new file mode 100644
index 000000000..c9c7e42c6
--- /dev/null
+++ b/doc/reference/tmpl/ephy-location-entry.sgml
@@ -0,0 +1,217 @@
+<!-- ##### SECTION Title ##### -->
+EphyLocationEntry
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT EphyLocationEntry ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL EphyLocationEntry::get-location ##### -->
+<para>
+
+</para>
+
+@ephylocationentry: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL EphyLocationEntry::get-title ##### -->
+<para>
+
+</para>
+
+@ephylocationentry: the object which received the signal.
+@Returns:
+
+<!-- ##### SIGNAL EphyLocationEntry::lock-clicked ##### -->
+<para>
+
+</para>
+
+@ephylocationentry: the object which received the signal.
+
+<!-- ##### SIGNAL EphyLocationEntry::user-changed ##### -->
+<para>
+
+</para>
+
+@ephylocationentry: the object which received the signal.
+
+<!-- ##### ARG EphyLocationEntry:secure-bg-color ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyLocationEntry:secure-fg-color ##### -->
+<para>
+
+</para>
+
+<!-- ##### FUNCTION ephy_location_entry_set_location ##### -->
+<para>
+
+</para>
+
+@entry:
+@address:
+@typed_address:
+
+
+<!-- ##### FUNCTION ephy_location_entry_get_location ##### -->
+<para>
+
+</para>
+
+@entry:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_location_entry_get_can_undo ##### -->
+<para>
+
+</para>
+
+@entry:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_location_entry_get_can_redo ##### -->
+<para>
+
+</para>
+
+@entry:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_location_entry_get_entry ##### -->
+<para>
+
+</para>
+
+@entry:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_location_entry_get_regex ##### -->
+<para>
+
+</para>
+
+@entry:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_location_entry_activate ##### -->
+<para>
+
+</para>
+
+@entry:
+
+
+<!-- ##### FUNCTION ephy_location_entry_reset ##### -->
+<para>
+
+</para>
+
+@entry:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_location_entry_undo_reset ##### -->
+<para>
+
+</para>
+
+@entry:
+
+
+<!-- ##### FUNCTION ephy_location_entry_set_favicon ##### -->
+<para>
+
+</para>
+
+@entry:
+@pixbuf:
+
+
+<!-- ##### FUNCTION ephy_location_entry_set_secure ##### -->
+<para>
+
+</para>
+
+@entry:
+@secure:
+
+
+<!-- ##### FUNCTION ephy_location_entry_set_show_lock ##### -->
+<para>
+
+</para>
+
+@entry:
+@show_lock:
+
+
+<!-- ##### FUNCTION ephy_location_entry_set_lock_stock ##### -->
+<para>
+
+</para>
+
+@entry:
+@stock_id:
+
+
+<!-- ##### FUNCTION ephy_location_entry_set_lock_tooltip ##### -->
+<para>
+
+</para>
+
+@entry:
+@tooltip:
+
+
+<!-- ##### FUNCTION ephy_location_entry_set_completion ##### -->
+<para>
+
+</para>
+
+@entry:
+@model:
+@text_col:
+@action_col:
+@keywords_col:
+@relevance_col:
+@url_col:
+@extra_col:
+@favicon_col:
+
+
+<!-- ##### FUNCTION ephy_location_entry_set_match_func ##### -->
+<para>
+
+</para>
+
+@entry:
+@match_func:
+@user_data:
+@notify:
+
+
diff --git a/doc/reference/tmpl/ephy-node-db.sgml b/doc/reference/tmpl/ephy-node-db.sgml
new file mode 100644
index 000000000..49bc95913
--- /dev/null
+++ b/doc/reference/tmpl/ephy-node-db.sgml
@@ -0,0 +1,123 @@
+<!-- ##### SECTION Title ##### -->
+EphyNodeDb
+
+<!-- ##### SECTION Short_Description ##### -->
+Data tree
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+An #EphyNodeDb is a database for arbitrary data organized in a tree.
+</para>
+<para>
+Each database is stored along with its name in a global set of databases.
+Databases can be created using ephy_node_db_new() and retrieved using
+ephy_node_db_get_by_name().
+</para>
+<para>
+Each #EphyNode inside an #EphyNodeDb is identified by a unique node ID. By
+keeping a handle on the ID, one can use ephy_node_db_get_node_from_id() to
+retrieve its corresponding #EphyNode.
+</para>
+<para>
+#EphyNodeDb<!-- -->s can be saved to disk using ephy_node_db_write_to_xml_safe()
+and restored using ephy_node_db_load_from_file().
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT EphyNodeDb ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyNodeDb:immutable ##### -->
+<para>
+%TRUE if no #EphyNode<!-- -->s can be added, removed or modified from this
+#EphyNodeDb
+</para>
+
+<!-- ##### ARG EphyNodeDb:name ##### -->
+<para>
+A string identifier unique to this #EphyNodeDb
+</para>
+
+<!-- ##### FUNCTION ephy_node_db_new ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_node_db_load_from_file ##### -->
+<para>
+
+</para>
+
+@db:
+@xml_file:
+@xml_root:
+@xml_version:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_node_db_write_to_xml_safe ##### -->
+<para>
+
+</para>
+
+@db:
+@filename:
+@root:
+@version:
+@comment:
+@node:
+@Varargs:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_node_db_get_name ##### -->
+<para>
+
+</para>
+
+@db:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_node_db_is_immutable ##### -->
+<para>
+
+</para>
+
+@db:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_node_db_set_immutable ##### -->
+<para>
+
+</para>
+
+@db:
+@immutable:
+
+
+<!-- ##### FUNCTION ephy_node_db_get_node_from_id ##### -->
+<para>
+
+</para>
+
+@db:
+@id:
+@Returns:
+
+
diff --git a/doc/reference/tmpl/ephy-password-manager.sgml b/doc/reference/tmpl/ephy-password-manager.sgml
new file mode 100644
index 000000000..bfb3f287a
--- /dev/null
+++ b/doc/reference/tmpl/ephy-password-manager.sgml
@@ -0,0 +1,78 @@
+<!-- ##### SECTION Title ##### -->
+ephy-password-manager
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### MACRO EPHY_PASSWORD_MANAGER_IFACE ##### -->
+<para>
+
+</para>
+
+@k:
+
+
+<!-- ##### MACRO EPHY_IS_PASSWORD_MANAGER_IFACE ##### -->
+<para>
+
+</para>
+
+@k:
+
+
+<!-- ##### MACRO EPHY_TYPE_PASSWORD_INFO ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### FUNCTION ephy_password_info_new ##### -->
+<para>
+
+</para>
+
+@host:
+@username:
+@password:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_password_info_copy ##### -->
+<para>
+
+</para>
+
+@info:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_password_info_free ##### -->
+<para>
+
+</para>
+
+@info:
+
+
+<!-- ##### FUNCTION ephy_password_manager_get_type ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
diff --git a/doc/reference/tmpl/ephy-permission-manager.sgml b/doc/reference/tmpl/ephy-permission-manager.sgml
new file mode 100644
index 000000000..ded9a0742
--- /dev/null
+++ b/doc/reference/tmpl/ephy-permission-manager.sgml
@@ -0,0 +1,78 @@
+<!-- ##### SECTION Title ##### -->
+EphyPermissionManager
+
+<!-- ##### SECTION Short_Description ##### -->
+Sets webpages' cookie, image and popup permissions.
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+The #EphyPermissionManager keeps a list of websites and their permissions. For
+example, the user may want a certain website to display images but block
+cookies and popup windows; this could correspond to three entries in the
+#EphyPermissionManager.
+</para>
+<para>
+Use ephy_permission_manager_add() to set permissions for a website,
+ephy_permission_manager_remove() to remove the permissions, and
+ephy_permission_manager_test() to test them. Note that
+ephy_permission_manager_test() may return %EPHY_PERMISSION_DEFAULT, which
+means the caller might need to find the default permission some other way.
+</para>
+<para>
+The #EphyPermissionManager stores a list of site-specific permissions, but not
+defaults. For popups, the default permission is determined by the GConf key
+/apps/epiphany/web/allow_popups, which in turn determines Mozilla's
+dom.disable_open_during_load preference. For cookies, the GConf key
+/apps/epiphany/web/cookie_accept determines Mozilla's
+network.cookie.cookieBehavior preference. For images, the default is determined
+by Mozilla's network.image.imageBehavior preference.
+</para>
+<para>
+The predefined permission types are EPT_COOKIE ("cookie"), EPT_IMAGE ("image")
+and EPT_POPUP ("popup"). You can also make up your own type string.
+</para>
+<para>
+Though the word &quot;host&quot; is used in many function descriptions, Mozilla
+does not act as one would expect. Always pass a URL to any functions which
+need have a &quot;host&quot; parameter. However, the &quot;host&quot; in an
+#EphyPermissionInfo is a simple DNS hostname.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT EphyPermissionInfo ##### -->
+<para>
+Details a specific permission of a specific website.
+</para>
+
+@host: The hostname of the website to which this permission applies.
+@qtype:
+@permission: An #EphyPermission (either allow or deny).
+
+<!-- ##### ENUM EphyPermission ##### -->
+<para>
+Determines whether the website is allowed or denied access.
+</para>
+
+@EPHY_PERMISSION_ALLOWED:
+ The website is unconditionally allowed to perform the desired action.
+@EPHY_PERMISSION_DENIED:
+ The website is unconditionally denied to perform the desired action.
+@EPHY_PERMISSION_DEFAULT:
+ The user has not set a preference for this particular website; the
+ caller should therefore fall back to default settings.
+
+<!-- ##### FUNCTION ephy_permission_info_free ##### -->
+<para>
+
+</para>
+
+@info:
+
+
diff --git a/doc/reference/tmpl/ephy-search-entry.sgml b/doc/reference/tmpl/ephy-search-entry.sgml
new file mode 100644
index 000000000..d0b12203a
--- /dev/null
+++ b/doc/reference/tmpl/ephy-search-entry.sgml
@@ -0,0 +1,49 @@
+<!-- ##### SECTION Title ##### -->
+EphySearchEntry
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT EphySearchEntry ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL EphySearchEntry::search ##### -->
+<para>
+
+</para>
+
+@ephysearchentry: the object which received the signal.
+@arg1:
+
+<!-- ##### FUNCTION ephy_search_entry_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_search_entry_clear ##### -->
+<para>
+
+</para>
+
+@entry:
+
+
diff --git a/doc/reference/tmpl/ephy-session.sgml b/doc/reference/tmpl/ephy-session.sgml
new file mode 100644
index 000000000..ce97b6371
--- /dev/null
+++ b/doc/reference/tmpl/ephy-session.sgml
@@ -0,0 +1,84 @@
+<!-- ##### SECTION Title ##### -->
+ephy-session
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### FUNCTION ephy_session_get_active_window ##### -->
+<para>
+
+</para>
+
+@session:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_session_save ##### -->
+<para>
+
+</para>
+
+@session:
+@filename:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_session_load ##### -->
+<para>
+
+</para>
+
+@session:
+@filename:
+@user_time:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_session_close ##### -->
+<para>
+
+</para>
+
+@session:
+
+
+<!-- ##### FUNCTION ephy_session_get_windows ##### -->
+<para>
+
+</para>
+
+@session:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_session_add_window ##### -->
+<para>
+
+</para>
+
+@session:
+@window:
+
+
+<!-- ##### FUNCTION ephy_session_remove_window ##### -->
+<para>
+
+</para>
+
+@session:
+@window:
+
+
diff --git a/doc/reference/tmpl/ephy-shell.sgml b/doc/reference/tmpl/ephy-shell.sgml
new file mode 100644
index 000000000..f50e4bcfa
--- /dev/null
+++ b/doc/reference/tmpl/ephy-shell.sgml
@@ -0,0 +1,129 @@
+<!-- ##### SECTION Title ##### -->
+ephy-shell
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### VARIABLE ephy_shell ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ENUM EphyNewTabFlags ##### -->
+<para>
+
+</para>
+
+@EPHY_NEW_TAB_HOME_PAGE:
+@EPHY_NEW_TAB_NEW_PAGE:
+@EPHY_NEW_TAB_OPEN_PAGE:
+@EPHY_NEW_TAB_FULLSCREEN_MODE:
+@EPHY_NEW_TAB_DONT_SHOW_WINDOW:
+@EPHY_NEW_TAB_APPEND_LAST:
+@EPHY_NEW_TAB_APPEND_AFTER:
+@EPHY_NEW_TAB_JUMP:
+@EPHY_NEW_TAB_IN_NEW_WINDOW:
+@EPHY_NEW_TAB_IN_EXISTING_WINDOW:
+@EPHY_NEW_TAB_ALLOW_FIXUP:
+@EPHY_NEW_TAB_FROM_EXTERNAL:
+
+<!-- ##### FUNCTION ephy_shell_new_tab ##### -->
+<para>
+
+</para>
+
+@shell:
+@parent_window:
+@previous_embed:
+@url:
+@flags:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_shell_get_session ##### -->
+<para>
+
+</para>
+
+@shell:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_shell_get_bookmarks ##### -->
+<para>
+
+</para>
+
+@shell:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_shell_get_toolbars_model ##### -->
+<para>
+
+</para>
+
+@shell:
+@fullscreen:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_shell_get_extensions_manager ##### -->
+<para>
+
+</para>
+
+@shell:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_shell_get_bookmarks_editor ##### -->
+<para>
+
+</para>
+
+@shell:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_shell_get_history_window ##### -->
+<para>
+
+</para>
+
+@shell:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_shell_get_pdm_dialog ##### -->
+<para>
+
+</para>
+
+@shell:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_shell_get_prefs_dialog ##### -->
+<para>
+
+</para>
+
+@shell:
+@Returns:
+
+
diff --git a/doc/reference/tmpl/ephy-spinner.sgml b/doc/reference/tmpl/ephy-spinner.sgml
new file mode 100644
index 000000000..170eeb0c1
--- /dev/null
+++ b/doc/reference/tmpl/ephy-spinner.sgml
@@ -0,0 +1,58 @@
+<!-- ##### SECTION Title ##### -->
+EphySpinner
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT EphySpinner ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION ephy_spinner_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_spinner_start ##### -->
+<para>
+
+</para>
+
+@throbber:
+
+
+<!-- ##### FUNCTION ephy_spinner_stop ##### -->
+<para>
+
+</para>
+
+@throbber:
+
+
+<!-- ##### FUNCTION ephy_spinner_set_size ##### -->
+<para>
+
+</para>
+
+@spinner:
+@size:
+
+
diff --git a/doc/reference/tmpl/ephy-tab.sgml b/doc/reference/tmpl/ephy-tab.sgml
new file mode 100644
index 000000000..7b9bf485f
--- /dev/null
+++ b/doc/reference/tmpl/ephy-tab.sgml
@@ -0,0 +1,202 @@
+<!-- ##### SECTION Title ##### -->
+EphyTab
+
+<!-- ##### SECTION Short_Description ##### -->
+Represents an Epiphany tab
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+Each #EphyWindow contains a #GtkNotebook which holds one or more #EphyTab:s.
+An #EphyTab is basically a container for an #EphyEmbed.
+</para>
+<para>
+To retrieve an #EphyTab's parent #EphyWindow, use gtk_widget_get_toplevel().
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT EphyTab ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:address ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:document-type ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:hidden-popup-count ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:icon ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:icon-address ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:load-progress ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:load-status ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:message ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:navigation ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:popups-allowed ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:security-level ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:title ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:typed-address ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:visibility ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG EphyTab:zoom ##### -->
+<para>
+
+</para>
+
+<!-- ##### FUNCTION ephy_tab_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_tab_get_embed ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_tab_for_embed ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_tab_get_icon_address ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_tab_get_security_level ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_tab_get_title ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_tab_get_zoom ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_tab_get_load_status ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_tab_get_load_percent ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_tab_get_link_message ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_tab_get_status_message ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+
diff --git a/doc/reference/tmpl/ephy-window.sgml b/doc/reference/tmpl/ephy-window.sgml
new file mode 100644
index 000000000..23c9b1e2d
--- /dev/null
+++ b/doc/reference/tmpl/ephy-window.sgml
@@ -0,0 +1,110 @@
+<!-- ##### SECTION Title ##### -->
+EphyWindow
+
+<!-- ##### SECTION Short_Description ##### -->
+Represents an Epiphany window.
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+An #EphyWindow is what the user sees when opening Epiphany. Think of each
+#EphyWindow as a giant container which holds many useful items:
+</para>
+<itemizedlist>
+<listitem>A toolbar, available from ephy_window_get_toolbar().</listitem>
+<listitem>An #EphyStatusbar, available from
+ephy_window_get_statusbar().</listitem>
+<listitem>A #GtkNotebook for holding #EphyTabs. Use ephy_window_get_notebook(),
+ephy_window_get_tabs() and ephy_window_get_active_tab() to reach
+them. Manipulate tabs using ephy_window_add_tab(), ephy_window_remove_tab()
+and ephy_window_jump_to_tab().</listitem>
+</itemizedlist>
+<para>
+You can also perform simple manipulations of an #EphyWindow's active #EphyEmbed.
+These are restricted to ephy_window_set_zoom() and ephy_window_load_url().
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT EphyWindow ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION ephy_window_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_window_new_with_chrome ##### -->
+<para>
+
+</para>
+
+@chrome:
+@is_popup:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_window_get_notebook ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_window_get_toolbar ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_window_get_statusbar ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+
+<!-- ##### FUNCTION ephy_window_set_zoom ##### -->
+<para>
+
+</para>
+
+@window:
+@zoom:
+
+
+<!-- ##### FUNCTION ephy_window_activate_location ##### -->
+<para>
+
+</para>
+
+@window:
+
+
+<!-- ##### FUNCTION ephy_window_load_url ##### -->
+<para>
+
+</para>
+
+@window:
+@url:
+
+
diff --git a/doc/reference/tmpl/ephy-zoom-control.sgml b/doc/reference/tmpl/ephy-zoom-control.sgml
new file mode 100644
index 000000000..fcad1c60a
--- /dev/null
+++ b/doc/reference/tmpl/ephy-zoom-control.sgml
@@ -0,0 +1,56 @@
+<!-- ##### SECTION Title ##### -->
+EphyZoomControl
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### STRUCT EphyZoomControl ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL EphyZoomControl::zoom-to-level ##### -->
+<para>
+
+</para>
+
+@ephyzoomcontrol: the object which received the signal.
+@arg1:
+
+<!-- ##### ARG EphyZoomControl:zoom ##### -->
+<para>
+
+</para>
+
+<!-- ##### FUNCTION ephy_zoom_control_set_zoom_level ##### -->
+<para>
+
+</para>
+
+@control:
+@zoom:
+
+
+<!-- ##### FUNCTION ephy_zoom_control_get_zoom_level ##### -->
+<para>
+
+</para>
+
+@control:
+@Returns:
+
+
diff --git a/doc/reference/tmpl/epiphany-unused.sgml b/doc/reference/tmpl/epiphany-unused.sgml
new file mode 100644
index 000000000..ff95f58a9
--- /dev/null
+++ b/doc/reference/tmpl/epiphany-unused.sgml
@@ -0,0 +1,1043 @@
+<!-- ##### SECTION ./tmpl/EphySingle.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/EphySingle.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/EphySingle.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/EphySingle.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/EphySingle.sgml:Title ##### -->
+EphySingle
+
+
+<!-- ##### SECTION ./tmpl/ephy-tab.sgml:Long_Description ##### -->
+<para>
+Each #EphyWindow contains a #GtkNotebook which holds one or more #EphyTab:s.
+An #EphyTab is basically a container for an #EphyEmbed.
+</para>
+<para>
+To retrieve an #EphyTab's parent #EphyWindow, use gtk_widget_get_toplevel().
+</para>
+
+
+<!-- ##### SECTION ./tmpl/ephy-tab.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/ephy-tab.sgml:Short_Description ##### -->
+Represents an Epiphany tab
+
+
+<!-- ##### SECTION ./tmpl/ephy-tab.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/ephy-tab.sgml:Title ##### -->
+EphyTab
+
+
+<!-- ##### SECTION ./tmpl/epiphany-unused.sgml:Stability_Level ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/mozilla-embed-event.sgml:Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/mozilla-embed-event.sgml:See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION ./tmpl/mozilla-embed-event.sgml:Short_Description ##### -->
+
+
+
+<!-- ##### SECTION ./tmpl/mozilla-embed-event.sgml:Title ##### -->
+mozilla-embed-event
+
+
+<!-- ##### FUNCTION Detach ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### MACRO EPHY_EMBED_SINGLE_IFACE ##### -->
+<para>
+
+</para>
+
+@k:
+
+<!-- ##### MACRO EPHY_ICON_ENTRY ##### -->
+<para>
+
+</para>
+
+@object:
+
+<!-- ##### MACRO EPHY_ICON_ENTRY_CLASS ##### -->
+<para>
+
+</para>
+
+@klass:
+
+<!-- ##### MACRO EPHY_ICON_ENTRY_GET_CLASS ##### -->
+<para>
+
+</para>
+
+@obj:
+
+<!-- ##### MACRO EPHY_IS_EMBED_SINGLE_IFACE ##### -->
+<para>
+
+</para>
+
+@k:
+
+<!-- ##### MACRO EPHY_IS_ICON_ENTRY ##### -->
+<para>
+
+</para>
+
+@object:
+
+<!-- ##### MACRO EPHY_IS_ICON_ENTRY_CLASS ##### -->
+<para>
+
+</para>
+
+@klass:
+
+<!-- ##### MACRO EPHY_SHELL_ERROR ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO EPHY_SHELL_TYPE_DEF ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### MACRO EPHY_TYPE_ICON_ENTRY ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ENUM EmbedPersistFlags ##### -->
+<para>
+Determines how the #EphyEmbedPersist should act.
+</para>
+
+@EMBED_PERSIST_COPY_PAGE: If set, download a copy of the page being browsed by
+ the #EphyEmbedPersist's #EphyEmbed. This should be
+ specified with ephy_embed_persist_set_embed(). If
+ unset, ephy_embed_persist_set_source() must have been
+ called.
+@EMBED_PERSIST_MAINDOC: If set and %EMBED_PERSIST_COPY_PAGE is set, download the
+ #EphyEmbedPersist's #EphyEmbed's page's frameset. If
+ unset, download the currently-focused frame.
+@EMBED_PERSIST_NO_VIEW: If set, do not display this download in the download
+ manager.
+@EMBED_PERSIST_ASK_DESTINATION: If set, display a filechooser dialog. You must
+ call ephy_embed_persist_set_fc_title() and
+ ephy_embed_persist_set_fc_parent() before
+ ephy_embed_persist_save() if this is the case.
+ If unset, use the destination specified with
+ ephy_embed_persist_set_dest().
+@EMBED_PERSIST_DO_CONVERSION:
+
+<!-- ##### ENUM EmbedPrintPreviewNavType ##### -->
+<para>
+Specifies the action to perform in ephy_embed_print_preview_navigate().
+</para>
+
+@PRINTPREVIEW_GOTO_PAGENUM:
+@PRINTPREVIEW_PREV_PAGE:
+@PRINTPREVIEW_NEXT_PAGE:
+@PRINTPREVIEW_HOME:
+@PRINTPREVIEW_END:
+
+<!-- ##### ENUM EmbedReloadFlags ##### -->
+<para>
+
+</para>
+
+@EMBED_RELOAD_NORMAL:
+@EMBED_RELOAD_FORCE: Bypass cache and proxy while reloading a web page
+
+<!-- ##### ENUM EmbedSecurityLevel ##### -->
+<para>
+Represents the security status of an #EphyEmbed. For example, a page with an
+invalid SSL certificate will have an #EmbedSecurityLevel of %STATE_IS_BROKEN.
+</para>
+
+@STATE_IS_UNKNOWN:
+@STATE_IS_INSECURE:
+@STATE_IS_BROKEN:
+@STATE_IS_SECURE_MED:
+@STATE_IS_SECURE_LOW:
+@STATE_IS_SECURE_HIGH:
+
+<!-- ##### ENUM EmbedState ##### -->
+<para>
+Represents the state of an #EphyEmbed with regards to networking negotiations.
+</para>
+
+@EMBED_STATE_UNKNOWN:
+@EMBED_STATE_START:
+@EMBED_STATE_REDIRECTING:
+@EMBED_STATE_TRANSFERRING:
+@EMBED_STATE_NEGOTIATING:
+@EMBED_STATE_STOP:
+@EMBED_STATE_IS_REQUEST:
+@EMBED_STATE_IS_DOCUMENT:
+@EMBED_STATE_IS_NETWORK:
+@EMBED_STATE_IS_WINDOW:
+
+<!-- ##### FUNCTION EmitCookieNotification ##### -->
+<para>
+
+</para>
+
+@name:
+@aSubject:
+@Returns:
+
+<!-- ##### FUNCTION EmitPermissionNotification ##### -->
+<para>
+
+</para>
+
+@name:
+@aSubject:
+@Returns:
+
+<!-- ##### ENUM EphyCookieP3PPolicy ##### -->
+<para>
+
+</para>
+
+@EPHY_COOKIE_P3P_POLICY_UNKNOWN:
+@EPHY_COOKIE_P3P_POLICY_NONE:
+@EPHY_COOKIE_P3P_POLICY_NO_CONSENT:
+@EPHY_COOKIE_P3P_POLICY_IMPLICIT_CONSENT:
+@EPHY_COOKIE_P3P_POLICY_EXPLICIT_CONSENT:
+@EPHY_COOKIE_P3P_POLICY_NO_II:
+
+<!-- ##### ENUM EphyCookieP3PState ##### -->
+<para>
+
+</para>
+
+@EPHY_COOKIE_P3P_STATE_UNKNOWN:
+@EPHY_COOKIE_P3P_STATE_ACCEPTED:
+@EPHY_COOKIE_P3P_STATE_DOWNGRADED:
+@EPHY_COOKIE_P3P_STATE_FLAGGED:
+@EPHY_COOKIE_P3P_STATE_REJECTED:
+
+<!-- ##### SIGNAL EphyEmbed::ge-content-change ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EphyEmbed::ge-location ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EphyEmbed::ge-net-state ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL EphyEmbed::ge-security-change ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EphyEmbed::ge-zoom-change ##### -->
+<para>
+
+</para>
+
+@ephyembed: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL EphyEmbedPersist::cancelled ##### -->
+<para>
+
+</para>
+
+@ephyembedpersist: the object which received the signal.
+
+<!-- ##### SIGNAL EphyEmbedPersist::completed ##### -->
+<para>
+
+</para>
+
+@ephyembedpersist: the object which received the signal.
+
+<!-- ##### ARG EphyEmbedPersist:dest ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyEmbedPersist:embed ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyEmbedPersist:filechooser-parent ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyEmbedPersist:filechooser-title ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyEmbedPersist:flags ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyEmbedPersist:max-size ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyEmbedPersist:persist-key ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyEmbedPersist:source ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ENUM EphyShellError ##### -->
+<para>
+
+</para>
+
+@EPHY_SHELL_ERROR_MISSING_SERVER:
+@EPHY_SHELL_ERROR_OBJECT_REG_FAILED:
+@EPHY_SHELL_ERROR_FACTORY_REG_FAILED:
+
+<!-- ##### ENUM EphyShellStartupFlags ##### -->
+<para>
+
+</para>
+
+@EPHY_SHELL_STARTUP_TABS:
+@EPHY_SHELL_STARTUP_EXISTING_WINDOW:
+@EPHY_SHELL_STARTUP_FULLSCREEN:
+@EPHY_SHELL_STARTUP_BOOKMARKS_EDITOR:
+@EPHY_SHELL_STARTUP_SESSION:
+@EPHY_SHELL_STARTUP_IMPORT_BOOKMARKS:
+@EPHY_SHELL_STARTUP_ADD_BOOKMARK:
+
+<!-- ##### STRUCT EphyTab ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:address ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:blocked-popup-count ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:document-type ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:hidden-popup-count ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:icon ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:icon-address ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:load-progress ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:load-status ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:message ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:navigation ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:popups-allowed ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:security-level ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:title ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:typed-address ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:visibility ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:visible ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyTab:zoom ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyWindow:active-tab ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyWindow:chrome ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyWindow:is-popup ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG EphyWindow:print-preview-mode ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION Init ##### -->
+<para>
+
+</para>
+
+@aOwner:
+@Returns:
+
+<!-- ##### FUNCTION ephy_embed_activate ##### -->
+<para>
+
+</para>
+
+@embed:
+
+<!-- ##### FUNCTION ephy_embed_can_go_back ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+<!-- ##### FUNCTION ephy_embed_can_go_forward ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+<!-- ##### FUNCTION ephy_embed_find_next ##### -->
+<para>
+
+</para>
+
+@embed:
+@backwards:
+@Returns:
+
+<!-- ##### FUNCTION ephy_embed_find_set_properties ##### -->
+<para>
+
+</para>
+
+@find:
+@search_string:
+@case_sensitive:
+
+<!-- ##### FUNCTION ephy_embed_get_encoding_info ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+<!-- ##### FUNCTION ephy_embed_get_type ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION ephy_embed_get_zoom ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+<!-- ##### FUNCTION ephy_embed_go_back ##### -->
+<para>
+
+</para>
+
+@embed:
+
+<!-- ##### FUNCTION ephy_embed_go_forward ##### -->
+<para>
+
+</para>
+
+@embed:
+
+<!-- ##### FUNCTION ephy_embed_print ##### -->
+<para>
+
+</para>
+
+@embed:
+
+<!-- ##### FUNCTION ephy_embed_print_preview_close ##### -->
+<para>
+
+</para>
+
+@embed:
+
+<!-- ##### FUNCTION ephy_embed_reload ##### -->
+<para>
+
+</para>
+
+@embed:
+@force:
+
+<!-- ##### FUNCTION ephy_embed_set_zoom ##### -->
+<para>
+
+</para>
+
+@embed:
+@zoom:
+
+<!-- ##### FUNCTION ephy_embed_single_load_proxy_autoconf ##### -->
+<para>
+
+</para>
+
+@single:
+@url:
+@shell:
+
+<!-- ##### FUNCTION ephy_embed_single_set_offline_mode ##### -->
+<para>
+
+</para>
+
+@single:
+@offline:
+@shell:
+
+<!-- ##### FUNCTION ephy_embed_stop_load ##### -->
+<para>
+
+</para>
+
+@embed:
+
+<!-- ##### FUNCTION ephy_extensions_manager_add ##### -->
+<para>
+
+</para>
+
+@manager:
+@type:
+@Returns:
+
+<!-- ##### FUNCTION ephy_extensions_manager_load_dir ##### -->
+<para>
+
+</para>
+
+@manager:
+@path:
+
+<!-- ##### FUNCTION ephy_extensions_manager_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION ephy_glade_widget_new ##### -->
+<para>
+
+</para>
+
+@file:
+@widget_name:
+@root:
+@data:
+@domain:
+@Returns:
+
+<!-- ##### FUNCTION ephy_node_db_get_by_name ##### -->
+<para>
+
+</para>
+
+@name:
+@Returns:
+
+<!-- ##### FUNCTION ephy_password_manager_add ##### -->
+<para>
+
+</para>
+
+@manager:
+@info:
+
+<!-- ##### FUNCTION ephy_password_manager_list ##### -->
+<para>
+
+</para>
+
+@manager:
+@Returns:
+
+<!-- ##### FUNCTION ephy_password_manager_remove ##### -->
+<para>
+
+</para>
+
+@manager:
+@info:
+
+<!-- ##### FUNCTION ephy_permission_manager_add ##### -->
+<para>
+
+</para>
+
+@manager:
+@host:
+@type:
+@permission:
+
+<!-- ##### FUNCTION ephy_permission_manager_clear ##### -->
+<para>
+
+</para>
+
+@manager:
+
+<!-- ##### FUNCTION ephy_permission_manager_list ##### -->
+<para>
+
+</para>
+
+@manager:
+@type:
+@Returns:
+
+<!-- ##### FUNCTION ephy_permission_manager_remove ##### -->
+<para>
+
+</para>
+
+@manager:
+@host:
+@type:
+
+<!-- ##### FUNCTION ephy_permission_manager_test ##### -->
+<para>
+
+</para>
+
+@manager:
+@host:
+@type:
+@Returns:
+
+<!-- ##### FUNCTION ephy_session_autoresume ##### -->
+<para>
+
+</para>
+
+@session:
+@user_time:
+@Returns:
+
+<!-- ##### FUNCTION ephy_shell_delete_on_exit ##### -->
+<para>
+
+</para>
+
+@shell:
+@path:
+@gs:
+
+<!-- ##### FUNCTION ephy_shell_error_quark ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION ephy_shell_get_active_window ##### -->
+<para>
+
+</para>
+
+@shell:
+@Returns:
+
+<!-- ##### FUNCTION ephy_shell_get_print_setup_dialog ##### -->
+<para>
+
+</para>
+
+@shell:
+@Returns:
+
+<!-- ##### FUNCTION ephy_shell_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION ephy_shell_startup ##### -->
+<para>
+
+</para>
+
+@shell:
+@flags:
+@user_time:
+@args:
+@string_arg:
+@error:
+@Returns:
+@startup_id:
+
+<!-- ##### FUNCTION ephy_tab_for_embed ##### -->
+<para>
+
+</para>
+
+@embed:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_embed ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_icon_address ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_link_message ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_load_percent ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_load_status ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_location ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_security_level ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_status_message ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_title ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_window ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_get_zoom ##### -->
+<para>
+
+</para>
+
+@tab:
+@Returns:
+
+<!-- ##### FUNCTION ephy_tab_new ##### -->
+<para>
+
+</para>
+
+@Returns:
+
+<!-- ##### FUNCTION ephy_window_add_tab ##### -->
+<para>
+
+</para>
+
+@window:
+@tab:
+@position:
+@jump_to:
+
+<!-- ##### FUNCTION ephy_window_find ##### -->
+<para>
+
+</para>
+
+@window:
+
+<!-- ##### FUNCTION ephy_window_get_active_embed ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+<!-- ##### FUNCTION ephy_window_get_active_tab ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+<!-- ##### FUNCTION ephy_window_get_tabs ##### -->
+<para>
+
+</para>
+
+@window:
+@Returns:
+
+<!-- ##### FUNCTION ephy_window_jump_to_tab ##### -->
+<para>
+
+</para>
+
+@window:
+@tab:
+
+<!-- ##### FUNCTION ephy_window_print ##### -->
+<para>
+
+</para>
+
+@window:
+
+<!-- ##### FUNCTION ephy_window_remove_tab ##### -->
+<para>
+
+</para>
+
+@window:
+@tab:
+
+<!-- ##### FUNCTION ephy_window_set_print_preview ##### -->
+<para>
+
+</para>
+
+@window:
+@enabled:
+
+<!-- ##### FUNCTION mozilla_cookie_to_ephy_cookie ##### -->
+<para>
+
+</para>
+
+@cookie:
+@Returns:
+
+<!-- ##### FUNCTION mozilla_embed_event_new ##### -->
+<para>
+
+</para>
+
+@dom_event:
+@Returns:
+
+<!-- ##### FUNCTION mozilla_embed_event_set_property ##### -->
+<para>
+
+</para>
+
+@event:
+@name:
+@value:
+
+<!-- ##### FUNCTION mozilla_permission_to_ephy_permission ##### -->
+<para>
+
+</para>
+
+@perm:
+@Returns:
+
diff --git a/doc/reference/tmpl/mozilla-embed-event.sgml b/doc/reference/tmpl/mozilla-embed-event.sgml
new file mode 100644
index 000000000..d8aa00dd3
--- /dev/null
+++ b/doc/reference/tmpl/mozilla-embed-event.sgml
@@ -0,0 +1,35 @@
+<!-- ##### SECTION Title ##### -->
+mozilla-embed-event
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### FUNCTION mozilla_embed_event_new ##### -->
+<para>
+
+</para>
+
+@dom_event:
+@Returns:
+
+
+<!-- ##### FUNCTION mozilla_embed_event_set_property ##### -->
+<para>
+
+</para>
+
+@event:
+@name:
+@value:
+
+