aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/.cvsignore2
-rw-r--r--doc/reference-howto.txt29
-rw-r--r--doc/reference/tmpl/ephy-session.sgml2
-rw-r--r--doc/reference/tmpl/ephy-shell.sgml2
4 files changed, 31 insertions, 4 deletions
diff --git a/doc/.cvsignore b/doc/.cvsignore
new file mode 100644
index 000000000..282522db0
--- /dev/null
+++ b/doc/.cvsignore
@@ -0,0 +1,2 @@
+Makefile
+Makefile.in
diff --git a/doc/reference-howto.txt b/doc/reference-howto.txt
new file mode 100644
index 000000000..314eac714
--- /dev/null
+++ b/doc/reference-howto.txt
@@ -0,0 +1,29 @@
+If you want to document one of the epiphany files you can do it
+by the following steps:
+
+- Add documentation headers to the .c file public functions
+
+For example:
+
+/**
+ * ephy_session_autoresume:
+ * @session: a #EphySession
+ *
+ * Resume a crashed session when necessary (interactive)
+ *
+ * Return value: TRUE if at least a window has been opened
+ **/
+gboolean
+ephy_session_autoresume (EphySession *session)
+
+I dont think gtk-doc has a syntax document, though gtk is
+a good example to look at.
+
+- If it's a GObject add the get_type function and include
+the .h in doc/reference/epiphany.types.
+
+- Remove the .h from the IGNORE_HFILES section of
+doc/reference/Makefile.am
+
+- Build and commit both the modified .c and the sgml generated
+in doc/reference/tmpl
diff --git a/doc/reference/tmpl/ephy-session.sgml b/doc/reference/tmpl/ephy-session.sgml
index 03ba6989f..4b3e753a3 100644
--- a/doc/reference/tmpl/ephy-session.sgml
+++ b/doc/reference/tmpl/ephy-session.sgml
@@ -9,13 +9,11 @@ ephy-session
</para>
-
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
-
<!-- ##### FUNCTION ephy_session_get_active_window ##### -->
<para>
diff --git a/doc/reference/tmpl/ephy-shell.sgml b/doc/reference/tmpl/ephy-shell.sgml
index 176490882..1badb7c15 100644
--- a/doc/reference/tmpl/ephy-shell.sgml
+++ b/doc/reference/tmpl/ephy-shell.sgml
@@ -9,13 +9,11 @@ ephy-shell
</para>
-
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
-
<!-- ##### MACRO EPHY_SHELL_TYPE_DEF ##### -->
<para>