Moved from Mate-Extra repository

1 files changed, 827 insertions, 0 deletions

diff --git a/mate-dictionary/libgdict/gdict-speller.c b/mate-dictionary/libgdict/gdict-speller.c
new file mode 100644
index 00000000..455883a1
--- /dev/null
+++ b/mate-dictionary/libgdict/gdict-speller.c
@@ -0,0 +1,827 @@
+/* gdict-speller.c - display widget for dictionary matches
+ *
+ * Copyright (C) 2006  Emmanuele Bassi <[email protected]>
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ */
+
+/**
+ * SECTION:gdict-speller
+ * @short_description: Display matching words
+ *
+ * #GdictSpeller is a widget showing a list of words returned by a
+ * #GdictContext query, using a specific database and a matching strategy.
+ */
+
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <stdarg.h>
+
+#include <gdk/gdkkeysyms.h>
+#include <gtk/gtk.h>
+#include <glib/gi18n-lib.h>
+
+#include "gdict-speller.h"
+#include "gdict-utils.h"
+#include "gdict-enum-types.h"
+#include "gdict-marshal.h"
+#include "gdict-debug.h"
+#include "gdict-private.h"
+
+#define GDICT_SPELLER_GET_PRIVATE(obj) \
+(G_TYPE_INSTANCE_GET_PRIVATE ((obj), GDICT_TYPE_SPELLER, GdictSpellerPrivate))
+
+struct _GdictSpellerPrivate
+{
+  GdictContext *context;
+  gchar *database;
+  gchar *strategy;
+
+  gchar *word;
+
+  GtkWidget *treeview;
+  GtkWidget *clear_button;
+
+  GdkCursor *busy_cursor;
+
+  GtkListStore *store;
+  gint results;
+
+  guint start_id;
+  guint end_id;
+  guint match_id;
+  guint error_id;
+
+  guint is_searching : 1;
+};
+
+typedef enum
+{
+  MATCH_DB,
+  MATCH_WORD,
+  MATCH_ERROR
+} MatchType;
+
+enum
+{
+  MATCH_COLUMN_TYPE,
+  MATCH_COLUMN_DB_NAME,
+  MATCH_COLUMN_WORD,
+
+  MATCH_N_COLUMNS
+};
+
+enum
+{
+  PROP_0,
+
+  PROP_CONTEXT,
+  PROP_WORD,
+  PROP_DATABASE,
+  PROP_STRATEGY,
+  PROP_COUNT
+};
+
+enum
+{
+  WORD_ACTIVATED,
+
+  LAST_SIGNAL
+};
+
+static guint speller_signals[LAST_SIGNAL] = { 0 };
+
+G_DEFINE_TYPE (GdictSpeller, gdict_speller, GTK_TYPE_VBOX);
+
+
+static void
+set_gdict_context (GdictSpeller *speller,
+		   GdictContext *context)
+{
+  GdictSpellerPrivate *priv;
+
+  g_assert (GDICT_IS_SPELLER (speller));
+
+  priv = speller->priv;
+  if (priv->context)
+    {
+      if (priv->start_id)
+        {
+          GDICT_NOTE (SPELLER, "Removing old context handlers");
+
+          g_signal_handler_disconnect (priv->context, priv->start_id);
+          g_signal_handler_disconnect (priv->context, priv->match_id);
+          g_signal_handler_disconnect (priv->context, priv->end_id);
+
+          priv->start_id = 0;
+          priv->end_id = 0;
+          priv->match_id = 0;
+        }
+
+      if (priv->error_id)
+        {
+          g_signal_handler_disconnect (priv->context, priv->error_id);
+
+          priv->error_id = 0;
+        }
+
+      GDICT_NOTE (SPELLER, "Removing old context");
+
+      g_object_unref (G_OBJECT (priv->context));
+    }
+
+  if (!context)
+    return;
+
+  if (!GDICT_IS_CONTEXT (context))
+    {
+      g_warning ("Object of type `%s' instead of a GdictContext\n",
+      		 g_type_name (G_OBJECT_TYPE (context)));
+      return;
+    }
+
+  GDICT_NOTE (SPELLER, "Setting new context\n");
+
+  priv->context = context;
+  g_object_ref (G_OBJECT (priv->context));
+}
+
+static void
+gdict_speller_finalize (GObject *gobject)
+{
+  GdictSpeller *speller = GDICT_SPELLER (gobject);
+  GdictSpellerPrivate *priv = speller->priv;
+
+  if (priv->context)
+    set_gdict_context (speller, NULL);
+
+  if (priv->busy_cursor)
+    gdk_cursor_unref (priv->busy_cursor);
+
+  g_free (priv->strategy);
+  g_free (priv->database);
+  g_free (priv->word);
+
+  if (priv->store)
+    g_object_unref (priv->store);
+
+  G_OBJECT_CLASS (gdict_speller_parent_class)->finalize (gobject);
+}
+
+
+static void
+gdict_speller_set_property (GObject      *gobject,
+			    guint         prop_id,
+			    const GValue *value,
+			    GParamSpec   *pspec)
+{
+  GdictSpeller *speller = GDICT_SPELLER (gobject);
+  GdictSpellerPrivate *priv = speller->priv;
+
+  switch (prop_id)
+    {
+    case PROP_CONTEXT:
+      set_gdict_context (speller, g_value_get_object (value));
+      break;
+    case PROP_DATABASE:
+      g_free (priv->database);
+      priv->database = g_strdup (g_value_get_string (value));
+      break;
+    case PROP_STRATEGY:
+      g_free (priv->strategy);
+      priv->strategy = g_strdup (g_value_get_string (value));
+      break;
+    default:
+      G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
+      break;
+    }
+}
+
+static void
+gdict_speller_get_property (GObject    *gobject,
+			    guint       prop_id,
+			    GValue     *value,
+			    GParamSpec *pspec)
+{
+  GdictSpeller *speller = GDICT_SPELLER (gobject);
+
+  switch (prop_id)
+    {
+    case PROP_DATABASE:
+      g_value_set_string (value, speller->priv->database);
+      break;
+    case PROP_STRATEGY:
+      g_value_set_string (value, speller->priv->strategy);
+      break;
+    case PROP_CONTEXT:
+      g_value_set_object (value, speller->priv->context);
+      break;
+    case PROP_COUNT:
+      g_value_set_int (value, speller->priv->results);
+    default:
+      G_OBJECT_WARN_INVALID_PROPERTY_ID (gobject, prop_id, pspec);
+      break;
+    }
+}
+
+static void
+row_activated_cb (GtkTreeView       *treeview,
+		  GtkTreePath       *path,
+		  GtkTreeViewColumn *column,
+		  gpointer           user_data)
+{
+  GdictSpeller *speller = GDICT_SPELLER (user_data);
+  GdictSpellerPrivate *priv = speller->priv;
+  GtkTreeIter iter;
+  gchar *word, *db_name;
+  gboolean valid;
+
+  valid = gtk_tree_model_get_iter (GTK_TREE_MODEL (priv->store),
+			           &iter,
+				   path);
+  if (!valid)
+    {
+      g_warning ("Invalid iterator found");
+
+      return;
+    }
+
+  gtk_tree_model_get (GTK_TREE_MODEL (priv->store), &iter,
+		      MATCH_COLUMN_WORD, &word,
+		      MATCH_COLUMN_DB_NAME, &db_name,
+		      -1);
+  if (word)
+    g_signal_emit (speller, speller_signals[WORD_ACTIVATED], 0,
+		   word, db_name);
+  else
+    {
+      gchar *row = gtk_tree_path_to_string (path);
+
+      g_warning ("Row %s activated, but no word attached", row);
+      g_free (row);
+    }
+
+  g_free (word);
+  g_free (db_name);
+}
+
+static void
+clear_button_clicked_cb (GtkWidget *widget,
+			 gpointer   user_data)
+{
+  GdictSpeller *speller = GDICT_SPELLER (user_data);
+
+  gdict_speller_clear (speller);
+}
+
+static GObject *
+gdict_speller_constructor (GType                  type,
+			   guint                  n_params,
+			   GObjectConstructParam *params)
+{
+  GObject *object;
+  GdictSpeller *speller;
+  GdictSpellerPrivate *priv;
+  GtkWidget *sw;
+  GtkCellRenderer *renderer;
+  GtkTreeViewColumn *column;
+  GtkWidget *hbox;
+
+  object = G_OBJECT_CLASS (gdict_speller_parent_class)->constructor (type,
+  						                     n_params,
+								     params);
+  speller = GDICT_SPELLER (object);
+  priv = speller->priv;
+
+  gtk_widget_push_composite_child ();
+
+  sw = gtk_scrolled_window_new (NULL, NULL);
+  gtk_widget_set_composite_name (sw, "gdict-speller-scrolled-window");
+  gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (sw),
+  				  GTK_POLICY_AUTOMATIC,
+  				  GTK_POLICY_AUTOMATIC);
+  gtk_scrolled_window_set_shadow_type (GTK_SCROLLED_WINDOW (sw),
+  				       GTK_SHADOW_IN);
+  gtk_box_pack_start (GTK_BOX (speller), sw, TRUE, TRUE, 0);
+  gtk_widget_show (sw);
+
+  renderer = gtk_cell_renderer_text_new ();
+  column = gtk_tree_view_column_new_with_attributes ("matches",
+		  				     renderer,
+						     "text", MATCH_COLUMN_WORD,
+						     NULL);
+
+  priv->treeview = gtk_tree_view_new ();
+  gtk_widget_set_composite_name (priv->treeview, "gdict-speller-treeview");
+  gtk_tree_view_set_model (GTK_TREE_VIEW (priv->treeview),
+		           GTK_TREE_MODEL (priv->store));
+  gtk_tree_view_set_headers_visible (GTK_TREE_VIEW (priv->treeview), FALSE);
+  gtk_tree_view_append_column (GTK_TREE_VIEW (priv->treeview), column);
+  g_signal_connect (priv->treeview, "row-activated",
+		    G_CALLBACK (row_activated_cb), speller);
+  gtk_container_add (GTK_CONTAINER (sw), priv->treeview);
+  gtk_widget_show (priv->treeview);
+
+  hbox = gtk_hbox_new (FALSE, 0);
+
+  priv->clear_button = gtk_button_new ();
+  gtk_button_set_image (GTK_BUTTON (priv->clear_button),
+		  	gtk_image_new_from_stock (GTK_STOCK_CLEAR,
+						  GTK_ICON_SIZE_SMALL_TOOLBAR));
+  g_signal_connect (priv->clear_button, "clicked",
+		    G_CALLBACK (clear_button_clicked_cb),
+		    speller);
+  gtk_box_pack_start (GTK_BOX (hbox), priv->clear_button, FALSE, FALSE, 0);
+  gtk_widget_show (priv->clear_button);
+  gtk_widget_set_tooltip_text (priv->clear_button,
+                               _("Clear the list of similar words"));
+
+  gtk_box_pack_end (GTK_BOX (speller), hbox, FALSE, FALSE, 0);
+  gtk_widget_show (hbox);
+
+  gtk_widget_pop_composite_child ();
+
+  return object;
+}
+
+static void
+gdict_speller_class_init (GdictSpellerClass *klass)
+{
+  GObjectClass *gobject_class = G_OBJECT_CLASS (klass);
+
+  gobject_class->finalize = gdict_speller_finalize;
+  gobject_class->set_property = gdict_speller_set_property;
+  gobject_class->get_property = gdict_speller_get_property;
+  gobject_class->constructor = gdict_speller_constructor;
+
+  g_object_class_install_property (gobject_class,
+  				   PROP_CONTEXT,
+  				   g_param_spec_object ("context",
+  				   			_("Context"),
+  				   			_("The GdictContext object used to get the word definition"),
+  				   			GDICT_TYPE_CONTEXT,
+  				   			(G_PARAM_READABLE | G_PARAM_WRITABLE | G_PARAM_CONSTRUCT)));
+  g_object_class_install_property (gobject_class,
+		  		   PROP_DATABASE,
+				   g_param_spec_string ("database",
+					   		_("Database"),
+							_("The database used to query the GdictContext"),
+							GDICT_DEFAULT_DATABASE,
+							(G_PARAM_READABLE | G_PARAM_WRITABLE)));
+  g_object_class_install_property (gobject_class,
+		  		   PROP_DATABASE,
+				   g_param_spec_string ("strategy",
+					   		_("Strategy"),
+							_("The strategy used to query the GdictContext"),
+							GDICT_DEFAULT_STRATEGY,
+							(G_PARAM_READABLE | G_PARAM_WRITABLE)));
+
+  speller_signals[WORD_ACTIVATED] =
+    g_signal_new ("word-activated",
+		  G_OBJECT_CLASS_TYPE (gobject_class),
+		  G_SIGNAL_RUN_LAST,
+		  G_STRUCT_OFFSET (GdictSpellerClass, word_activated),
+		  NULL, NULL,
+		  gdict_marshal_VOID__STRING_STRING,
+		  G_TYPE_NONE, 2,
+		  G_TYPE_STRING,
+		  G_TYPE_STRING);
+
+  g_type_class_add_private (gobject_class, sizeof (GdictSpellerPrivate));
+}
+
+static void
+gdict_speller_init (GdictSpeller *speller)
+{
+  GdictSpellerPrivate *priv;
+
+  speller->priv = priv = GDICT_SPELLER_GET_PRIVATE (speller);
+
+  priv->database = NULL;
+  priv->strategy = NULL;
+  priv->word = NULL;
+
+  priv->results = -1;
+  priv->context = NULL;
+
+  priv->store = gtk_list_store_new (MATCH_N_COLUMNS,
+		                    G_TYPE_INT,    /* MatchType */
+		                    G_TYPE_STRING, /* db_name */
+				    G_TYPE_STRING  /* word */);
+
+  priv->start_id = 0;
+  priv->end_id = 0;
+  priv->match_id = 0;
+  priv->error_id = 0;
+}
+
+/**
+ * gdict_speller_new:
+ *
+ * FIXME
+ *
+ * Return value: FIXME
+ *
+ * Since:
+ */
+GtkWidget *
+gdict_speller_new (void)
+{
+  return g_object_new (GDICT_TYPE_SPELLER, NULL);
+}
+
+/**
+ * gdict_speller_new_with_context:
+ * @context: a #GdictContext
+ *
+ * FIXME
+ *
+ * Return value: FIXME
+ *
+ * Since:
+ */
+GtkWidget *
+gdict_speller_new_with_context (GdictContext *context)
+{
+  g_return_val_if_fail (GDICT_IS_CONTEXT (context), NULL);
+
+  return g_object_new (GDICT_TYPE_SPELLER,
+		       "context", context,
+		       NULL);
+}
+
+/**
+ * gdict_speller_set_context:
+ * @speller: a #GdictSpeller
+ * @context: a #GdictContext
+ *
+ * FIXME
+ *
+ * Since:
+ */
+void
+gdict_speller_set_context (GdictSpeller *speller,
+			   GdictContext *context)
+{
+  g_return_if_fail (GDICT_IS_SPELLER (speller));
+  g_return_if_fail (context == NULL || GDICT_IS_CONTEXT (context));
+
+  set_gdict_context (speller, context);
+
+  g_object_notify (G_OBJECT (speller), "context");
+}
+
+/**
+ * gdict_speller_get_context:
+ * @speller: a #GdictSpeller
+ *
+ * FIXME
+ *
+ * Return value: a #GdictContext
+ *
+ * Since:
+ */
+GdictContext *
+gdict_speller_get_context (GdictSpeller *speller)
+{
+  g_return_val_if_fail (GDICT_IS_SPELLER (speller), NULL);
+
+  return speller->priv->context;
+}
+
+/**
+ * gdict_speller_set_database:
+ * @speller: a #GdictSpeller
+ * @database: FIXME
+ *
+ * FIXME
+ *
+ * Since:
+ */
+void
+gdict_speller_set_database (GdictSpeller *speller,
+			    const gchar  *database)
+{
+  GdictSpellerPrivate *priv;
+
+  g_return_if_fail (GDICT_IS_SPELLER (speller));
+
+  priv = speller->priv;
+
+  if (!database || database[0] == '\0')
+    database = GDICT_DEFAULT_DATABASE;
+
+  g_free (priv->database);
+  priv->database = g_strdup (database);
+
+  g_object_notify (G_OBJECT (speller), "database");
+}
+
+/**
+ * gdict_speller_get_database:
+ * @speller: a #GdictSpeller
+ *
+ * FIXME
+ *
+ * Return value: FIXME
+ *
+ * Since: FIXME
+ */
+const gchar *
+gdict_speller_get_database (GdictSpeller *speller)
+{
+  g_return_val_if_fail (GDICT_IS_SPELLER (speller), NULL);
+
+  return speller->priv->database;
+}
+
+/**
+ * gdict_speller_set_strategy:
+ * @speller: a #GdictSpeller
+ * @strategy: FIXME
+ *
+ * FIXME
+ *
+ * Since: FIXME
+ */
+void
+gdict_speller_set_strategy (GdictSpeller *speller,
+			    const gchar  *strategy)
+{
+  GdictSpellerPrivate *priv;
+
+  g_return_if_fail (GDICT_IS_SPELLER (speller));
+
+  priv = speller->priv;
+
+  if (!strategy || strategy[0] == '\0')
+    strategy = GDICT_DEFAULT_STRATEGY;
+
+  g_free (priv->strategy);
+  priv->strategy = g_strdup (strategy);
+
+  g_object_notify (G_OBJECT (speller), "strategy");
+}
+
+/**
+ * gdict_speller_get_strategy:
+ * @speller: a #GdictSpeller
+ *
+ * FIXME
+ *
+ * Return value: FIXME
+ *
+ * Since: FIXME
+ */
+const gchar *
+gdict_speller_get_strategy (GdictSpeller *speller)
+{
+  g_return_val_if_fail (GDICT_IS_SPELLER (speller), NULL);
+
+  return speller->priv->strategy;
+}
+
+/**
+ * gdict_speller_clear:
+ * @speller: a #GdictSpeller
+ *
+ * FIXME
+ *
+ * Since: FIXME
+ */
+void
+gdict_speller_clear (GdictSpeller *speller)
+{
+  GdictSpellerPrivate *priv;
+
+  g_return_if_fail (GDICT_IS_SPELLER (speller));
+  priv = speller->priv;
+
+  gtk_tree_view_set_model (GTK_TREE_VIEW (priv->treeview), NULL);
+
+  gtk_list_store_clear (priv->store);
+  priv->results = -1;
+
+  gtk_tree_view_set_model (GTK_TREE_VIEW (priv->treeview),
+		           GTK_TREE_MODEL (priv->store));
+}
+
+static void
+lookup_start_cb (GdictContext *context,
+		 gpointer      user_data)
+{
+  GdictSpeller *speller = GDICT_SPELLER (user_data);
+  GdictSpellerPrivate *priv = speller->priv;
+
+  if (!priv->busy_cursor)
+    priv->busy_cursor = gdk_cursor_new (GDK_WATCH);
+
+  if (gtk_widget_get_window (GTK_WIDGET (speller)))
+    gdk_window_set_cursor (gtk_widget_get_window (GTK_WIDGET (speller)), priv->busy_cursor);
+
+  priv->is_searching = TRUE;
+}
+
+static void
+lookup_end_cb (GdictContext *context,
+	       gpointer      user_data)
+{
+  GdictSpeller *speller = GDICT_SPELLER (user_data);
+  GdictSpellerPrivate *priv = speller->priv;
+
+  if (gtk_widget_get_window (GTK_WIDGET (speller)))
+    gdk_window_set_cursor (gtk_widget_get_window (GTK_WIDGET (speller)), NULL);
+
+  g_free (priv->word);
+  priv->word = NULL;
+
+  priv->is_searching = FALSE;
+}
+
+static void
+match_found_cb (GdictContext *context,
+		GdictMatch   *match,
+		gpointer      user_data)
+{
+  GdictSpeller *speller = GDICT_SPELLER (user_data);
+  GdictSpellerPrivate *priv = speller->priv;
+  GtkTreeIter iter;
+
+  GDICT_NOTE (SPELLER, "MATCH: `%s' (from `%s')",
+              gdict_match_get_word (match),
+              gdict_match_get_database (match));
+
+  gtk_list_store_append (priv->store, &iter);
+  gtk_list_store_set (priv->store, &iter,
+		      MATCH_COLUMN_TYPE, MATCH_WORD,
+		      MATCH_COLUMN_DB_NAME, gdict_match_get_database (match),
+		      MATCH_COLUMN_WORD, gdict_match_get_word (match),
+		      -1);
+
+  if (priv->results == -1)
+    priv->results = 1;
+  else
+    priv->results += 1;
+}
+
+static void
+error_cb (GdictContext *context,
+	  const GError *error,
+	  gpointer      user_data)
+{
+  GdictSpeller *speller = GDICT_SPELLER (user_data);
+  GdictSpellerPrivate *priv = speller->priv;
+
+  gdict_speller_clear (speller);
+
+  if (gtk_widget_get_window (GTK_WIDGET (speller)))
+    gdk_window_set_cursor (gtk_widget_get_window (GTK_WIDGET (speller)), NULL);
+
+  g_free (priv->word);
+  priv->word = NULL;
+
+  priv->is_searching = FALSE;
+}
+
+/**
+ * gdict_speller_match:
+ * @speller: a #GdictSpeller
+ * @word: FIXME
+ *
+ * FIXME
+ *
+ * Since: FIXME
+ */
+void
+gdict_speller_match (GdictSpeller *speller,
+		     const gchar  *word)
+{
+  GdictSpellerPrivate *priv;
+  GError *match_error;
+
+  g_return_if_fail (GDICT_IS_SPELLER (speller));
+  g_return_if_fail (word != NULL);
+
+  priv = speller->priv;
+
+  if (!priv->context)
+    {
+      g_warning ("Attempting to match `%s', but no GdictContext "
+		 "has been set.  Use gdict_speller_set_context() "
+		 "before invoking gdict_speller_match().",
+		 word);
+
+      return;
+    }
+
+  if (priv->is_searching)
+    {
+      _gdict_show_error_dialog (NULL,
+                                _("Another search is in progress"),
+                                _("Please wait until the current search ends."));
+
+      return;
+    }
+
+  gdict_speller_clear (speller);
+
+  if (!priv->start_id)
+    {
+      priv->start_id = g_signal_connect (priv->context, "lookup-start",
+		                         G_CALLBACK (lookup_start_cb),
+					 speller);
+      priv->match_id = g_signal_connect (priv->context, "match-found",
+                                         G_CALLBACK (match_found_cb),
+					 speller);
+      priv->end_id = g_signal_connect (priv->context, "lookup-end",
+		      		       G_CALLBACK (lookup_end_cb),
+				       speller);
+    }
+
+  if (!priv->error_id)
+    priv->error_id = g_signal_connect (priv->context, "error",
+		    		       G_CALLBACK (error_cb),
+				       speller);
+
+  g_free (priv->word);
+  priv->word = g_strdup (word);
+
+  match_error = NULL;
+  gdict_context_match_word (priv->context,
+		  	    priv->database,
+			    priv->strategy,
+			    priv->word,
+			    &match_error);
+  if (match_error)
+    {
+      GtkTreeIter iter;
+
+      gtk_list_store_append (priv->store, &iter);
+      gtk_list_store_set (priv->store, &iter,
+		          MATCH_COLUMN_TYPE, MATCH_ERROR,
+			  MATCH_COLUMN_DB_NAME, _("Error while matching"),
+			  MATCH_COLUMN_WORD, NULL,
+			  -1);
+
+      g_warning ("Error while matching `%s': %s",
+                 priv->word,
+                 match_error->message);
+
+      g_error_free (match_error);
+    }
+}
+
+/**
+ * gdict_speller_count_match:
+ * @speller: a #GdictSpeller
+ *
+ * FIXME
+ *
+ * Return value: FIXME
+ *
+ * Since: FIXME
+ */
+gint
+gdict_speller_count_matches (GdictSpeller *speller)
+{
+  g_return_val_if_fail (GDICT_IS_SPELLER (speller), -1);
+
+  return speller->priv->results;
+}
+
+/**
+ * gdict_speller_get_matches:
+ * @speller: a #GdictSpeller
+ * @length: FIXME
+ *
+ * FIXME
+ *
+ * Return value: FIXME
+ *
+ * Since: FIXME
+ */
+gchar **
+gdict_speller_get_matches (GdictSpeller *speller,
+			   gsize         length)
+{
+  g_return_val_if_fail (GDICT_IS_SPELLER (speller), NULL);
+
+  return NULL;
+}