aboutsummaryrefslogtreecommitdiffstats
path: root/doc/reference-howto.txt
diff options
context:
space:
mode:
authorMarco Pesenti Gritti <marco@src.gnome.org>2003-11-20 04:14:05 +0800
committerMarco Pesenti Gritti <marco@src.gnome.org>2003-11-20 04:14:05 +0800
commitc7b845e657b1da27c44d37d93e51048abc2b36b4 (patch)
treeeb16b899d60b45571a1c8f622c993888f72ad0d8 /doc/reference-howto.txt
parent6fc311e86a048a94a088e3b200cde4f1a83f84de (diff)
downloadgsoc2013-epiphany-c7b845e657b1da27c44d37d93e51048abc2b36b4.tar.gz
gsoc2013-epiphany-c7b845e657b1da27c44d37d93e51048abc2b36b4.tar.zst
gsoc2013-epiphany-c7b845e657b1da27c44d37d93e51048abc2b36b4.zip
*** empty log message ***
Diffstat (limited to 'doc/reference-howto.txt')
-rw-r--r--doc/reference-howto.txt29
1 files changed, 29 insertions, 0 deletions
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