more documentation stuff

svn path=/trunk/; revision=863

7 files changed, 209 insertions, 0 deletions

diff --git a/devel-docs/Makefile.am b/devel-docs/Makefile.am
new file mode 100644
index 0000000000..74a5ff5b60
--- /dev/null
+++ b/devel-docs/Makefile.am
@@ -0,0 +1,3 @@
+## Process this file with automake to produce Makefile.in
+
+SUBDIRS=camel
diff --git a/devel-docs/camel/Makefile.am b/devel-docs/camel/Makefile.am
new file mode 100644
index 0000000000..810c5f5f7f
--- /dev/null
+++ b/devel-docs/camel/Makefile.am
@@ -0,0 +1,95 @@
+## Process this file with automake to produce Makefile.in
+
+# The name of the module.
+DOC_MODULE=camel
+
+# The top-level SGML file.
+DOC_MAIN_SGML_FILE=camel-docs.sgml
+
+# The directory containing the source code (if it contains documentation).
+DOC_SOURCE_DIR=$(top_srcdir)/camel
+
+CFLAGS=`gtk-config --cflags gtk`
+LDFLAGS="-lcamel `gtk-config --libs gtk` "
+
+
+HTML_DIR=$(datadir)/gnome/html
+
+
+
+TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)
+
+tmpl_sources =					\
+	tmpl/camel-service.sgml			
+	tmpl/camel-store.sgml			
+
+
+camel_docdir = $(HTML_DIR)
+camel_doc_DATA =				\
+	camel.html				\
+	camel.hierarchy			\
+	camel.types				\
+	camel-scan.c				\
+	camel-decl.txt			\
+	camel-sections.txt
+
+EXTRA_DIST = $(camel_doc_DATA)
+
+camel.html: html/book1.html
+	-cd $(srcdir) && cp html/book1.html camel.html
+
+html/book1.html: sgml/camel-doc.bottom
+	$(MAKE) html
+
+sgml/camel-doc.bottom: $(tmpl_sources)
+	$(MAKE) sgml
+
+camel-scan.c:
+
+scan: camel-scan.c				
+	-CFLAGS=$(CFLAGS) LDFLAGS=$(LDFLAGS) gtkdoc-scanobj --module=$(DOC_MODULE)
+	gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR)
+
+templates: camel-scan.c
+	gtkdoc-mktmpl --module=$(DOC_MODULE)
+
+sgml: templates
+	gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR)
+
+html: sgml
+	if ! test -d html ; then mkdir html ; fi
+	-cd html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE)
+
+clean-local:
+	rm -f *~ *.bak *.hierarchy *.signals *.args *-unused.txt camel.html
+
+maintainer-clean-local: clean
+	rm -rf sgml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt Makefile.in 
+
+install-data-local: 
+	$(mkinstalldirs) $(TARGET_DIR)
+	(installfiles=`echo $(srcdir)/html/*.html`; \
+	if test "$$installfiles" = '$(srcdir)/html/*.html'; \
+	then echo '-- Nothing to install' ; \
+	else \
+	  for i in $$installfiles; do \
+	    echo '-- Installing '$$i ; \
+	    $(INSTALL_DATA) $$i $(TARGET_DIR); \
+	  done; \
+	  echo '-- Installing $(srcdir)/html/index.sgml' ; \
+	  $(INSTALL_DATA) $(srcdir)/html/index.sgml $(TARGET_DIR); \
+	  echo '-- Fixing Crossreferences' ; \
+	  gtkdoc-fixxref --module=$(DOC_MODULE) --html-dir=$(HTML_DIR)|| true; \
+	fi)
+
+dist-hook:
+	mkdir $(distdir)/html
+	mkdir $(distdir)/sgml
+	mkdir $(distdir)/tmpl
+	-cp $(srcdir)/html/*.html $(srcdir)/html/*.css $(distdir)/html
+	-cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl
+	-cp $(srcdir)/sgml/*.sgml $(distdir)/sgml
+	-cp $(srcdir)/sgml/*.bottom $(srcdir)/sgml/*.top $(distdir)/sgml
+
+
+.PHONY : html sgml templates scan
diff --git a/devel-docs/camel/camel-docs.sgml b/devel-docs/camel/camel-docs.sgml
new file mode 100644
index 0000000000..a84fbd53b2
--- /dev/null
+++ b/devel-docs/camel/camel-docs.sgml
@@ -0,0 +1,16 @@
+<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [
+<!entity CamelService SYSTEM "sgml/camel-service.sgml">
+<!entity CamelStore SYSTEM "sgml/camel-store.sgml">
+]>
+
+<book>
+  <bookinfo>
+    <title>Camel Mail Library Reference Manual</title>
+  </bookinfo>
+
+  <chapter id="camel-objects">
+    <title>Camel Objects</title>
+    &CamelService;
+    &CamelStore;
+  </chapter>
+</book>
diff --git a/devel-docs/camel/camel-sections.txt b/devel-docs/camel/camel-sections.txt
new file mode 100644
index 0000000000..e921f0cf8a
--- /dev/null
+++ b/devel-docs/camel/camel-sections.txt
@@ -0,0 +1,25 @@
+
+<INCLUDE>gnome.h</INCLUDE>
+
+<SECTION>
+<FILE>camel-service</FILE>
+CamelService
+<TITLE>CamelService</TITLE>
+<SUBSECTION Standard>
+CAMEL_SERVICE
+camel_service_get_type
+CAMEL_SERVICE_CLASS
+</SECTION>
+
+<SECTION>
+<FILE>camel-store</FILE>
+CamelStore
+<TITLE>CamelStore</TITLE>
+camel_store_get_separator
+camel_store_get_folder
+<SUBSECTION Standard>
+CAMEL_SERVICE
+camel_store_get_type
+CAMEL_SERVICE_CLASS
+</SECTION>
+
diff --git a/devel-docs/camel/camel.types b/devel-docs/camel/camel.types
new file mode 100644
index 0000000000..90a40acea7
--- /dev/null
+++ b/devel-docs/camel/camel.types
@@ -0,0 +1,3 @@
+#include <gtk/gtk.h>
+
+camel_service_get_type
diff --git a/devel-docs/camel/tmpl/camel-service.sgml b/devel-docs/camel/tmpl/camel-service.sgml
new file mode 100644
index 0000000000..9026b94652
--- /dev/null
+++ b/devel-docs/camel/tmpl/camel-service.sgml
@@ -0,0 +1,24 @@
+<!-- ##### SECTION Title ##### -->
+CamelService
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT CamelService ##### -->
+<para>
+
+</para>
+
+
diff --git a/devel-docs/camel/tmpl/camel-store.sgml b/devel-docs/camel/tmpl/camel-store.sgml
new file mode 100644
index 0000000000..44b3796759
--- /dev/null
+++ b/devel-docs/camel/tmpl/camel-store.sgml
@@ -0,0 +1,43 @@
+<!-- ##### SECTION Title ##### -->
+CamelStore
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### STRUCT CamelStore ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION camel_store_get_separator ##### -->
+<para>
+
+</para>
+
+@store: 
+@Returns: 
+
+
+<!-- ##### FUNCTION camel_store_get_folder ##### -->
+<para>
+
+</para>
+
+@store: 
+@folder_name: 
+@Returns: 
+
+