summaryrefslogtreecommitdiff
path: root/mate-dictionary/docs
diff options
context:
space:
mode:
Diffstat (limited to 'mate-dictionary/docs')
-rw-r--r--mate-dictionary/docs/Makefile.am3
-rw-r--r--mate-dictionary/docs/reference/Makefile.am1
-rw-r--r--mate-dictionary/docs/reference/gdict/ChangeLog71
-rw-r--r--mate-dictionary/docs/reference/gdict/Makefile.am75
-rw-r--r--mate-dictionary/docs/reference/gdict/gdict-docs.sgml159
-rw-r--r--mate-dictionary/docs/reference/gdict/gdict-overrides.txt0
-rw-r--r--mate-dictionary/docs/reference/gdict/gdict-sections.txt336
-rw-r--r--mate-dictionary/docs/reference/gdict/gdict.types9
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-client-context.sgml146
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-context.sgml300
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-database-chooser.sgml194
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-defbox.sgml288
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-source-chooser.sgml186
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-source-loader.sgml144
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-source.sgml253
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-speller.sgml174
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-strategy-chooser.sgml188
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-unused.sgml0
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-utils.sgml107
-rw-r--r--mate-dictionary/docs/reference/gdict/tmpl/gdict-version.sgml105
-rw-r--r--mate-dictionary/docs/reference/gdict/version.xml.in1
-rw-r--r--mate-dictionary/docs/source-configuration.txt65
22 files changed, 2805 insertions, 0 deletions
diff --git a/mate-dictionary/docs/Makefile.am b/mate-dictionary/docs/Makefile.am
new file mode 100644
index 00000000..fcc10bfd
--- /dev/null
+++ b/mate-dictionary/docs/Makefile.am
@@ -0,0 +1,3 @@
+SUBDIRS = reference
+
+EXTRA_DIST = source-configuration.txt
diff --git a/mate-dictionary/docs/reference/Makefile.am b/mate-dictionary/docs/reference/Makefile.am
new file mode 100644
index 00000000..20467a8e
--- /dev/null
+++ b/mate-dictionary/docs/reference/Makefile.am
@@ -0,0 +1 @@
+SUBDIRS = gdict
diff --git a/mate-dictionary/docs/reference/gdict/ChangeLog b/mate-dictionary/docs/reference/gdict/ChangeLog
new file mode 100644
index 00000000..6648e039
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/ChangeLog
@@ -0,0 +1,71 @@
+2007-08-13 Emmanuele Bassi <[email protected]>
+
+ * gdict-sections.txt: Remove undefined symbols and add the
+ last undocumented one.
+
+2007-08-13 Emmanuele Bassi <[email protected]>
+
+ * gdict-sections.txt: Add undocumented symbols.
+
+ * gdict-docs.sgml: Use parts instead of sections and add
+ the utilities and version checking pages.
+
+2007-08-13 Emmanuele Bassi <[email protected]>
+
+ * tmpl/*: Remove templates.
+
+ * gdict-docs.sgml:
+ * gdict-sections.txt: Update and clean up.
+
+2007-08-13 Emmanuele Bassi <[email protected]>
+
+ * gdict.types: Add types
+
+ * Makefile.am:
+ * gdict-sections.txt:
+ * gdict-docs.sgml: Remove GdictEntry.
+
+2006-01-27 Emmanuele Bassi <[email protected]>
+
+ * gdict-sections.txt: add new GdictDefbox functions:
+ gdict_defbox_get_font_name and gdict_defbox_set_font_name.
+
+2006-01-16 Emmanuele Bassi <[email protected]>
+
+ D gdict-decl.txt
+
+ * gdict-decl.txt: remove this auto-generated file
+
+2006-01-16 Emmanuele Bassi <[email protected]>
+
+ D gdict-decl-list.txt
+ D gdict-undocumented.txt
+ A gdict-context.sgml
+
+ * gdict-decl-list.txt, gdict-undocumented.txt: remove these
+ auto-generated files.
+
+ * .cvsignore: add gdict-decl-list.txt to the list of ignored
+ files
+
+ * tmpl/gdict-context.sgml: add documentation of the GdictContext
+ GInterface and the boxed types defined in gdict-context.h
+
+ * tmpl/gdict-source.sgml: add a description of the GdictSource object
+
+2005-12-30 Emmanuele Bassi <[email protected]>
+
+ * gdict-docs.sgml: flesh out the text.
+
+ * gdict-sections.txt: add new functions and data structures.
+
+2005-12-19 Emmanuele Bassi <[email protected]>
+
+ A .cvsignore
+ A tmpl/.cvsignore
+
+ * .cvsignore, tmpl/.cvsignore: added .cvsignore files.
+
+2005-11-12 Emmanuele Bassi <[email protected]>
+
+ * Makefile.am: build against ../../../libgdict
diff --git a/mate-dictionary/docs/reference/gdict/Makefile.am b/mate-dictionary/docs/reference/gdict/Makefile.am
new file mode 100644
index 00000000..8dab089e
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/Makefile.am
@@ -0,0 +1,75 @@
+## Process this file with automake to produce Makefile.in
+
+AUTOMAKE_OPTIONS = 1.6
+
+# The name of the module, e.g. 'glib'.
+DOC_MODULE=mate-dict
+
+# The top-level SGML file. Change it if you want.
+DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
+
+# The directory containing the source code. Relative to $(srcdir).
+# gtk-doc will search all .c & .h files beneath here for inline comments
+# documenting functions and macros.
+DOC_SOURCE_DIR=../../../libgdict
+
+# Extra options to supply to gtkdoc-scan.
+SCAN_OPTIONS=
+
+# Extra options to pass to gtkdoc-scangobj
+SCANGOBJ_OPTIONS=--type-init-func="g_type_init()"
+
+# Extra options to supply to gtkdoc-mkdb.
+MKDB_OPTIONS=--sgml-mode --output-format=xml
+
+# Extra options to supply to gtkdoc-fixref.
+FIXXREF_OPTIONS=
+
+# Used for dependencies.
+HFILE_GLOB=$(top_srcdir)/mate-dictionary/libgdict/*.h
+CFILE_GLOB=$(top_srcdir)/mate-dictionary/libgdict/*.c
+
+# Header files to ignore when scanning.
+IGNORE_HFILES = \
+ gdict-enum-types.h \
+ gdict-marshal.h \
+ gdict-context-private.h \
+ gdict-debug.h \
+ gdict-private.h \
+ stamp-gdict-enum-types.h \
+ stamp-gdict-marshal.h
+
+# Images to copy into HTML directory.
+HTML_IMAGES =
+
+# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
+content_files = version.xml
+
+# Other files to distribute.
+extra_files =
+
+# CFLAGS and LDFLAGS for compiling scan program. Only needed if your app/lib
+# contains GtkObjects/GObjects and you want to document signals and properties.
+GTKDOC_CFLAGS = \
+ $(CFLAGS) \
+ $(CPPFLAGS) \
+ $(LIBGDICT_CFLAGS) \
+ -I$(srcdir)/../../../libgdict \
+ -I$(top_builddir)/mate-dictionary/libgdict
+
+GTKDOC_LIBS = \
+ $(LDFLAGS) \
+ $(LIBGDICT_LIBS) \
+ ../../../libgdict/libmatedict.la
+
+include $(top_srcdir)/gtk-doc.make
+
+# Other files to distribute
+# e.g. EXTRA_DIST += version.xml.in
+EXTRA_DIST += version.xml.in
+
+#dist-hook-local:
+# mkdir $(distdir)/TEXT; \
+# for f in $(srcdir)/TEXT/* ; do \
+# test -f $$f && cp -p $$f $(distdir)/TEXT; \
+# done
diff --git a/mate-dictionary/docs/reference/gdict/gdict-docs.sgml b/mate-dictionary/docs/reference/gdict/gdict-docs.sgml
new file mode 100644
index 00000000..19c4555a
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/gdict-docs.sgml
@@ -0,0 +1,159 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
+ "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
+
+<!ENTITY version SYSTEM "version.xml">
+]>
+
+<book xmlns:xi="http://www.w3.org/2003/XInclude" id="libgdict">
+ <bookinfo>
+ <title>MATE Dictionary Library Reference Manual</title>
+ <authorgroup>
+ <author>
+ <firstname>Emmanuele</firstname>
+ <surname>Bassi</surname>
+ <affiliation>
+ <address>
+ <email>[email protected]</email>
+ </address>
+ </affiliation>
+ </author>
+ </authorgroup>
+
+ <copyright>
+ <year>2005</year>
+ <holder>Emmanuele Bassi</holder>
+ </copyright>
+
+ <abstract>
+
+ <para>
+ This manual documents the &version; release of the Dictionary
+ Library for MATE 2.x
+ </para>
+
+ </abstract>
+
+ </bookinfo>
+
+ <part id="introduction">
+ <title>Introduction</title>
+
+ <partintro>
+ <para>
+ The MATE Dictionary Library is a simple yet powerful collection of
+ classes that can be used to access various dictionary sources.
+ </para>
+
+ <para>
+ It was created for the MATE Dictionary application, but it has been
+ made available for each developer whom wishes to access and display
+ definitions stored inside language dictionaries.
+ </para>
+
+ </partintro>
+
+ </part>
+
+ <part id="gdict">
+ <title>The MATE Dictionary Library</title>
+
+ <chapter id="context">
+ <title>Dictionary Context</title>
+
+ <para>A dictionary context is a representation of a transport method,
+ that is a way to access a dictionary source.</para>
+
+ <para>A dictionary source is any digital representation of a language
+ dictionary which provides a way to programmatically query its contents
+ for the available definitions of a word, phrase or any kind of
+ text.</para>
+
+ <para>A dictionary source might use files encoded using the DICT or the
+ StarDict formats, and offer an interface for queries compliant to the
+ Dictionary Protocol as defined by the RFC 2229.</para>
+
+ <xi:include href="xml/gdict-context.xml"/>
+
+ </chapter>
+
+ <chapter id="context-types">
+ <title>Context Implementations</title>
+
+ <para>The only context implementation currently available is a client
+ for the Dictionary Protocol.</para>
+
+ <xi:include href="xml/gdict-client-context.xml"/>
+
+ </chapter>
+
+ <chapter id="sources">
+ <title>Dictionary Source</title>
+
+ <para>A dictionary source is repesented using a specially crafted file,
+ and can be accessed using the GdictSource class.</para>
+
+ <para>Dictionary sources can be created at runtime or stored inside a
+ file and loaded directly using its path. Usually, sources files are
+ stored inside a predefined path and loaded using the GdictSourceLoader
+ class.</para>
+
+ <xi:include href="xml/gdict-source.xml"/>
+ <xi:include href="xml/gdict-source-loader.xml"/>
+
+ </chapter>
+
+ <chapter id="gdict-utils">
+ <title>Gdict Utilities</title>
+
+ <xi:include href="xml/gdict-utils.xml"/>
+ <xi:include href="xml/gdict-version.xml"/>
+
+ </chapter>
+
+ </part>
+
+ <part id="gdictui">
+ <title>The MATE Dictionary Library Widgets</title>
+
+ <partintro>
+
+ <para>
+ Apart from the low-level classes, the MATE Dictionary library
+ offers a set of widgets for accessing the dictionary sources and showing
+ the results of queries.
+ </para>
+
+ </partintro>
+
+ <chapter>
+ <title>Base widgets</title>
+
+ <xi:include href="xml/gdict-defbox.xml"/>
+ <xi:include href="xml/gdict-speller.xml"/>
+ </chapter>
+
+ <chapter>
+ <title>Advanced widgets</title>
+
+ <xi:include href="xml/gdict-database-chooser.xml"/>
+ <xi:include href="xml/gdict-strategy-chooser.xml"/>
+ <xi:include href="xml/gdict-source-chooser.xml"/>
+ </chapter>
+
+ </part>
+
+ <index>
+ <title>Index</title>
+ </index>
+ <index role="deprecated">
+ <title>Index of deprecated symbols</title>
+ </index>
+ <index role="0.10">
+ <title>Index of new symbols in 0.10</title>
+ </index>
+ <index role="0.12">
+ <title>Index of new symbols in 0.12</title>
+ </index>
+
+</book>
diff --git a/mate-dictionary/docs/reference/gdict/gdict-overrides.txt b/mate-dictionary/docs/reference/gdict/gdict-overrides.txt
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/gdict-overrides.txt
diff --git a/mate-dictionary/docs/reference/gdict/gdict-sections.txt b/mate-dictionary/docs/reference/gdict/gdict-sections.txt
new file mode 100644
index 00000000..51adbf41
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/gdict-sections.txt
@@ -0,0 +1,336 @@
+<SECTION>
+<FILE>gdict-client-context</FILE>
+<TITLE>GdictClientContext</TITLE>
+GdictClientContext
+GdictClientContextClass
+GdictClientContextError
+gdict_client_context_new
+gdict_client_context_set_hostname
+gdict_client_context_get_hostname
+gdict_client_context_set_port
+gdict_client_context_get_port
+gdict_client_context_set_client
+gdict_client_context_get_client
+<SUBSECTION Standard>
+GdictContext
+GDICT_CLIENT_CONTEXT
+GDICT_IS_CLIENT_CONTEXT
+GDICT_TYPE_CLIENT_CONTEXT
+gdict_client_context_get_type
+GDICT_CLIENT_CONTEXT_CLASS
+GDICT_CLIENT_CONTEXT_GET_CLASS
+GDICT_CLIENT_CONTEXT_ERROR
+gdict_client_context_error_quark
+<SUBSECTION Private>
+GdictClientContextPrivate
+</SECTION>
+
+<SECTION>
+<FILE>gdict-context</FILE>
+<TITLE>GdictContext</TITLE>
+GdictContextIface
+GdictContextError
+gdict_context_set_local_only
+gdict_context_get_local_only
+gdict_context_lookup_databases
+gdict_context_lookup_strategies
+gdict_context_match_word
+gdict_context_define_word
+<SUBSECTION>
+GdictDatabase
+gdict_database_ref
+gdict_database_unref
+gdict_database_get_name
+gdict_database_get_full_name
+<SUBSECTION>
+GdictStrategy
+gdict_strategy_ref
+gdict_strategy_unref
+gdict_strategy_get_name
+gdict_strategy_get_description
+<SUBSECTION>
+GdictMatch
+gdict_match_ref
+gdict_match_unref
+gdict_match_get_word
+gdict_match_get_database
+<SUBSECTION>
+GdictDefinition
+gdict_definition_ref
+gdict_definition_unref
+gdict_definition_get_total
+gdict_definition_get_word
+gdict_definition_get_database
+gdict_definition_get_text
+<SUBSECTION Standard>
+GDICT_TYPE_DATABASE
+GDICT_TYPE_STRATEGY
+GDICT_TYPE_MATCH
+GDICT_TYPE_DEFINITION
+GDICT_CONTEXT
+GDICT_IS_CONTEXT
+GDICT_TYPE_CONTEXT
+gdict_context_get_type
+gdict_database_get_type
+gdict_definition_get_type
+gdict_match_get_type
+gdict_strategy_get_type
+GDICT_CONTEXT_GET_IFACE
+GDICT_CONTEXT_ERROR
+gdict_context_error_quark
+</SECTION>
+
+<SECTION>
+<FILE>gdict-database-chooser</FILE>
+<TITLE>GdictDatabaseChooser</TITLE>
+GdictDatabaseChooser
+GdictDatabaseChooserClass
+gdict_database_chooser_new
+gdict_database_chooser_new_with_context
+gdict_database_chooser_get_context
+gdict_database_chooser_set_context
+gdict_database_chooser_get_databases
+gdict_database_chooser_count_databases
+gdict_database_chooser_has_database
+gdict_database_chooser_refresh
+gdict_database_chooser_clear
+gdict_database_chooser_add_button
+gdict_database_chooser_get_current_database
+gdict_database_chooser_select_database
+gdict_database_chooser_set_current_database
+gdict_database_chooser_unselect_database
+<SUBSECTION Standard>
+GDICT_DATABASE_CHOOSER
+GDICT_IS_DATABASE_CHOOSER
+GDICT_TYPE_DATABASE_CHOOSER
+gdict_database_chooser_get_type
+GDICT_DATABASE_CHOOSER_CLASS
+GDICT_IS_DATABASE_CHOOSER_CLASS
+GDICT_DATABASE_CHOOSER_GET_CLASS
+<SUBSECTION Private>
+GdictDatabaseChooserPrivate
+</SECTION>
+
+<SECTION>
+<FILE>gdict-defbox</FILE>
+<TITLE>GdictDefbox</TITLE>
+GdictDefbox
+GdictDefboxClass
+gdict_defbox_new
+gdict_defbox_new_with_context
+gdict_defbox_set_context
+gdict_defbox_get_context
+gdict_defbox_set_database
+gdict_defbox_get_database
+gdict_defbox_get_text
+gdict_defbox_select_all
+gdict_defbox_copy_to_clipboard
+gdict_defbox_clear
+gdict_defbox_lookup
+gdict_defbox_get_word
+gdict_defbox_count_definitions
+gdict_defbox_jump_to_definition
+gdict_defbox_set_show_find
+gdict_defbox_get_show_find
+gdict_defbox_find_next
+gdict_defbox_find_previous
+gdict_defbox_set_font_name
+gdict_defbox_get_font_name
+gdict_defbox_get_selected_word
+<SUBSECTION Standard>
+GDICT_DEFBOX
+GDICT_IS_DEFBOX
+GDICT_TYPE_DEFBOX
+gdict_defbox_get_type
+GDICT_DEFBOX_CLASS
+GDICT_IS_DEFBOX_CLASS
+GDICT_DEFBOX_GET_CLASS
+<SUBSECTION Private>
+GdictDefboxPrivate
+</SECTION>
+
+<SECTION>
+<FILE>gdict-source-loader</FILE>
+<TITLE>GdictSourceLoader</TITLE>
+GdictSourceLoader
+GdictSourceLoaderClass
+gdict_source_loader_new
+gdict_source_loader_update
+gdict_source_loader_add_search_path
+gdict_source_loader_get_paths
+gdict_source_loader_get_names
+gdict_source_loader_get_sources
+gdict_source_loader_get_source
+gdict_source_loader_remove_source
+gdict_source_loader_has_source
+<SUBSECTION Standard>
+GDICT_SOURCE_LOADER
+GDICT_IS_SOURCE_LOADER
+GDICT_TYPE_SOURCE_LOADER
+gdict_source_loader_get_type
+GDICT_SOURCE_LOADER_CLASS
+GDICT_IS_SOURCE_LOADER_CLASS
+GDICT_SOURCE_LOADER_GET_CLASS
+<SUBSECTION Private>
+GdictSourceLoaderPrivate
+</SECTION>
+
+<SECTION>
+<FILE>gdict-source</FILE>
+<TITLE>GdictSource</TITLE>
+GdictSourceError
+GdictSource
+GdictSourceClass
+gdict_source_new
+gdict_source_load_from_file
+gdict_source_load_from_data
+gdict_source_to_data
+gdict_source_set_name
+gdict_source_get_name
+gdict_source_set_description
+gdict_source_get_description
+gdict_source_set_database
+gdict_source_get_database
+gdict_source_set_strategy
+gdict_source_get_strategy
+GdictSourceTransport
+gdict_source_set_transport
+gdict_source_set_transportv
+gdict_source_get_transport
+gdict_source_get_context
+gdict_source_peek_context
+<SUBSECTION Standard>
+GDICT_SOURCE
+GDICT_IS_SOURCE
+GDICT_TYPE_SOURCE
+gdict_source_get_type
+GDICT_SOURCE_CLASS
+GDICT_IS_SOURCE_CLASS
+GDICT_SOURCE_GET_CLASS
+GDICT_SOURCE_ERROR
+gdict_source_error_quark
+<SUBSECTION Private>
+GdictSourcePrivate
+</SECTION>
+
+<SECTION>
+<FILE>gdict-speller</FILE>
+<TITLE>GdictSpeller</TITLE>
+GdictSpeller
+GdictSpellerClass
+gdict_speller_new
+gdict_speller_new_with_context
+gdict_speller_set_context
+gdict_speller_get_context
+gdict_speller_set_database
+gdict_speller_get_database
+gdict_speller_set_strategy
+gdict_speller_get_strategy
+gdict_speller_clear
+gdict_speller_match
+gdict_speller_count_matches
+gdict_speller_get_matches
+<SUBSECTION Standard>
+GDICT_SPELLER
+GDICT_IS_SPELLER
+GDICT_TYPE_SPELLER
+gdict_speller_get_type
+GDICT_SPELLER_CLASS
+GDICT_IS_SPELLER_CLASS
+GDICT_SPELLER_GET_CLASS
+<SUBSECTION Private>
+GdictSpellerPrivate
+</SECTION>
+
+<SECTION>
+<FILE>gdict-strategy-chooser</FILE>
+<TITLE>GdictStrategyChooser</TITLE>
+GdictStrategyChooser
+GdictStrategyChooserClass
+gdict_strategy_chooser_new
+gdict_strategy_chooser_new_with_context
+gdict_strategy_chooser_get_context
+gdict_strategy_chooser_set_context
+gdict_strategy_chooser_get_strategies
+gdict_strategy_chooser_has_strategy
+gdict_strategy_chooser_add_button
+gdict_strategy_chooser_clear
+gdict_strategy_chooser_count_strategies
+gdict_strategy_chooser_get_current_strategy
+gdict_strategy_chooser_refresh
+gdict_strategy_chooser_select_strategy
+gdict_strategy_chooser_set_current_strategy
+gdict_strategy_chooser_unselect_strategy
+<SUBSECTION Standard>
+GDICT_STRATEGY_CHOOSER
+GDICT_IS_STRATEGY_CHOOSER
+GDICT_TYPE_STRATEGY_CHOOSER
+gdict_strategy_chooser_get_type
+GDICT_STRATEGY_CHOOSER_CLASS
+GDICT_IS_STRATEGY_CHOOSER_CLASS
+GDICT_STRATEGY_CHOOSER_GET_CLASS
+<SUBSECTION Private>
+GdictStrategyChooserPrivate
+</SECTION>
+
+<SECTION>
+<FILE>gdict-source-chooser</FILE>
+<TITLE>GdictSourceChooser</TITLE>
+GdictSourceChooser
+GdictSourceChooserClass
+gdict_source_chooser_new
+gdict_source_chooser_new_with_loader
+gdict_source_chooser_get_loader
+gdict_source_chooser_set_loader
+gdict_source_chooser_get_sources
+gdict_source_chooser_count_sources
+gdict_source_chooser_has_source
+gdict_source_chooser_refresh
+gdict_source_chooser_select_source
+gdict_source_chooser_unselect_source
+gdict_source_chooser_get_current_source
+gdict_source_chooser_set_current_source
+gdict_source_chooser_add_button
+<SUBSECTION Standard>
+GDICT_SOURCE_CHOOSER
+GDICT_SOURCE_CHOOSER_CLASS
+GDICT_SOURCE_CHOOSER_GET_CLASS
+GDICT_TYPE_SOURCE_CHOOSER
+GDICT_IS_SOURCE_CHOOSER
+GDICT_IS_SOURCE_CHOOSER_CLASS
+gdict_source_chooser_get_type
+<SUBSECTION Private>
+GdictSourceChooserPrivate
+</SECTION>
+
+<SECTION>
+<FILE>gdict-utils</FILE>
+<TITLE>Gdict Utilities</TITLE>
+GDICT_DEFAULT_DATABASE
+GDICT_DEFAULT_STRATEGY
+GDICT_DEFAULT_FONT_NAME
+GdictContextProp
+GdictStatusCode
+gdict_debug_init
+gdict_get_option_group
+<SUBSECTION Standard>
+GDICT_IS_VALID_STATUS_CODE
+</SECTION>
+
+<SECTION>
+<FILE>gdict-version</FILE>
+<TITLE>Gdict Version Checking</TITLE>
+GDICT_MAJOR_VERSION
+GDICT_MINOR_VERSION
+GDICT_MICRO_VERSION
+GDICT_VERSION
+GDICT_VERSION_S
+GDICT_VERSION_HEX
+GDICT_CHECK_VERSION
+<SUBSECTION>
+gdict_major
+gdict_minor
+gdict_micro
+gdict_check_version
+</SECTION>
+
diff --git a/mate-dictionary/docs/reference/gdict/gdict.types b/mate-dictionary/docs/reference/gdict/gdict.types
new file mode 100644
index 00000000..aa5a3f92
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/gdict.types
@@ -0,0 +1,9 @@
+gdict_client_context_get_type
+gdict_context_get_type
+gdict_database_chooser_get_type
+gdict_defbox_get_type
+gdict_source_get_type
+gdict_source_chooser_get_type
+gdict_source_loader_get_type
+gdict_speller_get_type
+gdict_strategy_chooser_get_type
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-client-context.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-client-context.sgml
new file mode 100644
index 00000000..bc5ac1dd
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-client-context.sgml
@@ -0,0 +1,146 @@
+<!-- ##### SECTION Title ##### -->
+GdictClientContext
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### STRUCT GdictClientContext ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GdictClientContext::connected ##### -->
+<para>
+
+</para>
+
+@gdictclientcontext: the object which received the signal.
+
+<!-- ##### SIGNAL GdictClientContext::disconnected ##### -->
+<para>
+
+</para>
+
+@gdictclientcontext: the object which received the signal.
+
+<!-- ##### ARG GdictClientContext:client-name ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictClientContext:hostname ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictClientContext:port ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictClientContext:status ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GdictClientContextClass ##### -->
+<para>
+
+</para>
+
+@connected:
+@disconnected:
+
+<!-- ##### ENUM GdictClientContextError ##### -->
+<para>
+
+</para>
+
+@GDICT_CLIENT_CONTEXT_ERROR_SOCKET:
+@GDICT_CLIENT_CONTEXT_ERROR_LOOKUP:
+@GDICT_CLIENT_CONTEXT_ERROR_NO_CONNECTION:
+@GDICT_CLIENT_CONTEXT_ERROR_SERVER_DOWN:
+
+<!-- ##### FUNCTION gdict_client_context_new ##### -->
+<para>
+
+</para>
+
+@hostname:
+@port:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_client_context_set_hostname ##### -->
+<para>
+
+</para>
+
+@context:
+@hostname:
+
+
+<!-- ##### FUNCTION gdict_client_context_get_hostname ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_client_context_set_port ##### -->
+<para>
+
+</para>
+
+@context:
+@port:
+
+
+<!-- ##### FUNCTION gdict_client_context_get_port ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_client_context_set_client ##### -->
+<para>
+
+</para>
+
+@context:
+@client:
+
+
+<!-- ##### FUNCTION gdict_client_context_get_client ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-context.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-context.sgml
new file mode 100644
index 00000000..67fe6dee
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-context.sgml
@@ -0,0 +1,300 @@
+<!-- ##### SECTION Title ##### -->
+GdictContext
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### STRUCT GdictContextIface ##### -->
+<para>
+
+</para>
+
+@get_databases:
+@get_strategies:
+@match_word:
+@define_word:
+@lookup_start:
+@lookup_end:
+@database_found:
+@strategy_found:
+@match_found:
+@definition_found:
+@error:
+
+<!-- ##### ENUM GdictContextError ##### -->
+<para>
+
+</para>
+
+@GDICT_CONTEXT_ERROR_PARSE:
+@GDICT_CONTEXT_ERROR_NOT_IMPLEMENTED:
+@GDICT_CONTEXT_ERROR_INVALID_DATABASE:
+@GDICT_CONTEXT_ERROR_INVALID_STRATEGY:
+@GDICT_CONTEXT_ERROR_INVALID_COMMAND:
+@GDICT_CONTEXT_ERROR_NO_MATCH:
+@GDICT_CONTEXT_ERROR_NO_DATABASES:
+@GDICT_CONTEXT_ERROR_NO_STRATEGIES:
+
+<!-- ##### FUNCTION gdict_context_set_local_only ##### -->
+<para>
+
+</para>
+
+@context:
+@local_only:
+
+
+<!-- ##### FUNCTION gdict_context_get_local_only ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_context_lookup_databases ##### -->
+<para>
+
+</para>
+
+@context:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_context_lookup_strategies ##### -->
+<para>
+
+</para>
+
+@context:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_context_match_word ##### -->
+<para>
+
+</para>
+
+@context:
+@database:
+@strategy:
+@word:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_context_define_word ##### -->
+<para>
+
+</para>
+
+@context:
+@database:
+@word:
+@error:
+@Returns:
+
+
+<!-- ##### STRUCT GdictDatabase ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gdict_database_ref ##### -->
+<para>
+
+</para>
+
+@db:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_unref ##### -->
+<para>
+
+</para>
+
+@db:
+
+
+<!-- ##### FUNCTION gdict_database_get_name ##### -->
+<para>
+
+</para>
+
+@db:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_get_full_name ##### -->
+<para>
+
+</para>
+
+@db:
+@Returns:
+
+
+<!-- ##### STRUCT GdictStrategy ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gdict_strategy_ref ##### -->
+<para>
+
+</para>
+
+@strat:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_unref ##### -->
+<para>
+
+</para>
+
+@strat:
+
+
+<!-- ##### FUNCTION gdict_strategy_get_name ##### -->
+<para>
+
+</para>
+
+@strat:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_get_description ##### -->
+<para>
+
+</para>
+
+@strat:
+@Returns:
+
+
+<!-- ##### STRUCT GdictMatch ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gdict_match_ref ##### -->
+<para>
+
+</para>
+
+@match:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_match_unref ##### -->
+<para>
+
+</para>
+
+@match:
+
+
+<!-- ##### FUNCTION gdict_match_get_word ##### -->
+<para>
+
+</para>
+
+@match:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_match_get_database ##### -->
+<para>
+
+</para>
+
+@match:
+@Returns:
+
+
+<!-- ##### STRUCT GdictDefinition ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gdict_definition_ref ##### -->
+<para>
+
+</para>
+
+@def:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_definition_unref ##### -->
+<para>
+
+</para>
+
+@def:
+
+
+<!-- ##### FUNCTION gdict_definition_get_total ##### -->
+<para>
+
+</para>
+
+@def:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_definition_get_word ##### -->
+<para>
+
+</para>
+
+@def:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_definition_get_database ##### -->
+<para>
+
+</para>
+
+@def:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_definition_get_text ##### -->
+<para>
+
+</para>
+
+@def:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-database-chooser.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-database-chooser.sgml
new file mode 100644
index 00000000..ad828acc
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-database-chooser.sgml
@@ -0,0 +1,194 @@
+<!-- ##### SECTION Title ##### -->
+GdictDatabaseChooser
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### STRUCT GdictDatabaseChooser ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GdictDatabaseChooser::database-activated ##### -->
+<para>
+
+</para>
+
+@gdictdatabasechooser: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### SIGNAL GdictDatabaseChooser::selection-changed ##### -->
+<para>
+
+</para>
+
+@gdictdatabasechooser: the object which received the signal.
+
+<!-- ##### ARG GdictDatabaseChooser:context ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictDatabaseChooser:count ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GdictDatabaseChooserClass ##### -->
+<para>
+
+</para>
+
+@database_activated:
+@selection_changed:
+
+<!-- ##### FUNCTION gdict_database_chooser_new ##### -->
+<para>
+
+</para>
+
+@void:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_new_with_context ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_get_context ##### -->
+<para>
+
+</para>
+
+@chooser:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_set_context ##### -->
+<para>
+
+</para>
+
+@chooser:
+@context:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_get_databases ##### -->
+<para>
+
+</para>
+
+@chooser:
+@length:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_count_databases ##### -->
+<para>
+
+</para>
+
+@chooser:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_has_database ##### -->
+<para>
+
+</para>
+
+@chooser:
+@database:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_refresh ##### -->
+<para>
+
+</para>
+
+@chooser:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_clear ##### -->
+<para>
+
+</para>
+
+@chooser:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_add_button ##### -->
+<para>
+
+</para>
+
+@chooser:
+@button_text:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_get_current_database ##### -->
+<para>
+
+</para>
+
+@chooser:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_select_database ##### -->
+<para>
+
+</para>
+
+@chooser:
+@db_name:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_set_current_database ##### -->
+<para>
+
+</para>
+
+@chooser:
+@db_name:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_database_chooser_unselect_database ##### -->
+<para>
+
+</para>
+
+@chooser:
+@db_name:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-defbox.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-defbox.sgml
new file mode 100644
index 00000000..5ca025f2
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-defbox.sgml
@@ -0,0 +1,288 @@
+<!-- ##### SECTION Title ##### -->
+GdictDefbox
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### STRUCT GdictDefbox ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GdictDefbox::find-next ##### -->
+<para>
+
+</para>
+
+@gdictdefbox: the object which received the signal.
+
+<!-- ##### SIGNAL GdictDefbox::find-previous ##### -->
+<para>
+
+</para>
+
+@gdictdefbox: the object which received the signal.
+
+<!-- ##### SIGNAL GdictDefbox::hide-find ##### -->
+<para>
+
+</para>
+
+@gdictdefbox: the object which received the signal.
+
+<!-- ##### SIGNAL GdictDefbox::link-clicked ##### -->
+<para>
+
+</para>
+
+@gdictdefbox: the object which received the signal.
+@arg1:
+
+<!-- ##### SIGNAL GdictDefbox::show-find ##### -->
+<para>
+
+</para>
+
+@gdictdefbox: the object which received the signal.
+
+<!-- ##### ARG GdictDefbox:context ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictDefbox:database ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictDefbox:font-name ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictDefbox:word ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GdictDefboxClass ##### -->
+<para>
+
+</para>
+
+@parent_class:
+@show_find:
+@hide_find:
+@find_previous:
+@find_next:
+@link_clicked:
+@_gdict_defbox_1:
+@_gdict_defbox_2:
+@_gdict_defbox_3:
+@_gdict_defbox_4:
+
+<!-- ##### FUNCTION gdict_defbox_new ##### -->
+<para>
+
+</para>
+
+@void:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_defbox_new_with_context ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_defbox_set_context ##### -->
+<para>
+
+</para>
+
+@defbox:
+@context:
+
+
+<!-- ##### FUNCTION gdict_defbox_get_context ##### -->
+<para>
+
+</para>
+
+@defbox:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_defbox_set_database ##### -->
+<para>
+
+</para>
+
+@defbox:
+@database:
+
+
+<!-- ##### FUNCTION gdict_defbox_get_database ##### -->
+<para>
+
+</para>
+
+@defbox:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_defbox_get_text ##### -->
+<para>
+
+</para>
+
+@defbox:
+@length:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_defbox_select_all ##### -->
+<para>
+
+</para>
+
+@defbox:
+
+
+<!-- ##### FUNCTION gdict_defbox_copy_to_clipboard ##### -->
+<para>
+
+</para>
+
+@defbox:
+@clipboard:
+
+
+<!-- ##### FUNCTION gdict_defbox_clear ##### -->
+<para>
+
+</para>
+
+@defbox:
+
+
+<!-- ##### FUNCTION gdict_defbox_lookup ##### -->
+<para>
+
+</para>
+
+@defbox:
+@word:
+
+
+<!-- ##### FUNCTION gdict_defbox_get_word ##### -->
+<para>
+
+</para>
+
+@defbox:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_defbox_count_definitions ##### -->
+<para>
+
+</para>
+
+@defbox:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_defbox_jump_to_definition ##### -->
+<para>
+
+</para>
+
+@defbox:
+@number:
+
+
+<!-- ##### FUNCTION gdict_defbox_set_show_find ##### -->
+<para>
+
+</para>
+
+@defbox:
+@show_find:
+
+
+<!-- ##### FUNCTION gdict_defbox_get_show_find ##### -->
+<para>
+
+</para>
+
+@defbox:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_defbox_find_next ##### -->
+<para>
+
+</para>
+
+@defbox:
+
+
+<!-- ##### FUNCTION gdict_defbox_find_previous ##### -->
+<para>
+
+</para>
+
+@defbox:
+
+
+<!-- ##### FUNCTION gdict_defbox_set_font_name ##### -->
+<para>
+
+</para>
+
+@defbox:
+@font_name:
+
+
+<!-- ##### FUNCTION gdict_defbox_get_font_name ##### -->
+<para>
+
+</para>
+
+@defbox:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_defbox_get_selected_word ##### -->
+<para>
+
+</para>
+
+@defbox:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-source-chooser.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-source-chooser.sgml
new file mode 100644
index 00000000..baafc187
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-source-chooser.sgml
@@ -0,0 +1,186 @@
+<!-- ##### SECTION Title ##### -->
+GdictSourceChooser
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### STRUCT GdictSourceChooser ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GdictSourceChooser::selection-changed ##### -->
+<para>
+
+</para>
+
+@gdictsourcechooser: the object which received the signal.
+
+<!-- ##### SIGNAL GdictSourceChooser::source-activated ##### -->
+<para>
+
+</para>
+
+@gdictsourcechooser: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### ARG GdictSourceChooser:count ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictSourceChooser:loader ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GdictSourceChooserClass ##### -->
+<para>
+
+</para>
+
+@source_activated:
+@selection_changed:
+
+<!-- ##### FUNCTION gdict_source_chooser_new ##### -->
+<para>
+
+</para>
+
+@void:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_new_with_loader ##### -->
+<para>
+
+</para>
+
+@loader:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_get_loader ##### -->
+<para>
+
+</para>
+
+@chooser:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_set_loader ##### -->
+<para>
+
+</para>
+
+@chooser:
+@loader:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_get_sources ##### -->
+<para>
+
+</para>
+
+@chooser:
+@length:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_count_sources ##### -->
+<para>
+
+</para>
+
+@chooser:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_has_source ##### -->
+<para>
+
+</para>
+
+@chooser:
+@source_name:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_refresh ##### -->
+<para>
+
+</para>
+
+@chooser:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_select_source ##### -->
+<para>
+
+</para>
+
+@chooser:
+@source_name:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_unselect_source ##### -->
+<para>
+
+</para>
+
+@chooser:
+@source_name:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_get_current_source ##### -->
+<para>
+
+</para>
+
+@chooser:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_set_current_source ##### -->
+<para>
+
+</para>
+
+@chooser:
+@source_name:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_chooser_add_button ##### -->
+<para>
+
+</para>
+
+@chooser:
+@button_text:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-source-loader.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-source-loader.sgml
new file mode 100644
index 00000000..f9f2349b
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-source-loader.sgml
@@ -0,0 +1,144 @@
+<!-- ##### SECTION Title ##### -->
+GdictSourceLoader
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### STRUCT GdictSourceLoader ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GdictSourceLoader::source-loaded ##### -->
+<para>
+
+</para>
+
+@gdictsourceloader: the object which received the signal.
+@arg1:
+
+<!-- ##### ARG GdictSourceLoader:paths ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictSourceLoader:sources ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GdictSourceLoaderClass ##### -->
+<para>
+
+</para>
+
+@parent_class:
+@source_loaded:
+@_gdict_source_1:
+@_gdict_source_2:
+@_gdict_source_3:
+@_gdict_source_4:
+
+<!-- ##### FUNCTION gdict_source_loader_new ##### -->
+<para>
+
+</para>
+
+@void:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_loader_update ##### -->
+<para>
+
+</para>
+
+@loader:
+
+
+<!-- ##### FUNCTION gdict_source_loader_add_search_path ##### -->
+<para>
+
+</para>
+
+@loader:
+@path:
+
+
+<!-- ##### FUNCTION gdict_source_loader_get_paths ##### -->
+<para>
+
+</para>
+
+@loader:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_loader_get_names ##### -->
+<para>
+
+</para>
+
+@loader:
+@length:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_loader_get_sources ##### -->
+<para>
+
+</para>
+
+@loader:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_loader_get_source ##### -->
+<para>
+
+</para>
+
+@loader:
+@name:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_loader_remove_source ##### -->
+<para>
+
+</para>
+
+@loader:
+@name:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_loader_has_source ##### -->
+<para>
+
+</para>
+
+@loader:
+@source_name:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-source.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-source.sgml
new file mode 100644
index 00000000..f0117047
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-source.sgml
@@ -0,0 +1,253 @@
+<!-- ##### SECTION Title ##### -->
+GdictSource
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### ENUM GdictSourceError ##### -->
+<para>
+
+</para>
+
+@GDICT_SOURCE_ERROR_PARSE:
+@GDICT_SOURCE_ERROR_INVALID_NAME:
+@GDICT_SOURCE_ERROR_INVALID_TRANSPORT:
+@GDICT_SOURCE_ERROR_INVALID_BAD_PARAMETER:
+
+<!-- ##### STRUCT GdictSource ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### ARG GdictSource:context ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictSource:database ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictSource:description ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictSource:filename ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictSource:name ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictSource:strategy ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictSource:transport ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GdictSourceClass ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gdict_source_new ##### -->
+<para>
+
+</para>
+
+@void:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_load_from_file ##### -->
+<para>
+
+</para>
+
+@source:
+@filename:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_load_from_data ##### -->
+<para>
+
+</para>
+
+@source:
+@data:
+@length:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_to_data ##### -->
+<para>
+
+</para>
+
+@source:
+@length:
+@error:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_set_name ##### -->
+<para>
+
+</para>
+
+@source:
+@name:
+
+
+<!-- ##### FUNCTION gdict_source_get_name ##### -->
+<para>
+
+</para>
+
+@source:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_set_description ##### -->
+<para>
+
+</para>
+
+@source:
+@description:
+
+
+<!-- ##### FUNCTION gdict_source_get_description ##### -->
+<para>
+
+</para>
+
+@source:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_set_database ##### -->
+<para>
+
+</para>
+
+@source:
+@database:
+
+
+<!-- ##### FUNCTION gdict_source_get_database ##### -->
+<para>
+
+</para>
+
+@source:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_set_strategy ##### -->
+<para>
+
+</para>
+
+@source:
+@strategy:
+
+
+<!-- ##### FUNCTION gdict_source_get_strategy ##### -->
+<para>
+
+</para>
+
+@source:
+@Returns:
+
+
+<!-- ##### ENUM GdictSourceTransport ##### -->
+<para>
+
+</para>
+
+@GDICT_SOURCE_TRANSPORT_DICTD:
+@GDICT_SOURCE_TRANSPORT_INVALID:
+
+<!-- ##### FUNCTION gdict_source_set_transport ##### -->
+<para>
+
+</para>
+
+@source:
+@transport:
+@first_transport_property:
+@Varargs:
+
+
+<!-- ##### FUNCTION gdict_source_set_transportv ##### -->
+<para>
+
+</para>
+
+@source:
+@transport:
+@first_transport_property:
+@var_args:
+
+
+<!-- ##### FUNCTION gdict_source_get_transport ##### -->
+<para>
+
+</para>
+
+@source:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_get_context ##### -->
+<para>
+
+</para>
+
+@source:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_source_peek_context ##### -->
+<para>
+
+</para>
+
+@source:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-speller.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-speller.sgml
new file mode 100644
index 00000000..98c06fbe
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-speller.sgml
@@ -0,0 +1,174 @@
+<!-- ##### SECTION Title ##### -->
+GdictSpeller
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### STRUCT GdictSpeller ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GdictSpeller::word-activated ##### -->
+<para>
+
+</para>
+
+@gdictspeller: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### ARG GdictSpeller:context ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictSpeller:database ##### -->
+<para>
+
+</para>
+
+<!-- ##### ARG GdictSpeller:strategy ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GdictSpellerClass ##### -->
+<para>
+
+</para>
+
+@parent_class:
+@word_activated:
+@_gdict_speller_1:
+@_gdict_speller_2:
+@_gdict_speller_3:
+@_gdict_speller_4:
+
+<!-- ##### FUNCTION gdict_speller_new ##### -->
+<para>
+
+</para>
+
+@void:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_speller_new_with_context ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_speller_set_context ##### -->
+<para>
+
+</para>
+
+@speller:
+@context:
+
+
+<!-- ##### FUNCTION gdict_speller_get_context ##### -->
+<para>
+
+</para>
+
+@speller:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_speller_set_database ##### -->
+<para>
+
+</para>
+
+@speller:
+@database:
+
+
+<!-- ##### FUNCTION gdict_speller_get_database ##### -->
+<para>
+
+</para>
+
+@speller:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_speller_set_strategy ##### -->
+<para>
+
+</para>
+
+@speller:
+@strategy:
+
+
+<!-- ##### FUNCTION gdict_speller_get_strategy ##### -->
+<para>
+
+</para>
+
+@speller:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_speller_clear ##### -->
+<para>
+
+</para>
+
+@speller:
+
+
+<!-- ##### FUNCTION gdict_speller_match ##### -->
+<para>
+
+</para>
+
+@speller:
+@word:
+
+
+<!-- ##### FUNCTION gdict_speller_count_matches ##### -->
+<para>
+
+</para>
+
+@speller:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_speller_get_matches ##### -->
+<para>
+
+</para>
+
+@speller:
+@length:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-strategy-chooser.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-strategy-chooser.sgml
new file mode 100644
index 00000000..f909feed
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-strategy-chooser.sgml
@@ -0,0 +1,188 @@
+<!-- ##### SECTION Title ##### -->
+GdictStrategyChooser
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### STRUCT GdictStrategyChooser ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SIGNAL GdictStrategyChooser::strategy-activated ##### -->
+<para>
+
+</para>
+
+@gdictstrategychooser: the object which received the signal.
+@arg1:
+@arg2:
+
+<!-- ##### ARG GdictStrategyChooser:context ##### -->
+<para>
+
+</para>
+
+<!-- ##### STRUCT GdictStrategyChooserClass ##### -->
+<para>
+
+</para>
+
+@parent_class:
+@strategy_activated:
+@_gdict_padding1:
+@_gdict_padding2:
+@_gdict_padding3:
+@_gdict_padding4:
+@_gdict_padding5:
+@_gdict_padding6:
+
+<!-- ##### FUNCTION gdict_strategy_chooser_new ##### -->
+<para>
+
+</para>
+
+@void:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_new_with_context ##### -->
+<para>
+
+</para>
+
+@context:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_get_context ##### -->
+<para>
+
+</para>
+
+@chooser:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_set_context ##### -->
+<para>
+
+</para>
+
+@chooser:
+@context:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_get_strategies ##### -->
+<para>
+
+</para>
+
+@chooser:
+@length:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_has_strategy ##### -->
+<para>
+
+</para>
+
+@chooser:
+@strategy:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_add_button ##### -->
+<para>
+
+</para>
+
+@chooser:
+@button_text:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_clear ##### -->
+<para>
+
+</para>
+
+@chooser:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_count_strategies ##### -->
+<para>
+
+</para>
+
+@chooser:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_get_current_strategy ##### -->
+<para>
+
+</para>
+
+@chooser:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_refresh ##### -->
+<para>
+
+</para>
+
+@chooser:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_select_strategy ##### -->
+<para>
+
+</para>
+
+@chooser:
+@strat_name:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_set_current_strategy ##### -->
+<para>
+
+</para>
+
+@chooser:
+@strat_name:
+@Returns:
+
+
+<!-- ##### FUNCTION gdict_strategy_chooser_unselect_strategy ##### -->
+<para>
+
+</para>
+
+@chooser:
+@strat_name:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-unused.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-unused.sgml
new file mode 100644
index 00000000..e69de29b
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-unused.sgml
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-utils.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-utils.sgml
new file mode 100644
index 00000000..60582b6e
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-utils.sgml
@@ -0,0 +1,107 @@
+<!-- ##### SECTION Title ##### -->
+Gdict Utilities
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### MACRO GDICT_DEFAULT_DATABASE ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GDICT_DEFAULT_STRATEGY ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GDICT_DEFAULT_FONT_NAME ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### ENUM GdictContextProp ##### -->
+<para>
+
+</para>
+
+@GDICT_CONTEXT_PROP_FIRST:
+@GDICT_CONTEXT_PROP_LOCAL_ONLY:
+@GDICT_CONTEXT_PROP_LAST:
+
+<!-- ##### ENUM GdictStatusCode ##### -->
+<para>
+
+</para>
+
+@GDICT_STATUS_INVALID:
+@GDICT_STATUS_N_DATABASES_PRESENT:
+@GDICT_STATUS_N_STRATEGIES_PRESENT:
+@GDICT_STATUS_DATABASE_INFO:
+@GDICT_STATUS_HELP_TEXT:
+@GDICT_STATUS_SERVER_INFO:
+@GDICT_STATUS_CHALLENGE:
+@GDICT_STATUS_N_DEFINITIONS_RETRIEVED:
+@GDICT_STATUS_WORD_DB_NAME:
+@GDICT_STATUS_N_MATCHES_FOUND:
+@GDICT_STATUS_CONNECT:
+@GDICT_STATUS_QUIT:
+@GDICT_STATUS_AUTH_OK:
+@GDICT_STATUS_OK:
+@GDICT_STATUS_SEND_RESPONSE:
+@GDICT_STATUS_SERVER_DOWN:
+@GDICT_STATUS_SHUTDOWN:
+@GDICT_STATUS_BAD_COMMAND:
+@GDICT_STATUS_BAD_PARAMETERS:
+@GDICT_STATUS_COMMAND_NOT_IMPLEMENTED:
+@GDICT_STATUS_PARAMETER_NOT_IMPLEMENTED:
+@GDICT_STATUS_NO_ACCESS:
+@GDICT_STATUS_USE_SHOW_INFO:
+@GDICT_STATUS_UNKNOWN_MECHANISM:
+@GDICT_STATUS_BAD_DATABASE:
+@GDICT_STATUS_BAD_STRATEGY:
+@GDICT_STATUS_NO_MATCH:
+@GDICT_STATUS_NO_DATABASES_PRESENT:
+@GDICT_STATUS_NO_STRATEGIES_PRESENT:
+
+<!-- ##### FUNCTION gdict_debug_init ##### -->
+<para>
+
+</para>
+
+@argc:
+@argv:
+
+
+<!-- ##### FUNCTION gdict_get_option_group ##### -->
+<para>
+
+</para>
+
+@void:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/tmpl/gdict-version.sgml b/mate-dictionary/docs/reference/gdict/tmpl/gdict-version.sgml
new file mode 100644
index 00000000..8d3cb5ce
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/tmpl/gdict-version.sgml
@@ -0,0 +1,105 @@
+<!-- ##### SECTION Title ##### -->
+Gdict Version Checking
+
+<!-- ##### SECTION Short_Description ##### -->
+
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### MACRO GDICT_MAJOR_VERSION ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GDICT_MINOR_VERSION ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GDICT_MICRO_VERSION ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GDICT_VERSION ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GDICT_VERSION_S ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GDICT_VERSION_HEX ##### -->
+<para>
+
+</para>
+
+
+
+<!-- ##### MACRO GDICT_CHECK_VERSION ##### -->
+<para>
+
+</para>
+
+@major:
+@minor:
+@micro:
+
+
+<!-- ##### VARIABLE gdict_major ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### VARIABLE gdict_minor ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### VARIABLE gdict_micro ##### -->
+<para>
+
+</para>
+
+
+<!-- ##### FUNCTION gdict_check_version ##### -->
+<para>
+
+</para>
+
+@required_major:
+@required_minor:
+@required_micro:
+@Returns:
+
+
diff --git a/mate-dictionary/docs/reference/gdict/version.xml.in b/mate-dictionary/docs/reference/gdict/version.xml.in
new file mode 100644
index 00000000..181a09ca
--- /dev/null
+++ b/mate-dictionary/docs/reference/gdict/version.xml.in
@@ -0,0 +1 @@
+@GDICT_VERSION@
diff --git a/mate-dictionary/docs/source-configuration.txt b/mate-dictionary/docs/source-configuration.txt
new file mode 100644
index 00000000..3b815cae
--- /dev/null
+++ b/mate-dictionary/docs/source-configuration.txt
@@ -0,0 +1,65 @@
+Thoughts on Source Configuration
+================================
+
+Since there has been a request for multiple back-end support inside MATE
+Dictionary, and since Gdict makes the addition of such back-ends a possibility,
+we need a way to configure these back-ends.
+
+My plan is to use .desktop files in a standard location, such as
+/usr/share/mate-dictionary and $HOME/.mate2/mate-dictionary. By dropping a
+correctly-formatted .desktop file inside these locations, you can enable a new
+dictionary source inside MATE Dictionary.
+
+* Syntax
+========
+
+** General keys
+===============
+
+A .desktop file is parsable using the GKeyFile class of GLib. Please remember
+that a .desktop file is case sensitive. A standard .desktop file for
+Dictionary must have the "Dictionary" group; only this group should be parsed,
+and other groups should be ignored.
+
+The mandatory name of the dictionary source is specified by the "Name" key;
+it may be localized.
+
+An optional description of the dictionary source is specified by the
+"Description" key; also this may be localized.
+
+The type of back-end to use is specified by the mandatory "Transport" key; at
+this moment, only the "dictd" value is permitted.
+
+An optional default database to be used with the dictionary source is specified
+by the "Database" key; if no default database is specified, assume the default
+database for the transport.
+
+An option default match strategy to be used with the dictionary source is
+specified by the "Strategy" key; if no default strategy is specified, assume
+the default strategy for the transport.
+
+** Transport-specific keys
+==========================
+
+These are the keys defined for the "dictd" transport:
+
+"Hostname" [mandatory]
+ holds the hostname of the dictionary server to connect to;
+
+"Port" [optional]
+ holds the port of the dictionary server to connect to; if omitted,
+ the default port should be used.
+
+** Example
+==========
+
+Dictionary source for dict.org:
+
+ [Dictionary]
+ _Name: Default
+ _Description: Default dictionary server
+ Transport: dictd
+ Hostname: dict.org
+ Port: 2628
+
+$ Last updated: 2005-12-07 19:00 (+0100) ebassi $