diff options
Diffstat (limited to 'mate-dictionary/docs')
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 $ |