Revert "docs: remove generated templates"

This reverts commit 3deb6e06fd3cccaf26bca8c81bf1f83ef7993dd6.

This broke distcheck.

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: 
+
+