Consolidate base utility libraries into libeutil.

Evolution consists of entirely too many small utility libraries, which
increases linking and loading time, places a burden on higher layers of
the application (e.g. modules) which has to remember to link to all the
small in-tree utility libraries, and makes it difficult to generate API
documentation for these utility libraries in one Gtk-Doc module.

Merge the following utility libraries under the umbrella of libeutil,
and enforce a single-include policy on libeutil so we can reorganize
the files as desired without disrupting its pseudo-public API.

   libemail-utils/libemail-utils.la
   libevolution-utils/libevolution-utils.la
   filter/libfilter.la
   widgets/e-timezone-dialog/libetimezonedialog.la
   widgets/menus/libmenus.la
   widgets/misc/libemiscwidgets.la
   widgets/table/libetable.la
   widgets/text/libetext.la

This also merges libedataserverui from the Evolution-Data-Server module,
since Evolution is its only consumer nowadays, and I'd like to make some
improvements to those APIs without concern for backward-compatibility.

And finally, start a Gtk-Doc module for libeutil.  It's going to be a
project just getting all the symbols _listed_ much less _documented_.
But the skeletal structure is in place and I'm off to a good start.

1 files changed, 226 insertions, 0 deletions

diff --git a/e-util/e-printable.c b/e-util/e-printable.c
new file mode 100644
index 0000000000..3f1403f03c
--- /dev/null
+++ b/e-util/e-printable.c
@@ -0,0 +1,226 @@
+/*
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Lesser General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) version 3.
+ *
+ * This program 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
+ * Lesser General Public License for more details.
+ *
+ * You should have received a copy of the GNU Lesser General Public
+ * License along with the program; if not, see <http://www.gnu.org/licenses/>
+ *
+ *
+ * Authors:
+ *		Chris Lahey <clahey@ximian.com>
+ *
+ * Copyright (C) 1999-2008 Novell, Inc. (www.novell.com)
+ *
+ */
+
+#ifdef HAVE_CONFIG_H
+#include <config.h>
+#endif
+
+#include <gtk/gtk.h>
+
+#include "e-printable.h"
+
+#include "e-marshal.h"
+
+#define EP_CLASS(e) ((EPrintableClass *)((GObject *)e)->class)
+
+G_DEFINE_TYPE (
+	EPrintable,
+	e_printable,
+	G_TYPE_INITIALLY_UNOWNED)
+
+enum {
+	PRINT_PAGE,
+	DATA_LEFT,
+	RESET,
+	HEIGHT,
+	WILL_FIT,
+	LAST_SIGNAL
+};
+
+static guint e_printable_signals[LAST_SIGNAL] = { 0, };
+
+static void
+e_printable_class_init (EPrintableClass *class)
+{
+	GObjectClass *object_class = G_OBJECT_CLASS (class);
+
+	e_printable_signals[PRINT_PAGE] = g_signal_new (
+		"print_page",
+		G_OBJECT_CLASS_TYPE (object_class),
+		G_SIGNAL_RUN_LAST,
+		G_STRUCT_OFFSET (EPrintableClass, print_page),
+		NULL, NULL,
+		e_marshal_NONE__OBJECT_DOUBLE_DOUBLE_BOOLEAN,
+		G_TYPE_NONE, 4,
+		G_TYPE_OBJECT,
+		G_TYPE_DOUBLE,
+		G_TYPE_DOUBLE,
+		G_TYPE_BOOLEAN);
+
+	e_printable_signals[DATA_LEFT] = g_signal_new (
+		"data_left",
+		G_OBJECT_CLASS_TYPE (object_class),
+		G_SIGNAL_RUN_LAST,
+		G_STRUCT_OFFSET (EPrintableClass, data_left),
+		NULL, NULL,
+		e_marshal_BOOLEAN__NONE,
+		G_TYPE_BOOLEAN, 0,
+		G_TYPE_NONE);
+
+	e_printable_signals[RESET] = g_signal_new (
+		"reset",
+		G_OBJECT_CLASS_TYPE (object_class),
+		G_SIGNAL_RUN_LAST,
+		G_STRUCT_OFFSET (EPrintableClass, reset),
+		NULL, NULL,
+		g_cclosure_marshal_VOID__VOID,
+		G_TYPE_NONE, 0,
+		G_TYPE_NONE);
+
+	e_printable_signals[HEIGHT] = g_signal_new (
+		"height",
+		G_OBJECT_CLASS_TYPE (object_class),
+		G_SIGNAL_RUN_LAST,
+		G_STRUCT_OFFSET (EPrintableClass, height),
+		NULL, NULL,
+		e_marshal_DOUBLE__OBJECT_DOUBLE_DOUBLE_BOOLEAN,
+		G_TYPE_DOUBLE, 4,
+		G_TYPE_OBJECT,
+		G_TYPE_DOUBLE,
+		G_TYPE_DOUBLE,
+		G_TYPE_BOOLEAN);
+
+	e_printable_signals[WILL_FIT] = g_signal_new (
+		"will_fit",
+		G_OBJECT_CLASS_TYPE (object_class),
+		G_SIGNAL_RUN_LAST,
+		G_STRUCT_OFFSET (EPrintableClass, will_fit),
+		NULL, NULL,
+		e_marshal_BOOLEAN__OBJECT_DOUBLE_DOUBLE_BOOLEAN,
+		G_TYPE_BOOLEAN, 4,
+		G_TYPE_OBJECT,
+		G_TYPE_DOUBLE,
+		G_TYPE_DOUBLE,
+		G_TYPE_BOOLEAN);
+
+	class->print_page = NULL;
+	class->data_left = NULL;
+	class->reset = NULL;
+	class->height = NULL;
+	class->will_fit = NULL;
+}
+
+static void
+e_printable_init (EPrintable *e_printable)
+{
+	/* nothing to do */
+}
+
+EPrintable *
+e_printable_new (void)
+{
+	return E_PRINTABLE (g_object_new (E_PRINTABLE_TYPE, NULL));
+}
+
+void
+e_printable_print_page (EPrintable *e_printable,
+                        GtkPrintContext *context,
+                        gdouble width,
+                        gdouble height,
+                        gboolean quantized)
+{
+	g_return_if_fail (e_printable != NULL);
+	g_return_if_fail (E_IS_PRINTABLE (e_printable));
+
+	g_signal_emit (
+		e_printable,
+		e_printable_signals[PRINT_PAGE], 0,
+		context,
+		width,
+		height,
+		quantized);
+}
+
+gboolean
+e_printable_data_left (EPrintable *e_printable)
+{
+	gboolean ret_val;
+
+	g_return_val_if_fail (e_printable != NULL, FALSE);
+	g_return_val_if_fail (E_IS_PRINTABLE (e_printable), FALSE);
+
+	g_signal_emit (
+		e_printable,
+		e_printable_signals[DATA_LEFT], 0,
+		&ret_val);
+
+	return ret_val;
+}
+
+void
+e_printable_reset (EPrintable *e_printable)
+{
+	g_return_if_fail (e_printable != NULL);
+	g_return_if_fail (E_IS_PRINTABLE (e_printable));
+
+	g_signal_emit (
+		e_printable,
+		e_printable_signals[RESET], 0);
+}
+
+gdouble
+e_printable_height (EPrintable *e_printable,
+                    GtkPrintContext *context,
+                    gdouble width,
+                    gdouble max_height,
+                    gboolean quantized)
+{
+	gdouble ret_val;
+
+	g_return_val_if_fail (e_printable != NULL, -1);
+	g_return_val_if_fail (E_IS_PRINTABLE (e_printable), -1);
+
+	g_signal_emit (
+		e_printable,
+		e_printable_signals[HEIGHT], 0,
+		context,
+		width,
+		max_height,
+		quantized,
+		&ret_val);
+
+	return ret_val;
+}
+
+gboolean
+e_printable_will_fit (EPrintable *e_printable,
+                      GtkPrintContext *context,
+                      gdouble width,
+                      gdouble max_height,
+                      gboolean quantized)
+{
+	gboolean ret_val;
+
+	g_return_val_if_fail (e_printable != NULL, FALSE);
+	g_return_val_if_fail (E_IS_PRINTABLE (e_printable), FALSE);
+
+	g_signal_emit (
+		e_printable,
+		e_printable_signals[WILL_FIT], 0,
+		context,
+		width,
+		max_height,
+		quantized,
+		&ret_val);
+
+	return ret_val;
+}