diff options
| author | Marco Pesenti Gritti <marco@src.gnome.org> | 2003-11-20 04:14:05 +0800 |
|---|---|---|
| committer | Marco Pesenti Gritti <marco@src.gnome.org> | 2003-11-20 04:14:05 +0800 |
| commit | c7b845e657b1da27c44d37d93e51048abc2b36b4 (patch) | |
| tree | eb16b899d60b45571a1c8f622c993888f72ad0d8 | |
| parent | 6fc311e86a048a94a088e3b200cde4f1a83f84de (diff) | |
| download | gsoc2013-epiphany-c7b845e657b1da27c44d37d93e51048abc2b36b4.tar gsoc2013-epiphany-c7b845e657b1da27c44d37d93e51048abc2b36b4.tar.gz gsoc2013-epiphany-c7b845e657b1da27c44d37d93e51048abc2b36b4.tar.bz2 gsoc2013-epiphany-c7b845e657b1da27c44d37d93e51048abc2b36b4.tar.lz gsoc2013-epiphany-c7b845e657b1da27c44d37d93e51048abc2b36b4.tar.xz gsoc2013-epiphany-c7b845e657b1da27c44d37d93e51048abc2b36b4.tar.zst gsoc2013-epiphany-c7b845e657b1da27c44d37d93e51048abc2b36b4.zip | |
*** empty log message ***
| -rw-r--r-- | doc/.cvsignore | 2 | ||||
| -rw-r--r-- | doc/reference-howto.txt | 29 | ||||
| -rw-r--r-- | doc/reference/tmpl/ephy-session.sgml | 2 | ||||
| -rw-r--r-- | doc/reference/tmpl/ephy-shell.sgml | 2 |
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> |